From ca15aacd6c92f72713a2e3d3aaa508f5fa9b5a1b Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 18 Feb 2020 00:26:51 +0900
Subject: [PATCH 001/305] Bump version

---
 CHANGES            | 21 +++++++++++++++++++++
 sphinx/__init__.py |  6 +++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 6a69eb18a58..06767895ed4 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,24 @@
+Release 4.0.0 (in development)
+==============================
+
+Dependencies
+------------
+
+Incompatible changes
+--------------------
+
+Deprecated
+----------
+
+Features added
+--------------
+
+Bugs fixed
+----------
+
+Testing
+--------
+
 Release 3.0.0 (in development)
 ==============================
 
diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index 4889f35d55e..6a2b88fefdf 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -32,8 +32,8 @@
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
 
-__version__ = '3.0.0+'
-__released__ = '3.0.0'  # used when Sphinx builds its own docs
+__version__ = '4.0.0+'
+__released__ = '4.0.0'  # used when Sphinx builds its own docs
 
 #: Version info for better programmatic use.
 #:
@@ -43,7 +43,7 @@
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (3, 0, 0, 'beta', 0)
+version_info = (4, 0, 0, 'beta', 0)
 
 package_dir = path.abspath(path.dirname(__file__))
 

From cea18198ce6a474e1ce0deaf78e79895748bd119 Mon Sep 17 00:00:00 2001
From: Guillaume Melquiond <guillaume.melquiond@inria.fr>
Date: Tue, 18 Feb 2020 08:07:11 +0100
Subject: [PATCH 002/305] Fix broken handling of whitespace in GenericObject.

This actually makes the code matches its comment, i.e, whitespaces are now
normalized the same way XRefRole does.

Without the fix, when creating a directive/role via add_object_type, the
following testcase fails with "WARNING: 'baz' reference target not found:
foo bar".

    :baz:`foo bar`
    .. baz:: foo bar

The current workaround is to explicitly mention the broken target, e.g.,

    :baz:`foo bar <foobar>`
    .. baz:: foo bar
---
 sphinx/domains/std.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/domains/std.py b/sphinx/domains/std.py
index 52633d194e4..ae868a2eecb 100644
--- a/sphinx/domains/std.py
+++ b/sphinx/domains/std.py
@@ -62,7 +62,7 @@ def handle_signature(self, sig: str, signode: desc_signature) -> str:
             signode.clear()
             signode += addnodes.desc_name(sig, sig)
             # normalize whitespace like XRefRole does
-            name = ws_re.sub('', sig)
+            name = ws_re.sub(' ', sig)
         return name
 
     def add_target_and_index(self, name: str, sig: str, signode: desc_signature) -> None:

From 2bd7c19c7bcc28e0058256de8f319551b6442144 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 10:04:16 +0900
Subject: [PATCH 003/305] Drop python 3.5 support

---
 CHANGES                    | 2 ++
 doc/intro.rst              | 2 +-
 doc/usage/installation.rst | 2 +-
 setup.py                   | 7 +++----
 4 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/CHANGES b/CHANGES
index 493cc5cff0e..d059ed931f0 100644
--- a/CHANGES
+++ b/CHANGES
@@ -4,6 +4,8 @@ Release 4.0.0 (in development)
 Dependencies
 ------------
 
+* Drop python 3.5 support
+
 Incompatible changes
 --------------------
 
diff --git a/doc/intro.rst b/doc/intro.rst
index 3e684a974d7..4fc35c08b13 100644
--- a/doc/intro.rst
+++ b/doc/intro.rst
@@ -55,7 +55,7 @@ See the :ref:`pertinent section in the FAQ list <usingwith>`.
 Prerequisites
 -------------
 
-Sphinx needs at least **Python 3.5** to run.
+Sphinx needs at least **Python 3.6** to run.
 It also depends on 3rd party libraries such as docutils_ and jinja2_, but they
 are automatically installed when sphinx is installed.
 
diff --git a/doc/usage/installation.rst b/doc/usage/installation.rst
index ba93bf192bb..c7e92ad2a30 100644
--- a/doc/usage/installation.rst
+++ b/doc/usage/installation.rst
@@ -12,7 +12,7 @@ Installing Sphinx
 Overview
 --------
 
-Sphinx is written in `Python`__ and supports Python 3.5+.
+Sphinx is written in `Python`__ and supports Python 3.6+.
 
 __ https://docs.python-guide.org/
 
diff --git a/setup.py b/setup.py
index bb6273033a7..8c1afb34049 100644
--- a/setup.py
+++ b/setup.py
@@ -10,8 +10,8 @@
 with open('README.rst') as f:
     long_desc = f.read()
 
-if sys.version_info < (3, 5):
-    print('ERROR: Sphinx requires at least Python 3.5 to run.')
+if sys.version_info < (3, 6):
+    print('ERROR: Sphinx requires at least Python 3.6 to run.')
     sys.exit(1)
 
 install_requires = [
@@ -198,7 +198,6 @@ def _run_domain_js(self, domain):
         'Programming Language :: Python',
         'Programming Language :: Python :: 3',
         'Programming Language :: Python :: 3 :: Only',
-        'Programming Language :: Python :: 3.5',
         'Programming Language :: Python :: 3.6',
         'Programming Language :: Python :: 3.7',
         'Programming Language :: Python :: Implementation :: CPython',
@@ -238,7 +237,7 @@ def _run_domain_js(self, domain):
             'build_sphinx = sphinx.setup_command:BuildDoc',
         ],
     },
-    python_requires=">=3.5",
+    python_requires=">=3.6",
     install_requires=install_requires,
     extras_require=extras_require,
     cmdclass=cmdclass,

From b2360a133b1d18e7f300daf94daaa7fa65c4f260 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 10:06:56 +0900
Subject: [PATCH 004/305] Drop docutils 0.12 and 0.13 support

---
 CHANGES  | 1 +
 setup.py | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index d059ed931f0..7a26203ba52 100644
--- a/CHANGES
+++ b/CHANGES
@@ -5,6 +5,7 @@ Dependencies
 ------------
 
 * Drop python 3.5 support
+* Drop docutils 0.12 and 0.13 support
 
 Incompatible changes
 --------------------
diff --git a/setup.py b/setup.py
index 8c1afb34049..1fb0c5d79c7 100644
--- a/setup.py
+++ b/setup.py
@@ -23,7 +23,7 @@
     'sphinxcontrib-qthelp',
     'Jinja2>=2.3',
     'Pygments>=2.0',
-    'docutils>=0.12',
+    'docutils>=0.14',
     'snowballstemmer>=1.1',
     'babel>=1.3',
     'alabaster>=0.7,<0.8',

From c4321ce8303e125ddb01be3d44e697865d7c8eaf Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 10:08:46 +0900
Subject: [PATCH 005/305] Drop CI settings for py35 and docutils-0.1[34]

---
 .travis.yml | 11 ++++-------
 tox.ini     |  6 ++----
 2 files changed, 6 insertions(+), 11 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 008f4e44260..e1128a3bed0 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -11,22 +11,19 @@ env:
 
 matrix:
   include:
-    - python: '3.5'
-      env:
-        - TOXENV=du12
     - python: '3.6'
       env:
-        - TOXENV=du13
+        - TOXENV=du14
     - python: '3.7'
       env:
-        - TOXENV=du14
+        - TOXENV=du15
     - python: '3.8'
       env:
-        - TOXENV=du15
+        - TOXENV=du16
         - PYTEST_ADDOPTS="--cov ./ --cov-append --cov-config setup.cfg"
     - python: 'nightly'
       env:
-        - TOXENV=du16
+        - TOXENV=py39
     - python: '3.6'
       env: TOXENV=docs
     - python: '3.6'
diff --git a/tox.ini b/tox.ini
index d9f04054406..f59959d2026 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,6 +1,6 @@
 [tox]
 minversion = 2.4.0
-envlist = docs,flake8,mypy,coverage,py{35,36,37,38,39},du{12,13,14,15}
+envlist = docs,flake8,mypy,coverage,py{36,37,38,39},du{14,15,16}
 
 [testenv]
 usedevelop = True
@@ -14,12 +14,10 @@ passenv =
     EPUBCHECK_PATH
     TERM
 description =
-    py{35,36,37,38,39}: Run unit tests against {envname}.
+    py{36,37,38,39}: Run unit tests against {envname}.
     du{12,13,14}: Run unit tests with the given version of docutils.
 deps =
     git+https://github.com/html5lib/html5lib-python  # refs: https://github.com/html5lib/html5lib-python/issues/419
-    du12: docutils==0.12
-    du13: docutils==0.13.1
     du14: docutils==0.14
     du15: docutils==0.15
     du16: docutils==0.16

From 3e0618ba3a84c7db51813cab43779d11c5fe7802 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 10:29:06 +0900
Subject: [PATCH 006/305] Deprecate codes for docutils-0.13 or 0.14

---
 CHANGES                            |  5 +++++
 doc/extdev/deprecated.rst          | 20 ++++++++++++++++++
 doc/usage/configuration.rst        | 12 +++++------
 sphinx/deprecation.py              |  4 ++++
 sphinx/directives/patches.py       | 20 +++++++++++++++---
 sphinx/util/nodes.py               |  8 +++++---
 sphinx/util/smartypants.py         |  6 ++++++
 sphinx/writers/html5.py            | 33 +++++++++++++++---------------
 tests/test_build_epub.py           |  4 ----
 tests/test_build_html.py           | 25 ----------------------
 tests/test_build_latex.py          |  7 -------
 tests/test_domain_cpp.py           |  5 -----
 tests/test_domain_std.py           |  3 ---
 tests/test_ext_autosectionlabel.py |  8 --------
 tests/test_ext_todo.py             |  4 ----
 tests/test_smartquotes.py          |  4 ----
 16 files changed, 79 insertions(+), 89 deletions(-)

diff --git a/CHANGES b/CHANGES
index 7a26203ba52..615bb934db4 100644
--- a/CHANGES
+++ b/CHANGES
@@ -13,6 +13,11 @@ Incompatible changes
 Deprecated
 ----------
 
+* ``sphinx.directives.patches.CSVTable``
+* ``sphinx.directives.patches.ListTable``
+* ``sphinx.directives.patches.RSTTable``
+* ``sphinx.util.smartypants``
+
 Features added
 --------------
 
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index e98652ed256..c4cd82b1f01 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -26,6 +26,26 @@ The following is a list of deprecated interfaces.
      - (will be) Removed
      - Alternatives
 
+   * - ``sphinx.directives.patches.CSVTable``
+     - 4.0
+     - 6.0
+     - ``docutils.parsers.rst.diretives.tables.CSVTable``
+
+   * - ``sphinx.directives.patches.ListTable``
+     - 4.0
+     - 6.0
+     - ``docutils.parsers.rst.diretives.tables.ListSVTable``
+
+   * - ``sphinx.directives.patches.RSTTable``
+     - 4.0
+     - 6.0
+     - ``docutils.parsers.rst.diretives.tables.RSTTable``
+
+   * - ``sphinx.util.smartypants``
+     - 4.0
+     - 6.0
+     - ``docutils.utils.smartyquotes``
+
    * - ``desc_signature['first']``
      -
      - 3.0
diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index e5ab9c7c033..e5e4966ab92 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -467,11 +467,10 @@ General configuration
 
 .. confval:: smartquotes_action
 
-   This string, for use with Docutils ``0.14`` or later, customizes the Smart
-   Quotes transform.  See the file :file:`smartquotes.py` at the `Docutils
-   repository`__ for details.  The default ``'qDe'`` educates normal **q**\
-   uote characters ``"``, ``'``, em- and en-**D**\ ashes ``---``, ``--``, and
-   **e**\ llipses ``...``.
+   This string customizes the Smart Quotes transform.  See the file
+   :file:`smartquotes.py` at the `Docutils repository`__ for details.  The
+   default ``'qDe'`` educates normal **q**\ uote characters ``"``, ``'``,
+   em- and en-**D**\ ashes ``---``, ``--``, and **e**\ llipses ``...``.
 
    .. versionadded:: 1.6.6
 
@@ -1381,8 +1380,7 @@ that use Sphinx's HTMLWriter class.
 
 .. confval:: html_experimental_html5_writer
 
-   Output is processed with HTML5 writer.  This feature needs docutils 0.13 or
-   newer.  Default is ``False``.
+   Output is processed with HTML5 writer.  Default is ``False``.
 
    .. versionadded:: 1.6
 
diff --git a/sphinx/deprecation.py b/sphinx/deprecation.py
index 5e5e673d206..e9510bde41f 100644
--- a/sphinx/deprecation.py
+++ b/sphinx/deprecation.py
@@ -23,6 +23,10 @@ class RemovedInSphinx50Warning(PendingDeprecationWarning):
     pass
 
 
+class RemovedInSphinx60Warning(PendingDeprecationWarning):
+    pass
+
+
 RemovedInNextVersionWarning = RemovedInSphinx40Warning
 
 
diff --git a/sphinx/directives/patches.py b/sphinx/directives/patches.py
index 4b73a795550..8a27c0170b6 100644
--- a/sphinx/directives/patches.py
+++ b/sphinx/directives/patches.py
@@ -6,6 +6,7 @@
     :license: BSD, see LICENSE for details.
 """
 
+import warnings
 from typing import Any, Dict, List, Tuple
 from typing import cast
 
@@ -15,6 +16,7 @@
 from docutils.parsers.rst.directives import images, html, tables
 
 from sphinx import addnodes
+from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.directives import optional_int
 from sphinx.domains.math import MathDomain
 from sphinx.util.docutils import SphinxDirective
@@ -73,6 +75,11 @@ class RSTTable(tables.RSTTable):
 
     Only for docutils-0.13 or older version."""
 
+    def run(self) -> List[Node]:
+        warnings.warn('RSTTable is deprecated.',
+                      RemovedInSphinx60Warning)
+        return super().run()
+
     def make_title(self) -> Tuple[nodes.title, List[system_message]]:
         title, message = super().make_title()
         if title:
@@ -86,6 +93,11 @@ class CSVTable(tables.CSVTable):
 
     Only for docutils-0.13 or older version."""
 
+    def run(self) -> List[Node]:
+        warnings.warn('RSTTable is deprecated.',
+                      RemovedInSphinx60Warning)
+        return super().run()
+
     def make_title(self) -> Tuple[nodes.title, List[system_message]]:
         title, message = super().make_title()
         if title:
@@ -99,6 +111,11 @@ class ListTable(tables.ListTable):
 
     Only for docutils-0.13 or older version."""
 
+    def run(self) -> List[Node]:
+        warnings.warn('RSTTable is deprecated.',
+                      RemovedInSphinx60Warning)
+        return super().run()
+
     def make_title(self) -> Tuple[nodes.title, List[system_message]]:
         title, message = super().make_title()
         if title:
@@ -209,9 +226,6 @@ def add_target(self, ret: List[Node]) -> None:
 def setup(app: "Sphinx") -> Dict[str, Any]:
     directives.register_directive('figure', Figure)
     directives.register_directive('meta', Meta)
-    directives.register_directive('table', RSTTable)
-    directives.register_directive('csv-table', CSVTable)
-    directives.register_directive('list-table', ListTable)
     directives.register_directive('code', Code)
     directives.register_directive('math', MathDirective)
 
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index 474a704a16b..fa51bec6a2e 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -537,10 +537,12 @@ def process_only_nodes(document: Node, tags: "Tags") -> None:
                 node.replace_self(nodes.comment())
 
 
-# monkey-patch Element.copy to copy the rawsource and line
-# for docutils-0.14 or older versions.
-
 def _new_copy(self: Element) -> Element:
+    """monkey-patch Element.copy to copy the rawsource and line
+    for docutils-0.16 or older versions.
+
+    refs: https://sourceforge.net/p/docutils/patches/165/
+    """
     newnode = self.__class__(self.rawsource, **self.attributes)
     if isinstance(self, nodes.Element):
         newnode.source = self.source
diff --git a/sphinx/util/smartypants.py b/sphinx/util/smartypants.py
index 43f8bc7248c..2b750337945 100644
--- a/sphinx/util/smartypants.py
+++ b/sphinx/util/smartypants.py
@@ -26,13 +26,19 @@
 """
 
 import re
+import warnings
 from typing import Generator, Iterable, Tuple
 
 from docutils.utils import smartquotes
 
+from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.util.docutils import __version_info__ as docutils_version
 
 
+warnings.warn('sphinx.util.smartypants is deprecated.',
+              RemovedInSphinx60Warning)
+
+
 langquotes = {'af':           '“”‘’',
               'af-x-altquot': '„”‚’',
               'bg':           '„“‚‘',  # Bulgarian, https://bg.wikipedia.org/wiki/Кавички
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index 0c00a1fa4e4..5da11840d04 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -20,7 +20,7 @@
 
 from sphinx import addnodes
 from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx40Warning
+from sphinx.deprecation import RemovedInSphinx40Warning, RemovedInSphinx60Warning
 from sphinx.locale import admonitionlabels, _, __
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxTranslator
@@ -703,22 +703,7 @@ def depart_manpage(self, node: Element) -> None:
 
     # overwritten to add even/odd classes
 
-    def generate_targets_for_table(self, node: Element) -> None:
-        """Generate hyperlink targets for tables.
-
-        Original visit_table() generates hyperlink targets inside table tags
-        (<table>) if multiple IDs are assigned to listings.
-        That is invalid DOM structure.  (This is a bug of docutils <= 0.13.1)
-
-        This exports hyperlink targets before tables to make valid DOM structure.
-        """
-        for id in node['ids'][1:]:
-            self.body.append('<span id="%s"></span>' % id)
-            node['ids'].remove(id)
-
     def visit_table(self, node: Element) -> None:
-        self.generate_targets_for_table(node)
-
         self._table_row_index = 0
 
         classes = [cls.strip(' \t\n') for cls in self.settings.table_style.split(',')]
@@ -772,3 +757,19 @@ def depart_math_block(self, node: Element, math_env: str = '') -> None:
 
     def unknown_visit(self, node: Node) -> None:
         raise NotImplementedError('Unknown node: ' + node.__class__.__name__)
+
+    def generate_targets_for_table(self, node: Element) -> None:
+        """Generate hyperlink targets for tables.
+
+        Original visit_table() generates hyperlink targets inside table tags
+        (<table>) if multiple IDs are assigned to listings.
+        That is invalid DOM structure.  (This is a bug of docutils <= 0.13.1)
+
+        This exports hyperlink targets before tables to make valid DOM structure.
+        """
+        warnings.warn('generate_targets_for_table() is deprecated',
+                      RemovedInSphinx60Warning, stacklevel=2)
+        for id in node['ids'][1:]:
+            self.body.append('<span id="%s"></span>' % id)
+            node['ids'].remove(id)
+
diff --git a/tests/test_build_epub.py b/tests/test_build_epub.py
index a61c3cbbb60..cb60e79ada3 100644
--- a/tests/test_build_epub.py
+++ b/tests/test_build_epub.py
@@ -15,8 +15,6 @@
 
 import pytest
 
-from sphinx.util import docutils
-
 
 # check given command is runnable
 def runnable(command):
@@ -357,8 +355,6 @@ def test_epub_css_files(app):
             'href="https://example.com/custom.css" />' not in content)
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('epub', testroot='roles-download')
 def test_html_download_role(app, status, warning):
     app.build()
diff --git a/tests/test_build_html.py b/tests/test_build_html.py
index 39cb3bf714f..b328273926c 100644
--- a/tests/test_build_html.py
+++ b/tests/test_build_html.py
@@ -19,7 +19,6 @@
 from sphinx.builders.html import validate_html_extra_path, validate_html_static_path
 from sphinx.errors import ConfigError
 from sphinx.testing.util import strip_escseq
-from sphinx.util import docutils
 from sphinx.util.inventory import InventoryFile
 
 
@@ -407,8 +406,6 @@ def test_html4_output(app, status, warning):
         (".//a[@href='_sources/otherext.foo.txt']", ''),
     ]
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', tags=['testtag'],
                     confoverrides={'html_context.hckey_co': 'hcval_co'})
 @pytest.mark.test_params(shared_result='test_build_html_output')
@@ -418,8 +415,6 @@ def test_html5_output(app, cached_etree_parse, fname, expect):
     check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html')
 @pytest.mark.test_params(shared_result='test_build_html_output')
 def test_html_download(app):
@@ -444,8 +439,6 @@ def test_html_download(app):
     assert matched.group(1) == filename
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='roles-download')
 def test_html_download_role(app, status, warning):
     app.build()
@@ -524,8 +517,6 @@ def test_html_translator(app):
         (".//h1//span[@class='section-number']", '2.1.1. ', True),
     ],
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='tocdepth')
 @pytest.mark.test_params(shared_result='test_build_html_tocdepth')
 def test_tocdepth(app, cached_etree_parse, fname, expect):
@@ -571,8 +562,6 @@ def test_tocdepth(app, cached_etree_parse, fname, expect):
         (".//h4//span[@class='section-number']", '2.1.1. ', True),
     ],
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('singlehtml', testroot='tocdepth')
 @pytest.mark.test_params(shared_result='test_build_html_tocdepth')
 def test_tocdepth_singlehtml(app, cached_etree_parse, fname, expect):
@@ -630,8 +619,6 @@ def test_numfig_disabled_warn(app, warning):
          "span[@class='caption-number']", None, True),
     ],
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='numfig')
 @pytest.mark.test_params(shared_result='test_build_html_numfig')
 def test_numfig_disabled(app, cached_etree_parse, fname, expect):
@@ -738,8 +725,6 @@ def test_numfig_without_numbered_toctree_warn(app, warning):
          "span[@class='caption-number']", '^Listing 6 $', True),
     ],
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx(
     'html', testroot='numfig',
     srcdir='test_numfig_without_numbered_toctree',
@@ -846,8 +831,6 @@ def test_numfig_with_numbered_toctree_warn(app, warning):
          "span[@class='caption-number']", '^Listing 2.2 $', True),
     ],
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='numfig', confoverrides={'numfig': True})
 @pytest.mark.test_params(shared_result='test_build_html_numfig_on')
 def test_numfig_with_numbered_toctree(app, cached_etree_parse, fname, expect):
@@ -951,8 +934,6 @@ def test_numfig_with_prefix_warn(app, warning):
          "span[@class='caption-number']", '^Code-2.2 $', True),
     ],
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='numfig',
                     confoverrides={'numfig': True,
                                    'numfig_format': {'figure': 'Figure:%s',
@@ -1057,8 +1038,6 @@ def test_numfig_with_secnum_depth_warn(app, warning):
          "span[@class='caption-number']", '^Listing 2.1.2 $', True),
     ],
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='numfig',
                     confoverrides={'numfig': True,
                                    'numfig_secnum_depth': 2})
@@ -1142,8 +1121,6 @@ def test_numfig_with_secnum_depth(app, cached_etree_parse, fname, expect):
          "span[@class='caption-number']", '^Listing 2.2 $', True),
     ],
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('singlehtml', testroot='numfig', confoverrides={'numfig': True})
 @pytest.mark.test_params(shared_result='test_build_html_numfig_on')
 def test_numfig_with_singlehtml(app, cached_etree_parse, fname, expect):
@@ -1168,8 +1145,6 @@ def test_numfig_with_singlehtml(app, cached_etree_parse, fname, expect):
         (".//li/p/a/span", 'No.2', True),
     ],
 }))
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='add_enumerable_node',
                     srcdir='test_enumerable_node')
 def test_enumerable_node(app, cached_etree_parse, fname, expect):
diff --git a/tests/test_build_latex.py b/tests/test_build_latex.py
index 61020b86102..161e522f66c 100644
--- a/tests/test_build_latex.py
+++ b/tests/test_build_latex.py
@@ -22,7 +22,6 @@
 from sphinx.config import Config
 from sphinx.errors import SphinxError, ThemeError
 from sphinx.testing.util import strip_escseq
-from sphinx.util import docutils
 from sphinx.util.osutil import cd, ensuredir
 from sphinx.writers.latex import LaTeXTranslator
 
@@ -1102,8 +1101,6 @@ def test_maxlistdepth_at_ten(app, status, warning):
     compile_latex_document(app, 'python.tex')
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('latex', testroot='latex-table')
 @pytest.mark.test_params(shared_result='latex-table')
 def test_latex_table_tabulars(app, status, warning):
@@ -1173,8 +1170,6 @@ def get_expected(name):
     assert actual == expected
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('latex', testroot='latex-table')
 @pytest.mark.test_params(shared_result='latex-table')
 def test_latex_table_longtable(app, status, warning):
@@ -1234,8 +1229,6 @@ def get_expected(name):
     assert actual == expected
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('latex', testroot='latex-table')
 @pytest.mark.test_params(shared_result='latex-table')
 def test_latex_table_complex_tables(app, status, warning):
diff --git a/tests/test_domain_cpp.py b/tests/test_domain_cpp.py
index fba5fdb42d2..7ed2308278e 100644
--- a/tests/test_domain_cpp.py
+++ b/tests/test_domain_cpp.py
@@ -16,7 +16,6 @@
 from sphinx import addnodes
 from sphinx.domains.cpp import DefinitionParser, DefinitionError, NoOldIdError
 from sphinx.domains.cpp import Symbol, _max_id, _id_prefix
-from sphinx.util import docutils
 
 
 def parse(name, string):
@@ -860,8 +859,6 @@ def test_build_domain_cpp_misuse_of_roles(app, status, warning):
     assert len(ws) == len(warn)
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx(testroot='domain-cpp', confoverrides={'add_function_parentheses': True})
 def test_build_domain_cpp_with_add_function_parentheses_is_True(app, status, warning):
     app.builder.build_all()
@@ -903,8 +900,6 @@ def check(spec, text, file):
         check(s, t, f)
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx(testroot='domain-cpp', confoverrides={'add_function_parentheses': False})
 def test_build_domain_cpp_with_add_function_parentheses_is_False(app, status, warning):
     app.builder.build_all()
diff --git a/tests/test_domain_std.py b/tests/test_domain_std.py
index 1f0024efc14..a887a596f59 100644
--- a/tests/test_domain_std.py
+++ b/tests/test_domain_std.py
@@ -24,7 +24,6 @@
 from sphinx.domains.std import StandardDomain
 from sphinx.testing import restructuredtext
 from sphinx.testing.util import assert_node
-from sphinx.util import docutils
 
 
 def test_process_doc_handle_figure_caption():
@@ -319,8 +318,6 @@ def test_multiple_cmdoptions(app):
     assert domain.progoptions[('cmd', '--output')] == ('index', 'cmdoption-cmd-o')
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx(testroot='productionlist')
 def test_productionlist(app, status, warning):
     app.builder.build_all()
diff --git a/tests/test_ext_autosectionlabel.py b/tests/test_ext_autosectionlabel.py
index 310435d8edb..c8635ce2d08 100644
--- a/tests/test_ext_autosectionlabel.py
+++ b/tests/test_ext_autosectionlabel.py
@@ -12,11 +12,7 @@
 
 import pytest
 
-from sphinx.util import docutils
 
-
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='ext-autosectionlabel')
 def test_autosectionlabel_html(app, status, warning, skipped_labels=False):
     app.builder.build_all()
@@ -55,15 +51,11 @@ def test_autosectionlabel_html(app, status, warning, skipped_labels=False):
 
 
 # Re-use test definition from above, just change the test root directory
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='ext-autosectionlabel-prefix-document')
 def test_autosectionlabel_prefix_document_html(app, status, warning):
     test_autosectionlabel_html(app, status, warning)
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='ext-autosectionlabel',
                     confoverrides={'autosectionlabel_maxdepth': 3})
 def test_autosectionlabel_maxdepth(app, status, warning):
diff --git a/tests/test_ext_todo.py b/tests/test_ext_todo.py
index 7b4fdeabe24..633b151ac39 100644
--- a/tests/test_ext_todo.py
+++ b/tests/test_ext_todo.py
@@ -12,11 +12,7 @@
 
 import pytest
 
-from sphinx.util import docutils
 
-
-@pytest.mark.skipif(docutils.__version_info__ < (0, 13),
-                    reason='docutils-0.13 or above is required')
 @pytest.mark.sphinx('html', testroot='ext-todo', freshenv=True,
                     confoverrides={'todo_include_todos': True, 'todo_emit_warnings': True})
 def test_todo(app, status, warning):
diff --git a/tests/test_smartquotes.py b/tests/test_smartquotes.py
index 6276e6a74cf..697a7592c11 100644
--- a/tests/test_smartquotes.py
+++ b/tests/test_smartquotes.py
@@ -10,8 +10,6 @@
 
 import pytest
 
-from sphinx.util import docutils
-
 
 @pytest.mark.sphinx(buildername='html', testroot='smartquotes', freshenv=True)
 def test_basic(app, status, warning):
@@ -63,8 +61,6 @@ def test_smartquotes_disabled(app, status, warning):
     assert '<p>-- &quot;Sphinx&quot; is a tool that makes it easy ...</p>' in content
 
 
-@pytest.mark.skipif(docutils.__version_info__ < (0, 14),
-                    reason='docutils-0.14 or above is required')
 @pytest.mark.sphinx(buildername='html', testroot='smartquotes', freshenv=True,
                     confoverrides={'smartquotes_action': 'q'})
 def test_smartquotes_action(app, status, warning):

From 6d4fefebf4ecee4416da016d8e647298003fb57a Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 10:45:39 +0900
Subject: [PATCH 007/305] Deprecate codes for python 3.5

---
 sphinx/application.py                    |  3 +-
 sphinx/builders/__init__.py              |  3 +-
 sphinx/builders/gettext.py               |  6 +--
 sphinx/builders/html/__init__.py         |  6 +--
 sphinx/builders/xml.py                   |  6 +--
 sphinx/deprecation.py                    |  3 +-
 sphinx/domains/__init__.py               |  3 +-
 sphinx/domains/python.py                 |  6 +--
 sphinx/domains/std.py                    |  3 +-
 sphinx/environment/collectors/toctree.py |  6 +--
 sphinx/ext/autodoc/__init__.py           |  7 ++-
 sphinx/ext/autodoc/directive.py          |  6 +--
 sphinx/ext/autosummary/__init__.py       |  6 +--
 sphinx/ext/autosummary/generate.py       |  6 +--
 sphinx/ext/doctest.py                    |  3 +-
 sphinx/ext/napoleon/docstring.py         |  6 +--
 sphinx/io.py                             |  3 +-
 sphinx/parsers.py                        |  5 +-
 sphinx/pycode/parser.py                  |  2 +-
 sphinx/registry.py                       |  3 +-
 sphinx/roles.py                          |  3 +-
 sphinx/search/__init__.py                |  6 +--
 sphinx/transforms/i18n.py                |  3 +-
 sphinx/util/__init__.py                  |  3 +-
 sphinx/util/docfields.py                 |  3 +-
 sphinx/util/docutils.py                  |  3 +-
 sphinx/util/inspect.py                   |  2 +-
 sphinx/util/logging.py                   |  3 +-
 sphinx/util/nodes.py                     |  3 +-
 sphinx/util/osutil.py                    |  6 +--
 sphinx/util/typing.py                    | 58 ++++--------------------
 sphinx/writers/html5.py                  |  1 -
 32 files changed, 42 insertions(+), 144 deletions(-)

diff --git a/sphinx/application.py b/sphinx/application.py
index fbc637e6062..a24bd9bb9b6 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -18,7 +18,7 @@
 from collections import deque
 from io import StringIO
 from os import path
-from typing import Any, Callable, Dict, IO, List, Tuple, Union
+from typing import Any, Callable, Dict, IO, List, Tuple, Type, Union
 
 from docutils import nodes
 from docutils.nodes import Element, TextElement
@@ -56,7 +56,6 @@
 if False:
     # For type annotation
     from docutils.nodes import Node  # NOQA
-    from typing import Type  # for python3.5.1
     from sphinx.builders import Builder
 
 
diff --git a/sphinx/builders/__init__.py b/sphinx/builders/__init__.py
index c596df3c59c..1d43080dfe4 100644
--- a/sphinx/builders/__init__.py
+++ b/sphinx/builders/__init__.py
@@ -11,7 +11,7 @@
 import pickle
 import time
 from os import path
-from typing import Any, Dict, Iterable, List, Sequence, Set, Tuple, Union
+from typing import Any, Dict, Iterable, List, Sequence, Set, Tuple, Type, Union
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -44,7 +44,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/builders/gettext.py b/sphinx/builders/gettext.py
index 65f11251078..3fb7595ee3b 100644
--- a/sphinx/builders/gettext.py
+++ b/sphinx/builders/gettext.py
@@ -13,7 +13,7 @@
 from datetime import datetime, tzinfo, timedelta
 from os import path, walk, getenv
 from time import time
-from typing import Any, Dict, Iterable, Generator, List, Set, Tuple, Union
+from typing import Any, DefaultDict, Dict, Iterable, Generator, List, Set, Tuple, Union
 from uuid import uuid4
 
 from docutils import nodes
@@ -34,10 +34,6 @@
 from sphinx.util.tags import Tags
 from sphinx.util.template import SphinxRenderer
 
-if False:
-    # For type annotation
-    from typing import DefaultDict  # for python3.5.1
-
 logger = logging.getLogger(__name__)
 
 POHEADER = r"""
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index cf8cd56ceba..8c91f9a708c 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -15,7 +15,7 @@
 import warnings
 from hashlib import md5
 from os import path
-from typing import Any, Dict, IO, Iterable, Iterator, List, Set, Tuple
+from typing import Any, Dict, IO, Iterable, Iterator, List, Set, Tuple, Type
 
 from docutils import nodes
 from docutils.core import publish_parts
@@ -48,10 +48,6 @@
 from sphinx.util.tags import Tags
 from sphinx.writers.html import HTMLWriter, HTMLTranslator
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 
 # HTML5 Writer is available or not
 if is_html5_writer_available():
diff --git a/sphinx/builders/xml.py b/sphinx/builders/xml.py
index 81d729def9a..d5fd6b40ad9 100644
--- a/sphinx/builders/xml.py
+++ b/sphinx/builders/xml.py
@@ -9,7 +9,7 @@
 """
 
 from os import path
-from typing import Any, Dict, Iterator, Set, Union
+from typing import Any, Dict, Iterator, Set, Type, Union
 
 from docutils import nodes
 from docutils.io import StringOutput
@@ -23,10 +23,6 @@
 from sphinx.util.osutil import ensuredir, os_path
 from sphinx.writers.xml import XMLWriter, PseudoXMLWriter
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 
 logger = logging.getLogger(__name__)
 
diff --git a/sphinx/deprecation.py b/sphinx/deprecation.py
index e9510bde41f..a1b024c093c 100644
--- a/sphinx/deprecation.py
+++ b/sphinx/deprecation.py
@@ -11,8 +11,7 @@
 import sys
 import warnings
 from importlib import import_module
-from typing import Any, Dict
-from typing import Type  # for python3.5.1
+from typing import Any, Dict, Type
 
 
 class RemovedInSphinx40Warning(DeprecationWarning):
diff --git a/sphinx/domains/__init__.py b/sphinx/domains/__init__.py
index 11b3a46043e..11f0d208c9c 100644
--- a/sphinx/domains/__init__.py
+++ b/sphinx/domains/__init__.py
@@ -10,7 +10,7 @@
 """
 
 import copy
-from typing import Any, Callable, Dict, Iterable, List, NamedTuple, Tuple, Union
+from typing import Any, Callable, Dict, Iterable, List, NamedTuple, Tuple, Type, Union
 from typing import cast
 
 from docutils import nodes
@@ -25,7 +25,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
 
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index e667f91dc7c..eb5613c6426 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -14,7 +14,7 @@
 import typing
 import warnings
 from inspect import Parameter
-from typing import Any, Dict, Iterable, Iterator, List, Tuple
+from typing import Any, Dict, Iterable, Iterator, List, Tuple, Type
 from typing import cast
 
 from docutils import nodes
@@ -38,10 +38,6 @@
 from sphinx.util.nodes import make_id, make_refnode
 from sphinx.util.typing import TextlikeNode
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 
 logger = logging.getLogger(__name__)
 
diff --git a/sphinx/domains/std.py b/sphinx/domains/std.py
index b2538f0345a..0fa93dd23b4 100644
--- a/sphinx/domains/std.py
+++ b/sphinx/domains/std.py
@@ -12,7 +12,7 @@
 import unicodedata
 import warnings
 from copy import copy
-from typing import Any, Callable, Dict, Iterable, Iterator, List, Optional, Tuple, Union
+from typing import Any, Callable, Dict, Iterable, Iterator, List, Optional, Tuple, Type, Union
 from typing import cast
 
 from docutils import nodes
@@ -34,7 +34,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.application import Sphinx
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
diff --git a/sphinx/environment/collectors/toctree.py b/sphinx/environment/collectors/toctree.py
index e168bd9c4be..acb45ef568a 100644
--- a/sphinx/environment/collectors/toctree.py
+++ b/sphinx/environment/collectors/toctree.py
@@ -8,7 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 
-from typing import Any, Dict, List, Set, Tuple, TypeVar
+from typing import Any, Dict, List, Set, Tuple, Type, TypeVar
 from typing import cast
 
 from docutils import nodes
@@ -23,10 +23,6 @@
 from sphinx.transforms import SphinxContentsFilter
 from sphinx.util import url_re, logging
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 
 N = TypeVar('N')
 
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 7abd6c8797b..025d4a09105 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -14,7 +14,7 @@
 import re
 import warnings
 from types import ModuleType
-from typing import Any, Callable, Dict, Iterator, List, Sequence, Set, Tuple, Union
+from typing import Any, Callable, Dict, Iterator, List, Sequence, Set, Tuple, Type, Union
 
 from docutils.statemachine import StringList
 
@@ -36,7 +36,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # NOQA # for python3.5.1
     from sphinx.ext.autodoc.directive import DocumenterBridge
 
 
@@ -262,7 +261,7 @@ def __init__(self, directive: "DocumenterBridge", name: str, indent: str = '') -
         self.analyzer = None        # type: ModuleAnalyzer
 
     @property
-    def documenters(self) -> Dict[str, "Type[Documenter]"]:
+    def documenters(self) -> Dict[str, Type["Documenter"]]:
         """Returns registered Documenter classes"""
         return get_documenters(self.env.app)
 
@@ -1591,7 +1590,7 @@ def get_doc(self, encoding: str = None, ignore: int = 1) -> List[List[str]]:
             return []
 
 
-def get_documenters(app: Sphinx) -> Dict[str, "Type[Documenter]"]:
+def get_documenters(app: Sphinx) -> Dict[str, Type[Documenter]]:
     """Returns registered Documenter classes"""
     return app.registry.documenters
 
diff --git a/sphinx/ext/autodoc/directive.py b/sphinx/ext/autodoc/directive.py
index b44bd75b39e..3fe5dc95073 100644
--- a/sphinx/ext/autodoc/directive.py
+++ b/sphinx/ext/autodoc/directive.py
@@ -7,7 +7,7 @@
 """
 
 import warnings
-from typing import Any, Callable, Dict, List, Set
+from typing import Any, Callable, Dict, List, Set, Type
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -23,10 +23,6 @@
 from sphinx.util.docutils import SphinxDirective, switch_source_input
 from sphinx.util.nodes import nested_parse_with_titles
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 
 logger = logging.getLogger(__name__)
 
diff --git a/sphinx/ext/autosummary/__init__.py b/sphinx/ext/autosummary/__init__.py
index 3d296cbde29..7d2109abb09 100644
--- a/sphinx/ext/autosummary/__init__.py
+++ b/sphinx/ext/autosummary/__init__.py
@@ -60,7 +60,7 @@
 import warnings
 from os import path
 from types import ModuleType
-from typing import Any, Dict, List, Tuple
+from typing import Any, Dict, List, Tuple, Type
 from typing import cast
 
 from docutils import nodes
@@ -88,10 +88,6 @@
 from sphinx.util.matching import Matcher
 from sphinx.writers.html import HTMLTranslator
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 
 logger = logging.getLogger(__name__)
 
diff --git a/sphinx/ext/autosummary/generate.py b/sphinx/ext/autosummary/generate.py
index ef623e2bd8c..10865749d8a 100644
--- a/sphinx/ext/autosummary/generate.py
+++ b/sphinx/ext/autosummary/generate.py
@@ -24,7 +24,7 @@
 import re
 import sys
 import warnings
-from typing import Any, Callable, Dict, List, Set, Tuple
+from typing import Any, Callable, Dict, List, Set, Tuple, Type
 
 from jinja2 import BaseLoader, FileSystemLoader, TemplateNotFound
 from jinja2.sandbox import SandboxedEnvironment
@@ -44,10 +44,6 @@
 from sphinx.util.inspect import safe_getattr
 from sphinx.util.osutil import ensuredir
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 
 logger = logging.getLogger(__name__)
 
diff --git a/sphinx/ext/doctest.py b/sphinx/ext/doctest.py
index 645521f9b36..f20e840ec5f 100644
--- a/sphinx/ext/doctest.py
+++ b/sphinx/ext/doctest.py
@@ -16,7 +16,7 @@
 import warnings
 from io import StringIO
 from os import path
-from typing import Any, Callable, Dict, Iterable, List, Sequence, Set, Tuple
+from typing import Any, Callable, Dict, Iterable, List, Sequence, Set, Tuple, Type
 
 from docutils import nodes
 from docutils.nodes import Element, Node, TextElement
@@ -35,7 +35,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/ext/napoleon/docstring.py b/sphinx/ext/napoleon/docstring.py
index 7f6ebe478d0..c490670bebf 100644
--- a/sphinx/ext/napoleon/docstring.py
+++ b/sphinx/ext/napoleon/docstring.py
@@ -13,17 +13,13 @@
 import inspect
 import re
 from functools import partial
-from typing import Any, Callable, Dict, List, Tuple, Union
+from typing import Any, Callable, Dict, List, Tuple, Type, Union
 
 from sphinx.application import Sphinx
 from sphinx.config import Config as SphinxConfig
 from sphinx.ext.napoleon.iterators import modify_iter
 from sphinx.locale import _
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 
 _directive_regex = re.compile(r'\.\. \S+::')
 _google_section_regex = re.compile(r'^(\s|\w)+:\s*$')
diff --git a/sphinx/io.py b/sphinx/io.py
index 18b4f053ed4..0462afd83ec 100644
--- a/sphinx/io.py
+++ b/sphinx/io.py
@@ -9,8 +9,7 @@
 """
 import codecs
 import warnings
-from typing import Any, List
-from typing import Type  # for python3.5.1
+from typing import Any, List, Type
 
 from docutils import nodes
 from docutils.core import Publisher
diff --git a/sphinx/parsers.py b/sphinx/parsers.py
index 3974d1c66fc..fb6c263c933 100644
--- a/sphinx/parsers.py
+++ b/sphinx/parsers.py
@@ -9,7 +9,7 @@
 """
 
 import warnings
-from typing import Any, Dict, List, Union
+from typing import Any, Dict, List, Type, Union
 
 import docutils.parsers
 import docutils.parsers.rst
@@ -24,7 +24,6 @@
 if False:
     # For type annotation
     from docutils.transforms import Transform  # NOQA
-    from typing import Type  # NOQA # for python3.5.1
     from sphinx.application import Sphinx
 
 
@@ -71,7 +70,7 @@ def app(self) -> "Sphinx":
 class RSTParser(docutils.parsers.rst.Parser, Parser):
     """A reST parser for Sphinx."""
 
-    def get_transforms(self) -> List["Type[Transform]"]:
+    def get_transforms(self) -> List[Type[Transform]]:
         """Sphinx's reST parser replaces a transform class for smart-quotes by own's
 
         refs: sphinx.io.SphinxStandaloneReader
diff --git a/sphinx/pycode/parser.py b/sphinx/pycode/parser.py
index cb3cf0cc1bb..5b6bf4b7ffa 100644
--- a/sphinx/pycode/parser.py
+++ b/sphinx/pycode/parser.py
@@ -349,7 +349,7 @@ def visit_Assign(self, node: ast.Assign) -> None:
         for varname in varnames:
             self.add_entry(varname)
 
-    def visit_AnnAssign(self, node: ast.AST) -> None:  # Note: ast.AnnAssign not found in py35
+    def visit_AnnAssign(self, node: ast.AnnAssign) -> None:
         """Handles AnnAssign node and pick up a variable comment."""
         self.visit_Assign(node)  # type: ignore
 
diff --git a/sphinx/registry.py b/sphinx/registry.py
index 93a7ebc2538..d25c688c46b 100644
--- a/sphinx/registry.py
+++ b/sphinx/registry.py
@@ -11,7 +11,7 @@
 import traceback
 from importlib import import_module
 from types import MethodType
-from typing import Any, Callable, Dict, Iterator, List, Tuple, Union
+from typing import Any, Callable, Dict, Iterator, List, Tuple, Type, Union
 
 from docutils import nodes
 from docutils.io import Input
@@ -37,7 +37,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.application import Sphinx
     from sphinx.ext.autodoc import Documenter
 
diff --git a/sphinx/roles.py b/sphinx/roles.py
index a42a5610d14..45a628533c9 100644
--- a/sphinx/roles.py
+++ b/sphinx/roles.py
@@ -10,8 +10,7 @@
 
 import re
 import warnings
-from typing import Any, Dict, List, Tuple
-from typing import Type  # for python3.5.1
+from typing import Any, Dict, List, Tuple, Type
 
 from docutils import nodes, utils
 from docutils.nodes import Element, Node, TextElement, system_message
diff --git a/sphinx/search/__init__.py b/sphinx/search/__init__.py
index aab4297a0a1..118bfcc5576 100644
--- a/sphinx/search/__init__.py
+++ b/sphinx/search/__init__.py
@@ -13,7 +13,7 @@
 import warnings
 from importlib import import_module
 from os import path
-from typing import Any, Dict, IO, Iterable, List, Tuple, Set
+from typing import Any, Dict, IO, Iterable, List, Tuple, Set, Type
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -25,10 +25,6 @@
 from sphinx.search.jssplitter import splitter_code
 from sphinx.util import jsdump, rpartition
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 
 class SearchLanguage:
     """
diff --git a/sphinx/transforms/i18n.py b/sphinx/transforms/i18n.py
index 34d5b13687d..c889884af85 100644
--- a/sphinx/transforms/i18n.py
+++ b/sphinx/transforms/i18n.py
@@ -10,7 +10,7 @@
 
 from os import path
 from textwrap import indent
-from typing import Any, Dict, List, Tuple, TypeVar
+from typing import Any, Dict, List, Tuple, Type, TypeVar
 
 from docutils import nodes
 from docutils.io import StringInput
@@ -31,7 +31,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index 12ae051f106..186d48d2dde 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -25,7 +25,7 @@
 from importlib import import_module
 from os import path
 from time import mktime, strptime
-from typing import Any, Callable, Dict, IO, Iterable, Iterator, List, Pattern, Set, Tuple
+from typing import Any, Callable, Dict, IO, Iterable, Iterator, List, Pattern, Set, Tuple, Type
 from urllib.parse import urlsplit, urlunsplit, quote_plus, parse_qsl, urlencode
 
 from sphinx.deprecation import RemovedInSphinx40Warning
@@ -51,7 +51,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/util/docfields.py b/sphinx/util/docfields.py
index 699738888e4..83eb282acd9 100644
--- a/sphinx/util/docfields.py
+++ b/sphinx/util/docfields.py
@@ -10,7 +10,7 @@
 """
 
 import warnings
-from typing import Any, Dict, List, Tuple, Union
+from typing import Any, Dict, List, Tuple, Type, Union
 from typing import cast
 
 from docutils import nodes
@@ -22,7 +22,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.environment import BuildEnvironment
     from sphinx.directive import ObjectDescription
 
diff --git a/sphinx/util/docutils.py b/sphinx/util/docutils.py
index 3b7b6020181..32b90a33234 100644
--- a/sphinx/util/docutils.py
+++ b/sphinx/util/docutils.py
@@ -15,7 +15,7 @@
 from distutils.version import LooseVersion
 from os import path
 from types import ModuleType
-from typing import Any, Callable, Dict, Generator, IO, List, Optional, Set, Tuple
+from typing import Any, Callable, Dict, Generator, IO, List, Optional, Set, Tuple, Type
 from typing import cast
 
 import docutils
@@ -36,7 +36,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.builders import Builder
     from sphinx.config import Config
     from sphinx.environment import BuildEnvironment
diff --git a/sphinx/util/inspect.py b/sphinx/util/inspect.py
index 281ef4493be..fb5e96d5f9d 100644
--- a/sphinx/util/inspect.py
+++ b/sphinx/util/inspect.py
@@ -24,7 +24,7 @@
 from typing import cast
 
 from sphinx.deprecation import RemovedInSphinx40Warning, RemovedInSphinx50Warning
-from sphinx.pycode.ast import ast  # for py35-37
+from sphinx.pycode.ast import ast  # for py36-37
 from sphinx.pycode.ast import unparse as ast_unparse
 from sphinx.util import logging
 from sphinx.util.typing import stringify as stringify_annotation
diff --git a/sphinx/util/logging.py b/sphinx/util/logging.py
index fb2ec29005f..266e2b0a0b9 100644
--- a/sphinx/util/logging.py
+++ b/sphinx/util/logging.py
@@ -12,7 +12,7 @@
 import logging.handlers
 from collections import defaultdict
 from contextlib import contextmanager
-from typing import Any, Dict, Generator, IO, List, Tuple, Union
+from typing import Any, Dict, Generator, IO, List, Tuple, Type, Union
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -23,7 +23,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index fa51bec6a2e..6a3c6591daf 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -10,7 +10,7 @@
 
 import re
 import warnings
-from typing import Any, Callable, Iterable, List, Set, Tuple
+from typing import Any, Callable, Iterable, List, Set, Tuple, Type
 from typing import cast
 
 from docutils import nodes
@@ -26,7 +26,6 @@
 
 if False:
     # For type annotation
-    from typing import Type  # for python3.5.1
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
     from sphinx.utils.tags import Tags
diff --git a/sphinx/util/osutil.py b/sphinx/util/osutil.py
index e44211cf903..c070abe342b 100644
--- a/sphinx/util/osutil.py
+++ b/sphinx/util/osutil.py
@@ -18,7 +18,7 @@
 import warnings
 from io import StringIO
 from os import path
-from typing import Any, Generator, Iterator, List, Tuple
+from typing import Any, Generator, Iterator, List, Tuple, Type
 
 from sphinx.deprecation import RemovedInSphinx40Warning
 
@@ -28,10 +28,6 @@
 except ImportError:
     Path = None  # type: ignore
 
-if False:
-    # For type annotation
-    from typing import Type  # for python3.5.1
-
 # Errnos that we need.
 EEXIST = getattr(errno, 'EEXIST', 0)  # RemovedInSphinx40Warning
 ENOENT = getattr(errno, 'ENOENT', 0)  # RemovedInSphinx40Warning
diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py
index eb38d232c90..c2e683eee76 100644
--- a/sphinx/util/typing.py
+++ b/sphinx/util/typing.py
@@ -101,7 +101,7 @@ def _stringify_py37(annotation: Any) -> str:
 
 
 def _stringify_py36(annotation: Any) -> str:
-    """stringify() for py35 and py36."""
+    """stringify() for py36."""
     module = getattr(annotation, '__module__', None)
     if module == 'typing':
         if getattr(annotation, '_name', None):
@@ -129,33 +129,18 @@ def _stringify_py36(annotation: Any) -> str:
             return qualname
     elif isinstance(annotation, typing.GenericMeta):
         params = None
-        if hasattr(annotation, '__args__'):
-            # for Python 3.5.2+
-            if annotation.__args__ is None or len(annotation.__args__) <= 2:  # type: ignore  # NOQA
-                params = annotation.__args__  # type: ignore
-            else:  # typing.Callable
-                args = ', '.join(stringify(arg) for arg
-                                 in annotation.__args__[:-1])  # type: ignore
-                result = stringify(annotation.__args__[-1])  # type: ignore
-                return '%s[[%s], %s]' % (qualname, args, result)
-        elif hasattr(annotation, '__parameters__'):
-            # for Python 3.5.0 and 3.5.1
-            params = annotation.__parameters__  # type: ignore
+        if annotation.__args__ is None or len(annotation.__args__) <= 2:  # type: ignore  # NOQA
+            params = annotation.__args__  # type: ignore
+        else:  # typing.Callable
+            args = ', '.join(stringify(arg) for arg
+                             in annotation.__args__[:-1])  # type: ignore
+            result = stringify(annotation.__args__[-1])  # type: ignore
+            return '%s[[%s], %s]' % (qualname, args, result)
         if params is not None:
             param_str = ', '.join(stringify(p) for p in params)
             return '%s[%s]' % (qualname, param_str)
-    elif (hasattr(typing, 'UnionMeta') and
-          isinstance(annotation, typing.UnionMeta) and  # type: ignore
-          hasattr(annotation, '__union_params__')):  # for Python 3.5
-        params = annotation.__union_params__
-        if params is not None:
-            if len(params) == 2 and params[1] is NoneType:  # type: ignore
-                return 'Optional[%s]' % stringify(params[0])
-            else:
-                param_str = ', '.join(stringify(p) for p in params)
-                return '%s[%s]' % (qualname, param_str)
     elif (hasattr(annotation, '__origin__') and
-          annotation.__origin__ is typing.Union):  # for Python 3.5.2+
+          annotation.__origin__ is typing.Union):
         params = annotation.__args__
         if params is not None:
             if len(params) == 2 and params[1] is NoneType:  # type: ignore
@@ -163,30 +148,5 @@ def _stringify_py36(annotation: Any) -> str:
             else:
                 param_str = ', '.join(stringify(p) for p in params)
                 return 'Union[%s]' % param_str
-    elif (isinstance(annotation, typing.CallableMeta) and  # type: ignore
-          getattr(annotation, '__args__', None) is not None and
-          hasattr(annotation, '__result__')):  # for Python 3.5
-        # Skipped in the case of plain typing.Callable
-        args = annotation.__args__
-        if args is None:
-            return qualname
-        elif args is Ellipsis:
-            args_str = '...'
-        else:
-            formatted_args = (stringify(a) for a in args)
-            args_str = '[%s]' % ', '.join(formatted_args)
-        return '%s[%s, %s]' % (qualname,
-                               args_str,
-                               stringify(annotation.__result__))
-    elif (isinstance(annotation, typing.TupleMeta) and  # type: ignore
-          hasattr(annotation, '__tuple_params__') and
-          hasattr(annotation, '__tuple_use_ellipsis__')):  # for Python 3.5
-        params = annotation.__tuple_params__
-        if params is not None:
-            param_strings = [stringify(p) for p in params]
-            if annotation.__tuple_use_ellipsis__:
-                param_strings.append('...')
-            return '%s[%s]' % (qualname,
-                               ', '.join(param_strings))
 
     return qualname
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index 5da11840d04..bb8fb66a74c 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -772,4 +772,3 @@ def generate_targets_for_table(self, node: Element) -> None:
         for id in node['ids'][1:]:
             self.body.append('<span id="%s"></span>' % id)
             node['ids'].remove(id)
-

From 1fb79cff452144761a09fdd0feee28724f1b904b Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 10:54:24 +0900
Subject: [PATCH 008/305] Run mypy under py36 mode

---
 setup.cfg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.cfg b/setup.cfg
index 6207a6c5365..273134a3f51 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -40,7 +40,7 @@ paths =
     .
 
 [mypy]
-python_version = 3.5
+python_version = 3.6
 disallow_incomplete_defs = True
 show_column_numbers = True
 show_error_context = True

From 28e5e66f78f46e5e44b053297a0c90a718effcf7 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 11:15:54 +0900
Subject: [PATCH 009/305] Use typing.NamedTuple instead of
 collections.namedtuple as possible

---
 sphinx/builders/_epub_base.py  | 33 ++++++++++++++++++++++++++-------
 sphinx/builders/epub3.py       | 10 +++++++---
 sphinx/config.py               |  8 +++++---
 sphinx/domains/changeset.py    | 13 ++++++++-----
 sphinx/ext/autodoc/importer.py |  8 +++++---
 sphinx/testing/fixtures.py     |  1 -
 sphinx/util/i18n.py            |  9 ++++++---
 7 files changed, 57 insertions(+), 25 deletions(-)

diff --git a/sphinx/builders/_epub_base.py b/sphinx/builders/_epub_base.py
index f86715fcf9b..0f440dc9b31 100644
--- a/sphinx/builders/_epub_base.py
+++ b/sphinx/builders/_epub_base.py
@@ -12,9 +12,8 @@
 import os
 import re
 import warnings
-from collections import namedtuple
 from os import path
-from typing import Any, Dict, List, Set, Tuple
+from typing import Any, Dict, List, NamedTuple, Set, Tuple
 from zipfile import ZIP_DEFLATED, ZIP_STORED, ZipFile
 
 from docutils import nodes
@@ -85,10 +84,30 @@
 REFURI_RE = re.compile("([^#:]*#)(.*)")
 
 
-ManifestItem = namedtuple('ManifestItem', ['href', 'id', 'media_type'])
-Spine = namedtuple('Spine', ['idref', 'linear'])
-Guide = namedtuple('Guide', ['type', 'title', 'uri'])
-NavPoint = namedtuple('NavPoint', ['navpoint', 'playorder', 'text', 'refuri', 'children'])
+class ManifestItem(NamedTuple):
+    href: str
+    id: str
+    media_type: str
+
+
+class Spine(NamedTuple):
+    idref: str
+    linear: bool
+
+
+class Guide(NamedTuple):
+    type: str
+    title: str
+    uri: str
+
+
+class NavPoint(NamedTuple):
+    navpoint: str
+    playorder: int
+    text: str
+    refuri: str
+    children: List[Any]     # mypy does not support recursive types
+                            # https://github.com/python/mypy/issues/7069
 
 
 def sphinx_smarty_pants(t: str, language: str = 'en') -> str:
@@ -635,7 +654,7 @@ def build_navpoints(self, nodes: List[Dict[str, Any]]) -> List[NavPoint]:
         the parent node is reinserted in the subnav.
         """
         navstack = []  # type: List[NavPoint]
-        navstack.append(NavPoint('dummy', '', '', '', []))
+        navstack.append(NavPoint('dummy', 0, '', '', []))
         level = 0
         lastnode = None
         for node in nodes:
diff --git a/sphinx/builders/epub3.py b/sphinx/builders/epub3.py
index 5d7121fe6df..7caac74d30f 100644
--- a/sphinx/builders/epub3.py
+++ b/sphinx/builders/epub3.py
@@ -11,9 +11,8 @@
 
 import html
 import warnings
-from collections import namedtuple
 from os import path
-from typing import Any, Dict, List, Set, Tuple
+from typing import Any, Dict, List, NamedTuple, Set, Tuple
 
 from sphinx import package_dir
 from sphinx.application import Sphinx
@@ -29,7 +28,12 @@
 logger = logging.getLogger(__name__)
 
 
-NavPoint = namedtuple('NavPoint', ['text', 'refuri', 'children'])
+class NavPoint(NamedTuple):
+    text: str
+    refuri: str
+    children: List[Any]     # mypy does not support recursive types
+                            # https://github.com/python/mypy/issues/7069
+
 
 # writing modes
 PAGE_PROGRESSION_DIRECTIONS = {
diff --git a/sphinx/config.py b/sphinx/config.py
index 87007c33d06..652682168af 100644
--- a/sphinx/config.py
+++ b/sphinx/config.py
@@ -39,9 +39,11 @@
 UNSERIALIZABLE_TYPES = (type, types.ModuleType, types.FunctionType)
 copyright_year_re = re.compile(r'^((\d{4}-)?)(\d{4})(?=[ ,])')
 
-ConfigValue = NamedTuple('ConfigValue', [('name', str),
-                                         ('value', Any),
-                                         ('rebuild', Union[bool, str])])
+
+class ConfigValue(NamedTuple):
+    name: str
+    value: Any
+    rebuild: Union[bool, str]
 
 
 def is_serializable(obj: Any) -> bool:
diff --git a/sphinx/domains/changeset.py b/sphinx/domains/changeset.py
index a07944db897..0f982f418f7 100644
--- a/sphinx/domains/changeset.py
+++ b/sphinx/domains/changeset.py
@@ -8,8 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 
-from collections import namedtuple
-from typing import Any, Dict, List
+from typing import Any, Dict, List, NamedTuple
 from typing import cast
 
 from docutils import nodes
@@ -40,9 +39,13 @@
 }
 
 
-# TODO: move to typing.NamedTuple after dropping py35 support (see #5958)
-ChangeSet = namedtuple('ChangeSet',
-                       ['type', 'docname', 'lineno', 'module', 'descname', 'content'])
+class ChangeSet(NamedTuple):
+    type: str
+    docname: str
+    lineno: int
+    module: str
+    descname: str
+    content: str
 
 
 class VersionChange(SphinxDirective):
diff --git a/sphinx/ext/autodoc/importer.py b/sphinx/ext/autodoc/importer.py
index e98b9791532..a7d68d8faca 100644
--- a/sphinx/ext/autodoc/importer.py
+++ b/sphinx/ext/autodoc/importer.py
@@ -11,8 +11,7 @@
 import importlib
 import traceback
 import warnings
-from collections import namedtuple
-from typing import Any, Callable, Dict, List, Mapping, Tuple
+from typing import Any, Callable, Dict, List, Mapping, NamedTuple, Tuple
 
 from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.util import logging
@@ -122,7 +121,10 @@ def get_module_members(module: Any) -> List[Tuple[str, Any]]:
     return sorted(list(members.values()))
 
 
-Attribute = namedtuple('Attribute', ['name', 'directly_defined', 'value'])
+class Attribute(NamedTuple):
+    name: str
+    directly_defined: bool
+    value: Any
 
 
 def get_object_members(subject: Any, objpath: List[str], attrgetter: Callable,
diff --git a/sphinx/testing/fixtures.py b/sphinx/testing/fixtures.py
index eec3b4208ee..a864e19d16e 100644
--- a/sphinx/testing/fixtures.py
+++ b/sphinx/testing/fixtures.py
@@ -76,7 +76,6 @@ def app_params(request: Any, test_params: Dict, shared_result: SharedResult,
     args = [pargs[i] for i in sorted(pargs.keys())]
 
     # ##### process pytest.mark.test_params
-
     if test_params['shared_result']:
         if 'srcdir' in kwargs:
             raise pytest.Exception('You can not spcify shared_result and '
diff --git a/sphinx/util/i18n.py b/sphinx/util/i18n.py
index 1cb75637cd8..c1da9442954 100644
--- a/sphinx/util/i18n.py
+++ b/sphinx/util/i18n.py
@@ -11,10 +11,9 @@
 import os
 import re
 import warnings
-from collections import namedtuple
 from datetime import datetime, timezone
 from os import path
-from typing import Callable, Generator, List, Set, Tuple
+from typing import Callable, Generator, List, NamedTuple, Set, Tuple
 
 import babel.dates
 from babel.messages.mofile import write_mo
@@ -34,7 +33,11 @@
 
 logger = logging.getLogger(__name__)
 
-LocaleFileInfoBase = namedtuple('CatalogInfo', 'base_dir,domain,charset')
+
+class LocaleFileInfoBase(NamedTuple):
+    base_dir: str
+    domain: str
+    charset: str
 
 
 class CatalogInfo(LocaleFileInfoBase):

From 3b87df07ff0e875564684cf278427e31d7d4548d Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 11:16:24 +0900
Subject: [PATCH 010/305] Use subprocess.run(encoding=...)

---
 sphinx/__init__.py    | 4 ++--
 sphinx/ext/imgmath.py | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index 6a2b88fefdf..f03a53b1f9a 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -56,8 +56,8 @@
     __version__ = __version__[:-1]  # remove '+' for PEP-440 version spec.
     try:
         ret = subprocess.run(['git', 'show', '-s', '--pretty=format:%h'],
-                             stdout=PIPE, stderr=PIPE)
+                             stdout=PIPE, stderr=PIPE, encoding='ascii')
         if ret.stdout:
-            __display_version__ += '/' + ret.stdout.decode('ascii').strip()
+            __display_version__ += '/' + ret.stdout.strip()
     except Exception:
         pass
diff --git a/sphinx/ext/imgmath.py b/sphinx/ext/imgmath.py
index 4297ad1829a..911445a54a0 100644
--- a/sphinx/ext/imgmath.py
+++ b/sphinx/ext/imgmath.py
@@ -86,8 +86,8 @@ class InvokeError(SphinxError):
 \end{document}
 '''
 
-depth_re = re.compile(br'\[\d+ depth=(-?\d+)\]')
-depthsvg_re = re.compile(br'.*, depth=(.*)pt')
+depth_re = re.compile(r'\[\d+ depth=(-?\d+)\]')
+depthsvg_re = re.compile(r'.*, depth=(.*)pt')
 depthsvgcomment_re = re.compile(r'<!-- DEPTH=(-?\d+) -->')
 
 
@@ -175,10 +175,10 @@ def compile_math(latex: str, builder: Builder) -> str:
         raise MathExtError('latex exited with error', exc.stderr, exc.stdout)
 
 
-def convert_dvi_to_image(command: List[str], name: str) -> Tuple[bytes, bytes]:
+def convert_dvi_to_image(command: List[str], name: str) -> Tuple[str, str]:
     """Convert DVI file to specific image format."""
     try:
-        ret = subprocess.run(command, stdout=PIPE, stderr=PIPE, check=True)
+        ret = subprocess.run(command, stdout=PIPE, stderr=PIPE, check=True, encoding='ascii')
         return ret.stdout, ret.stderr
     except OSError:
         logger.warning(__('%s command %r cannot be run (needed for math '

From 941bf951acda5a27b6ff5adef6678c974b6615ba Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 11:30:01 +0900
Subject: [PATCH 011/305] Hello TYPE_CHECKING!

---
 sphinx/__init__.py                        | 4 ----
 sphinx/addnodes.py                        | 4 ++--
 sphinx/application.py                     | 5 ++---
 sphinx/builders/__init__.py               | 4 ++--
 sphinx/config.py                          | 4 ++--
 sphinx/directives/__init__.py             | 5 ++---
 sphinx/directives/code.py                 | 4 ++--
 sphinx/directives/other.py                | 5 ++---
 sphinx/directives/patches.py              | 5 ++---
 sphinx/domains/__init__.py                | 5 ++---
 sphinx/domains/changeset.py               | 5 ++---
 sphinx/domains/citation.py                | 5 ++---
 sphinx/domains/index.py                   | 4 ++--
 sphinx/domains/math.py                    | 4 ++--
 sphinx/domains/std.py                     | 5 ++---
 sphinx/environment/__init__.py            | 5 ++---
 sphinx/environment/adapters/toctree.py    | 5 ++---
 sphinx/environment/collectors/__init__.py | 4 ++--
 sphinx/events.py                          | 4 ++--
 sphinx/ext/autodoc/__init__.py            | 4 ++--
 sphinx/ext/doctest.py                     | 4 ++--
 sphinx/extension.py                       | 4 ++--
 sphinx/io.py                              | 4 ++--
 sphinx/jinja2glue.py                      | 4 ++--
 sphinx/parsers.py                         | 6 +++---
 sphinx/project.py                         | 6 +++---
 sphinx/registry.py                        | 4 ++--
 sphinx/roles.py                           | 4 ++--
 sphinx/setup_command.py                   | 6 +++---
 sphinx/theming.py                         | 4 ++--
 sphinx/transforms/__init__.py             | 4 ++--
 sphinx/transforms/i18n.py                 | 4 ++--
 sphinx/transforms/references.py           | 4 ++--
 sphinx/util/__init__.py                   | 4 ++--
 sphinx/util/compat.py                     | 4 ++--
 sphinx/util/docfields.py                  | 5 ++---
 sphinx/util/docutils.py                   | 5 ++---
 sphinx/util/fileutil.py                   | 4 ++--
 sphinx/util/i18n.py                       | 4 ++--
 sphinx/util/inventory.py                  | 4 ++--
 sphinx/util/logging.py                    | 4 ++--
 sphinx/util/nodes.py                      | 5 ++---
 sphinx/versioning.py                      | 4 ++--
 sphinx/writers/html.py                    | 5 ++---
 sphinx/writers/html5.py                   | 5 ++---
 sphinx/writers/latex.py                   | 5 ++---
 sphinx/writers/texinfo.py                 | 5 ++---
 sphinx/writers/text.py                    | 5 ++---
 48 files changed, 97 insertions(+), 119 deletions(-)

diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index f03a53b1f9a..3f4dab272eb 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -19,10 +19,6 @@
 
 from .deprecation import RemovedInNextVersionWarning
 
-if False:
-    # For type annotation
-    from typing import Any  # NOQA
-
 
 # by default, all DeprecationWarning under sphinx package will be emit.
 # Users can avoid this by using environment variable: PYTHONWARNINGS=
diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 15d5fc46be2..8a4171f8fce 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -10,14 +10,14 @@
 
 import warnings
 from typing import Any, Dict, List, Sequence
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Node
 
 from sphinx.deprecation import RemovedInSphinx40Warning
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/application.py b/sphinx/application.py
index a24bd9bb9b6..6eeb3e1835a 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -19,6 +19,7 @@
 from io import StringIO
 from os import path
 from typing import Any, Callable, Dict, IO, List, Tuple, Type, Union
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Element, TextElement
@@ -53,9 +54,7 @@
 from sphinx.util.tags import Tags
 from sphinx.util.typing import RoleFunction, TitleGetter
 
-if False:
-    # For type annotation
-    from docutils.nodes import Node  # NOQA
+if TYPE_CHECKING:
     from sphinx.builders import Builder
 
 
diff --git a/sphinx/builders/__init__.py b/sphinx/builders/__init__.py
index 1d43080dfe4..32717296115 100644
--- a/sphinx/builders/__init__.py
+++ b/sphinx/builders/__init__.py
@@ -12,6 +12,7 @@
 import time
 from os import path
 from typing import Any, Dict, Iterable, List, Sequence, Set, Tuple, Type, Union
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -42,8 +43,7 @@
 except ImportError:
     multiprocessing = None
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/config.py b/sphinx/config.py
index 652682168af..82cf89a4e41 100644
--- a/sphinx/config.py
+++ b/sphinx/config.py
@@ -17,6 +17,7 @@
 from typing import (
     Any, Callable, Dict, Generator, Iterator, List, NamedTuple, Set, Tuple, Union
 )
+from typing import TYPE_CHECKING
 
 from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.errors import ConfigError, ExtensionError
@@ -28,8 +29,7 @@
 from sphinx.util.tags import Tags
 from sphinx.util.typing import NoneType
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.environment import BuildEnvironment
 
diff --git a/sphinx/directives/__init__.py b/sphinx/directives/__init__.py
index 0d9490f31d3..3d528e57053 100644
--- a/sphinx/directives/__init__.py
+++ b/sphinx/directives/__init__.py
@@ -10,7 +10,7 @@
 
 import re
 from typing import Any, Dict, List, Tuple
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -26,8 +26,7 @@
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.typing import DirectiveOption
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/directives/code.py b/sphinx/directives/code.py
index 8c19dd0c53d..c743ec69e52 100644
--- a/sphinx/directives/code.py
+++ b/sphinx/directives/code.py
@@ -10,6 +10,7 @@
 import warnings
 from difflib import unified_diff
 from typing import Any, Dict, List, Tuple
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -24,8 +25,7 @@
 from sphinx.util import parselinenos
 from sphinx.util.docutils import SphinxDirective
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 logger = logging.getLogger(__name__)
diff --git a/sphinx/directives/other.py b/sphinx/directives/other.py
index e4fcc0f5cd4..949e8523522 100644
--- a/sphinx/directives/other.py
+++ b/sphinx/directives/other.py
@@ -8,7 +8,7 @@
 
 import re
 from typing import Any, Dict, List
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -26,8 +26,7 @@
 from sphinx.util.matching import Matcher, patfilter
 from sphinx.util.nodes import explicit_title_re
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/directives/patches.py b/sphinx/directives/patches.py
index 8a27c0170b6..c4535e119fa 100644
--- a/sphinx/directives/patches.py
+++ b/sphinx/directives/patches.py
@@ -8,7 +8,7 @@
 
 import warnings
 from typing import Any, Dict, List, Tuple
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Node, make_id, system_message
@@ -22,8 +22,7 @@
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import set_source_info
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/domains/__init__.py b/sphinx/domains/__init__.py
index 11f0d208c9c..f1d8523d488 100644
--- a/sphinx/domains/__init__.py
+++ b/sphinx/domains/__init__.py
@@ -11,7 +11,7 @@
 
 import copy
 from typing import Any, Callable, Dict, Iterable, List, NamedTuple, Tuple, Type, Union
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, system_message
@@ -23,8 +23,7 @@
 from sphinx.roles import XRefRole
 from sphinx.util.typing import RoleFunction
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
 
diff --git a/sphinx/domains/changeset.py b/sphinx/domains/changeset.py
index 0f982f418f7..a5a6e51e5b8 100644
--- a/sphinx/domains/changeset.py
+++ b/sphinx/domains/changeset.py
@@ -9,7 +9,7 @@
 """
 
 from typing import Any, Dict, List, NamedTuple
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -20,8 +20,7 @@
 from sphinx.util.docutils import SphinxDirective
 
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.environment import BuildEnvironment
 
diff --git a/sphinx/domains/citation.py b/sphinx/domains/citation.py
index 38901867a74..f097ecf9768 100644
--- a/sphinx/domains/citation.py
+++ b/sphinx/domains/citation.py
@@ -9,7 +9,7 @@
 """
 
 from typing import Any, Dict, List, Set, Tuple
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Element
@@ -21,8 +21,7 @@
 from sphinx.util import logging
 from sphinx.util.nodes import copy_source_info, make_refnode
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
diff --git a/sphinx/domains/index.py b/sphinx/domains/index.py
index 18a256bacc9..25d681f5e6a 100644
--- a/sphinx/domains/index.py
+++ b/sphinx/domains/index.py
@@ -9,6 +9,7 @@
 """
 
 from typing import Any, Dict, Iterable, List, Tuple
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Node, system_message
@@ -22,8 +23,7 @@
 from sphinx.util.docutils import ReferenceRole, SphinxDirective
 from sphinx.util.nodes import process_index_entry
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/domains/math.py b/sphinx/domains/math.py
index 88b6e4eb8a0..49c57bda8f7 100644
--- a/sphinx/domains/math.py
+++ b/sphinx/domains/math.py
@@ -10,6 +10,7 @@
 
 import warnings
 from typing import Any, Dict, Iterable, List, Tuple
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Element, Node, system_message
@@ -24,8 +25,7 @@
 from sphinx.util import logging
 from sphinx.util.nodes import make_refnode
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.builders import Builder
 
diff --git a/sphinx/domains/std.py b/sphinx/domains/std.py
index 0fa93dd23b4..4b3441cfe0b 100644
--- a/sphinx/domains/std.py
+++ b/sphinx/domains/std.py
@@ -13,7 +13,7 @@
 import warnings
 from copy import copy
 from typing import Any, Callable, Dict, Iterable, Iterator, List, Optional, Tuple, Type, Union
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, system_message
@@ -32,8 +32,7 @@
 from sphinx.util.nodes import clean_astext, make_id, make_refnode
 from sphinx.util.typing import RoleFunction
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
diff --git a/sphinx/environment/__init__.py b/sphinx/environment/__init__.py
index d40a6cbb3f4..c45e43c232d 100644
--- a/sphinx/environment/__init__.py
+++ b/sphinx/environment/__init__.py
@@ -15,7 +15,7 @@
 from copy import copy
 from os import path
 from typing import Any, Callable, Dict, Generator, Iterator, List, Set, Tuple, Union
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -36,8 +36,7 @@
 from sphinx.util.i18n import CatalogRepository, docname_to_domain
 from sphinx.util.nodes import is_translatable
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.builders import Builder
 
diff --git a/sphinx/environment/adapters/toctree.py b/sphinx/environment/adapters/toctree.py
index bd3abd9ed5e..2156156c286 100644
--- a/sphinx/environment/adapters/toctree.py
+++ b/sphinx/environment/adapters/toctree.py
@@ -9,7 +9,7 @@
 """
 
 from typing import Any, Iterable, List
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -20,8 +20,7 @@
 from sphinx.util.matching import Matcher
 from sphinx.util.nodes import clean_astext, process_only_nodes
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
 
diff --git a/sphinx/environment/collectors/__init__.py b/sphinx/environment/collectors/__init__.py
index 53e3a1c7274..2dd33c767c4 100644
--- a/sphinx/environment/collectors/__init__.py
+++ b/sphinx/environment/collectors/__init__.py
@@ -9,13 +9,13 @@
 """
 
 from typing import Dict, List, Set
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 
 from sphinx.environment import BuildEnvironment
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/events.py b/sphinx/events.py
index ff49f290c17..46759eccd96 100644
--- a/sphinx/events.py
+++ b/sphinx/events.py
@@ -14,14 +14,14 @@
 from collections import defaultdict
 from operator import attrgetter
 from typing import Any, Callable, Dict, List, NamedTuple
+from typing import TYPE_CHECKING
 
 from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.errors import ExtensionError
 from sphinx.locale import __
 from sphinx.util import logging
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 025d4a09105..1eaa81508af 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -15,6 +15,7 @@
 import warnings
 from types import ModuleType
 from typing import Any, Callable, Dict, Iterator, List, Sequence, Set, Tuple, Type, Union
+from typing import TYPE_CHECKING
 
 from docutils.statemachine import StringList
 
@@ -34,8 +35,7 @@
 from sphinx.util.inspect import getdoc, object_description, safe_getattr, stringify_signature
 from sphinx.util.typing import stringify as stringify_typehint
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.ext.autodoc.directive import DocumenterBridge
 
 
diff --git a/sphinx/ext/doctest.py b/sphinx/ext/doctest.py
index f20e840ec5f..687bd6e0adb 100644
--- a/sphinx/ext/doctest.py
+++ b/sphinx/ext/doctest.py
@@ -17,6 +17,7 @@
 from io import StringIO
 from os import path
 from typing import Any, Callable, Dict, Iterable, List, Sequence, Set, Tuple, Type
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Element, Node, TextElement
@@ -33,8 +34,7 @@
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.osutil import relpath
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/extension.py b/sphinx/extension.py
index 45ea46677d3..af164ab2a23 100644
--- a/sphinx/extension.py
+++ b/sphinx/extension.py
@@ -9,14 +9,14 @@
 """
 
 from typing import Any, Dict
+from typing import TYPE_CHECKING
 
 from sphinx.config import Config
 from sphinx.errors import VersionRequirementError
 from sphinx.locale import __
 from sphinx.util import logging
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 logger = logging.getLogger(__name__)
diff --git a/sphinx/io.py b/sphinx/io.py
index 0462afd83ec..c8dba1fed6a 100644
--- a/sphinx/io.py
+++ b/sphinx/io.py
@@ -10,6 +10,7 @@
 import codecs
 import warnings
 from typing import Any, List, Type
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.core import Publisher
@@ -37,8 +38,7 @@
 from sphinx.util.docutils import LoggingReporter
 from sphinx.versioning import UIDTransform
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/jinja2glue.py b/sphinx/jinja2glue.py
index e943cfb1e44..a097888a19a 100644
--- a/sphinx/jinja2glue.py
+++ b/sphinx/jinja2glue.py
@@ -11,6 +11,7 @@
 from os import path
 from pprint import pformat
 from typing import Any, Callable, Dict, Iterator, List, Tuple, Union
+from typing import TYPE_CHECKING
 
 from jinja2 import FileSystemLoader, BaseLoader, TemplateNotFound, contextfunction
 from jinja2.environment import Environment
@@ -22,8 +23,7 @@
 from sphinx.util import logging
 from sphinx.util.osutil import mtimes_of_files
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders import Builder
 
 
diff --git a/sphinx/parsers.py b/sphinx/parsers.py
index fb6c263c933..635cd6d5011 100644
--- a/sphinx/parsers.py
+++ b/sphinx/parsers.py
@@ -10,6 +10,7 @@
 
 import warnings
 from typing import Any, Dict, List, Type, Union
+from typing import TYPE_CHECKING
 
 import docutils.parsers
 import docutils.parsers.rst
@@ -21,8 +22,7 @@
 from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.util.rst import append_epilog, prepend_prolog
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from docutils.transforms import Transform  # NOQA
     from sphinx.application import Sphinx
 
@@ -70,7 +70,7 @@ def app(self) -> "Sphinx":
 class RSTParser(docutils.parsers.rst.Parser, Parser):
     """A reST parser for Sphinx."""
 
-    def get_transforms(self) -> List[Type[Transform]]:
+    def get_transforms(self) -> List[Type["Transform"]]:
         """Sphinx's reST parser replaces a transform class for smart-quotes by own's
 
         refs: sphinx.io.SphinxStandaloneReader
diff --git a/sphinx/project.py b/sphinx/project.py
index d63af1fcbb0..40991660847 100644
--- a/sphinx/project.py
+++ b/sphinx/project.py
@@ -9,6 +9,7 @@
 """
 
 import os
+from typing import TYPE_CHECKING
 
 from sphinx.locale import __
 from sphinx.util import get_matching_files
@@ -17,9 +18,8 @@
 from sphinx.util.matching import compile_matchers
 from sphinx.util.osutil import SEP, relpath
 
-if False:
-    # For type annotation
-    from typing import Dict, List, Set  # NOQA
+if TYPE_CHECKING:
+    from typing import Dict, List, Set
 
 
 logger = logging.getLogger(__name__)
diff --git a/sphinx/registry.py b/sphinx/registry.py
index d25c688c46b..35d07bf6c85 100644
--- a/sphinx/registry.py
+++ b/sphinx/registry.py
@@ -12,6 +12,7 @@
 from importlib import import_module
 from types import MethodType
 from typing import Any, Callable, Dict, Iterator, List, Tuple, Type, Union
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.io import Input
@@ -35,8 +36,7 @@
 from sphinx.util.logging import prefixed_warnings
 from sphinx.util.typing import RoleFunction, TitleGetter
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.ext.autodoc import Documenter
 
diff --git a/sphinx/roles.py b/sphinx/roles.py
index 45a628533c9..f7c77c44914 100644
--- a/sphinx/roles.py
+++ b/sphinx/roles.py
@@ -11,6 +11,7 @@
 import re
 import warnings
 from typing import Any, Dict, List, Tuple, Type
+from typing import TYPE_CHECKING
 
 from docutils import nodes, utils
 from docutils.nodes import Element, Node, TextElement, system_message
@@ -26,8 +27,7 @@
 )
 from sphinx.util.typing import RoleFunction
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.environment import BuildEnvironment
 
diff --git a/sphinx/setup_command.py b/sphinx/setup_command.py
index f5515857500..fa28c230d8f 100644
--- a/sphinx/setup_command.py
+++ b/sphinx/setup_command.py
@@ -16,6 +16,7 @@
 from distutils.cmd import Command
 from distutils.errors import DistutilsOptionError, DistutilsExecError
 from io import StringIO
+from typing import TYPE_CHECKING
 
 from sphinx.application import Sphinx
 from sphinx.cmd.build import handle_exception
@@ -23,9 +24,8 @@
 from sphinx.util.docutils import docutils_namespace, patch_docutils
 from sphinx.util.osutil import abspath
 
-if False:
-    # For type annotation
-    from typing import Any, Dict  # NOQA
+if TYPE_CHECKING:
+    from typing import Any, Dict
 
 
 class BuildDoc(Command):
diff --git a/sphinx/theming.py b/sphinx/theming.py
index 13a895393ba..2636329a054 100644
--- a/sphinx/theming.py
+++ b/sphinx/theming.py
@@ -14,6 +14,7 @@
 import tempfile
 from os import path
 from typing import Any, Dict, List
+from typing import TYPE_CHECKING
 from zipfile import ZipFile
 
 import pkg_resources
@@ -24,8 +25,7 @@
 from sphinx.util import logging
 from sphinx.util.osutil import ensuredir
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/transforms/__init__.py b/sphinx/transforms/__init__.py
index a00f04fdfef..2185b3de1e4 100644
--- a/sphinx/transforms/__init__.py
+++ b/sphinx/transforms/__init__.py
@@ -10,6 +10,7 @@
 
 import re
 from typing import Any, Dict, Generator, List, Tuple
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Element, Node, Text
@@ -28,8 +29,7 @@
 from sphinx.util.i18n import format_date
 from sphinx.util.nodes import NodeMatcher, apply_source_workaround, is_smartquotable
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.domain.std import StandardDomain
     from sphinx.environment import BuildEnvironment
diff --git a/sphinx/transforms/i18n.py b/sphinx/transforms/i18n.py
index c889884af85..e6a12b9626b 100644
--- a/sphinx/transforms/i18n.py
+++ b/sphinx/transforms/i18n.py
@@ -11,6 +11,7 @@
 from os import path
 from textwrap import indent
 from typing import Any, Dict, List, Tuple, Type, TypeVar
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.io import StringInput
@@ -29,8 +30,7 @@
     extract_messages, is_pending_meta, traverse_translatable_index,
 )
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/transforms/references.py b/sphinx/transforms/references.py
index e74d9657d32..d25c8cbac4e 100644
--- a/sphinx/transforms/references.py
+++ b/sphinx/transforms/references.py
@@ -9,14 +9,14 @@
 """
 
 from typing import Any, Dict
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.transforms.references import DanglingReferences, Substitutions
 
 from sphinx.transforms import SphinxTransform
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index 186d48d2dde..8e1d4df84f2 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -26,6 +26,7 @@
 from os import path
 from time import mktime, strptime
 from typing import Any, Callable, Dict, IO, Iterable, Iterator, List, Pattern, Set, Tuple, Type
+from typing import TYPE_CHECKING
 from urllib.parse import urlsplit, urlunsplit, quote_plus, parse_qsl, urlencode
 
 from sphinx.deprecation import RemovedInSphinx40Warning
@@ -49,8 +50,7 @@
 from sphinx.util.matching import patfilter  # noqa
 
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/util/compat.py b/sphinx/util/compat.py
index 0135899eb33..502edb5256c 100644
--- a/sphinx/util/compat.py
+++ b/sphinx/util/compat.py
@@ -11,6 +11,7 @@
 import sys
 import warnings
 from typing import Any, Dict
+from typing import TYPE_CHECKING
 
 from docutils.utils import get_source_line
 
@@ -18,8 +19,7 @@
 from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.transforms import SphinxTransform
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/util/docfields.py b/sphinx/util/docfields.py
index 83eb282acd9..561271c4fec 100644
--- a/sphinx/util/docfields.py
+++ b/sphinx/util/docfields.py
@@ -11,7 +11,7 @@
 
 import warnings
 from typing import Any, Dict, List, Tuple, Type, Union
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -20,8 +20,7 @@
 from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.util.typing import TextlikeNode
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.environment import BuildEnvironment
     from sphinx.directive import ObjectDescription
 
diff --git a/sphinx/util/docutils.py b/sphinx/util/docutils.py
index 32b90a33234..f211b5d0d0b 100644
--- a/sphinx/util/docutils.py
+++ b/sphinx/util/docutils.py
@@ -16,7 +16,7 @@
 from os import path
 from types import ModuleType
 from typing import Any, Callable, Dict, Generator, IO, List, Optional, Set, Tuple, Type
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 import docutils
 from docutils import nodes
@@ -34,8 +34,7 @@
 logger = logging.getLogger(__name__)
 report_re = re.compile('^(.+?:(?:\\d+)?): \\((DEBUG|INFO|WARNING|ERROR|SEVERE)/(\\d+)?\\) ')
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders import Builder
     from sphinx.config import Config
     from sphinx.environment import BuildEnvironment
diff --git a/sphinx/util/fileutil.py b/sphinx/util/fileutil.py
index d8e896d48e1..b3da39b58f6 100644
--- a/sphinx/util/fileutil.py
+++ b/sphinx/util/fileutil.py
@@ -11,14 +11,14 @@
 import os
 import posixpath
 from typing import Dict
+from typing import TYPE_CHECKING
 
 from docutils.utils import relative_path
 
 from sphinx.util.osutil import copyfile, ensuredir
 from sphinx.util.typing import PathMatcher
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.util.template import BaseRenderer
 
 
diff --git a/sphinx/util/i18n.py b/sphinx/util/i18n.py
index c1da9442954..f58b0faaf0a 100644
--- a/sphinx/util/i18n.py
+++ b/sphinx/util/i18n.py
@@ -14,6 +14,7 @@
 from datetime import datetime, timezone
 from os import path
 from typing import Callable, Generator, List, NamedTuple, Set, Tuple
+from typing import TYPE_CHECKING
 
 import babel.dates
 from babel.messages.mofile import write_mo
@@ -26,8 +27,7 @@
 from sphinx.util.matching import Matcher
 from sphinx.util.osutil import SEP, canon_path, relpath
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.environment import BuildEnvironment
 
 
diff --git a/sphinx/util/inventory.py b/sphinx/util/inventory.py
index 9b647ccacba..3e5cf19b23a 100644
--- a/sphinx/util/inventory.py
+++ b/sphinx/util/inventory.py
@@ -11,6 +11,7 @@
 import re
 import zlib
 from typing import Callable, IO, Iterator
+from typing import TYPE_CHECKING
 
 from sphinx.util import logging
 from sphinx.util.typing import Inventory
@@ -19,8 +20,7 @@
 BUFSIZE = 16 * 1024
 logger = logging.getLogger(__name__)
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
 
diff --git a/sphinx/util/logging.py b/sphinx/util/logging.py
index 266e2b0a0b9..c9085c663bb 100644
--- a/sphinx/util/logging.py
+++ b/sphinx/util/logging.py
@@ -13,6 +13,7 @@
 from collections import defaultdict
 from contextlib import contextmanager
 from typing import Any, Dict, Generator, IO, List, Tuple, Type, Union
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -21,8 +22,7 @@
 from sphinx.errors import SphinxWarning
 from sphinx.util.console import colorize
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index 6a3c6591daf..4065118154b 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -11,7 +11,7 @@
 import re
 import warnings
 from typing import Any, Callable, Iterable, List, Set, Tuple, Type
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -24,8 +24,7 @@
 from sphinx.locale import __
 from sphinx.util import logging
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
     from sphinx.utils.tags import Tags
diff --git a/sphinx/versioning.py b/sphinx/versioning.py
index 502bf361c9c..3c6a43c198b 100644
--- a/sphinx/versioning.py
+++ b/sphinx/versioning.py
@@ -13,14 +13,14 @@
 from operator import itemgetter
 from os import path
 from typing import Any, Dict, Iterator
+from typing import TYPE_CHECKING
 from uuid import uuid4
 
 from docutils.nodes import Node
 
 from sphinx.transforms import SphinxTransform
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 try:
diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py
index e74c0334f78..508e28c2215 100644
--- a/sphinx/writers/html.py
+++ b/sphinx/writers/html.py
@@ -13,7 +13,7 @@
 import posixpath
 import warnings
 from typing import Any, Iterable, Tuple
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, Text
@@ -27,8 +27,7 @@
 from sphinx.util.docutils import SphinxTranslator
 from sphinx.util.images import get_image_size
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders.html import StandaloneHTMLBuilder
 
 
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index bb8fb66a74c..164ec3659f9 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -12,7 +12,7 @@
 import posixpath
 import warnings
 from typing import Any, Iterable, Tuple
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, Text
@@ -26,8 +26,7 @@
 from sphinx.util.docutils import SphinxTranslator
 from sphinx.util.images import get_image_size
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders.html import StandaloneHTMLBuilder
 
 
diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py
index 9390ba5de9a..e97271a187d 100644
--- a/sphinx/writers/latex.py
+++ b/sphinx/writers/latex.py
@@ -16,7 +16,7 @@
 from collections import defaultdict
 from os import path
 from typing import Any, Dict, Iterable, Iterator, List, Tuple, Set, Union
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes, writers
 from docutils.nodes import Element, Node, Text
@@ -42,8 +42,7 @@
     # In Debain/Ubuntu, roman package is provided as roman, not as docutils.utils.roman
     from roman import toRoman  # type: ignore
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders.latex import LaTeXBuilder
     from sphinx.builders.latex.theming import Theme
 
diff --git a/sphinx/writers/texinfo.py b/sphinx/writers/texinfo.py
index 9c30244e9c5..bd30a73eed0 100644
--- a/sphinx/writers/texinfo.py
+++ b/sphinx/writers/texinfo.py
@@ -12,7 +12,7 @@
 import textwrap
 from os import path
 from typing import Any, Dict, Iterable, Iterator, List, Pattern, Set, Tuple, Union
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes, writers
 from docutils.nodes import Element, Node, Text
@@ -27,8 +27,7 @@
 from sphinx.util.i18n import format_date
 from sphinx.writers.latex import collected_footnote
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders.texinfo import TexinfoBuilder
 
 
diff --git a/sphinx/writers/text.py b/sphinx/writers/text.py
index b2ccd7b8932..7ac5f52c6bd 100644
--- a/sphinx/writers/text.py
+++ b/sphinx/writers/text.py
@@ -13,7 +13,7 @@
 import textwrap
 from itertools import groupby, chain
 from typing import Any, Dict, Generator, List, Iterable, Optional, Set, Tuple, Union
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes, writers
 from docutils.nodes import Element, Node, Text
@@ -23,8 +23,7 @@
 from sphinx.locale import admonitionlabels, _
 from sphinx.util.docutils import SphinxTranslator
 
-if False:
-    # For type annotation
+if TYPE_CHECKING:
     from sphinx.builders.text import TextBuilder
 
 

From d0cff3b4fc564cadfc51bb05638ef71c1b1b1425 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 15 Mar 2020 22:50:47 +0900
Subject: [PATCH 012/305] Deprecate sphinx.util.pycompat.execfile_()

---
 CHANGES                   |  2 ++
 doc/extdev/deprecated.rst | 10 ++++++++++
 sphinx/config.py          |  7 ++++---
 sphinx/util/pycompat.py   |  9 ++++++++-
 4 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/CHANGES b/CHANGES
index a070ef07223..1b5126d9776 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,8 @@ Deprecated
 * ``sphinx.directives.patches.CSVTable``
 * ``sphinx.directives.patches.ListTable``
 * ``sphinx.directives.patches.RSTTable``
+* ``sphinx.util.pycompat.convert_with_2to3()``
+* ``sphinx.util.pycompat.execfile_()``
 * ``sphinx.util.smartypants``
 
 Features added
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index ec8f4d6ae23..0cd6df32b76 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -41,6 +41,16 @@ The following is a list of deprecated interfaces.
      - 6.0
      - ``docutils.parsers.rst.diretives.tables.RSTTable``
 
+   * - ``sphinx.util.pycompat.convert_with_2to3()``
+     - 4.0
+     - 6.0
+     - N/A
+
+   * - ``sphinx.util.pycompat.execfile_()``
+     - 4.0
+     - 6.0
+     - N/A
+
    * - ``sphinx.util.smartypants``
      - 4.0
      - 6.0
diff --git a/sphinx/config.py b/sphinx/config.py
index 82cf89a4e41..08a77f2b6a9 100644
--- a/sphinx/config.py
+++ b/sphinx/config.py
@@ -24,8 +24,7 @@
 from sphinx.locale import _, __
 from sphinx.util import logging
 from sphinx.util.i18n import format_date
-from sphinx.util.osutil import cd
-from sphinx.util.pycompat import execfile_
+from sphinx.util.osutil import cd, fs_encoding
 from sphinx.util.tags import Tags
 from sphinx.util.typing import NoneType
 
@@ -318,7 +317,9 @@ def eval_config_file(filename: str, tags: Tags) -> Dict[str, Any]:
     with cd(path.dirname(filename)):
         # during executing config file, current dir is changed to ``confdir``.
         try:
-            execfile_(filename, namespace)
+            with open(filename, 'rb') as f:
+                code = compile(f.read(), filename.encode(fs_encoding), 'exec')
+                exec(code, namespace)
         except SyntaxError as err:
             msg = __("There is a syntax error in your configuration file: %s\n")
             raise ConfigError(msg % err)
diff --git a/sphinx/util/pycompat.py b/sphinx/util/pycompat.py
index 061bbcb6d5e..88e9ac8d570 100644
--- a/sphinx/util/pycompat.py
+++ b/sphinx/util/pycompat.py
@@ -15,7 +15,9 @@
 import warnings
 from typing import Any, Callable
 
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
+from sphinx.deprecation import (
+    RemovedInSphinx40Warning, RemovedInSphinx60Warning, deprecated_alias
+)
 from sphinx.locale import __
 from sphinx.util import logging
 from sphinx.util.console import terminal_safe
@@ -31,6 +33,9 @@
 # convert_with_2to3():
 # support for running 2to3 over config files
 def convert_with_2to3(filepath: str) -> str:
+    warnings.warn('convert_with_2to3() is deprecated',
+                  RemovedInSphinx60Warning, stacklevel=2)
+
     from lib2to3.refactor import RefactoringTool, get_fixers_from_package
     from lib2to3.pgen2.parse import ParseError
     fixers = get_fixers_from_package('lib2to3.fixes')
@@ -59,6 +64,8 @@ def __str__(self) -> str:
 
 
 def execfile_(filepath: str, _globals: Any, open: Callable = open) -> None:
+    warnings.warn('execfile_() is deprecated',
+                  RemovedInSphinx60Warning, stacklevel=2)
     from sphinx.util.osutil import fs_encoding
     with open(filepath, 'rb') as f:
         source = f.read()

From 495d9a45e00c888f4266547330bd3d25da0b4032 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vedran=20Mileti=C4=87?= <vedran@miletic.net>
Date: Tue, 24 Mar 2020 23:36:12 +0100
Subject: [PATCH 013/305] Add more EXAMPLES, update some changed links

---
 EXAMPLES | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/EXAMPLES b/EXAMPLES
index 1f6bc848b66..ee18c13e594 100644
--- a/EXAMPLES
+++ b/EXAMPLES
@@ -12,19 +12,20 @@ interesting examples.
 Documentation using the alabaster theme
 ---------------------------------------
 
+* `AIOHTTP <https://docs.aiohttp.org/>`__
 * `Alabaster <https://alabaster.readthedocs.io/>`__
 * `Blinker <https://pythonhosted.org/blinker/>`__
 * `Calibre <https://manual.calibre-ebook.com/>`__
-* `Click <http://click.pocoo.org/>`__ (customized)
+* `Click <https://click.palletsprojects.com/>`__ (customized)
 * `coala <https://docs.coala.io/>`__ (customized)
 * `CodePy <https://documen.tician.de/codepy/>`__
 * `Eve <https://docs.python-eve.org/>`__ (Python REST API framework)
 * `Fabric <https://docs.fabfile.org/>`__
 * `Fityk <https://fityk.nieto.pl/>`__
-* `Flask <http://flask.pocoo.org/docs/>`__
+* `Flask <https://flask.palletsprojects.com/>`__
 * `Flask-OpenID <https://pythonhosted.org/Flask-OpenID/>`__
 * `Invoke <https://docs.pyinvoke.org/>`__
-* `Jinja <http://jinja.pocoo.org/docs/>`__
+* `Jinja <https://jinja.palletsprojects.com/>`__
 * `Lino <http://www.lino-framework.org/>`__ (customized)
 * `marbl <https://getmarbl.readthedocs.io/>`__
 * `MDAnalysis <https://www.mdanalysis.org/docs/>`__ (customized)
@@ -41,7 +42,8 @@ Documentation using the alabaster theme
 * `Spyder <https://docs.spyder-ide.org/>`__ (customized)
 * `Tablib <http://docs.python-tablib.org/>`__
 * `urllib3 <https://urllib3.readthedocs.io/>`__ (customized)
-* `Werkzeug <http://werkzeug.pocoo.org/docs/>`__ (customized)
+* `Werkzeug <https://werkzeug.palletsprojects.com/>`__
+* `Write the Docs <https://writethedocs-www.readthedocs.io/>`__
 
 Documentation using the classic theme
 -------------------------------------
@@ -132,7 +134,7 @@ Documentation using the sphinxdoc theme
 Documentation using the nature theme
 ------------------------------------
 
-* `Alembic <http://alembic.zzzcomputing.com/>`__
+* `Alembic <https://alembic.sqlalchemy.org/>`__
 * `Cython <http://docs.cython.org/>`__
 * `easybuild <https://easybuild.readthedocs.io/>`__
 * `jsFiddle <http://doc.jsfiddle.net/>`__
@@ -141,6 +143,7 @@ Documentation using the nature theme
 * `MapServer <https://mapserver.org/>`__ (customized)
 * `Pandas <https://pandas.pydata.org/pandas-docs/stable/>`__
 * `pyglet <https://pyglet.readthedocs.io/>`__ (customized)
+* `PyWavelets <https://pywavelets.readthedocs.io/>`__
 * `Setuptools <https://setuptools.readthedocs.io/>`__
 * `Spring Python <https://docs.spring.io/spring-python/1.2.x/sphinx/html/>`__
 * `StatsModels <https://www.statsmodels.org/>`__ (customized)
@@ -156,6 +159,7 @@ Documentation using another builtin theme
 * `PyPubSub <https://pypubsub.readthedocs.io/>`__ (bizstyle)
 * `Pylons <https://docs.pylonsproject.org/projects/pylons-webframework/>`__ (pyramid)
 * `Pyramid web framework <https://docs.pylonsproject.org/projects/pyramid/>`__ (pyramid)
+* `RxDock <https://www.rxdock.org/documentation/html/devel/>`__
 * `Sphinx <http://www.sphinx-doc.org/>`__ (sphinx13) :-)
 * `Valence <https://docs.valence.desire2learn.com/>`__ (haiku, customized)
 
@@ -226,6 +230,7 @@ Documentation using sphinx_rtd_theme
 * `mod_wsgi <https://modwsgi.readthedocs.io/>`__
 * `MoinMoin <https://moin-20.readthedocs.io/>`__
 * `Mopidy <https://docs.mopidy.com/>`__
+* `mpi4py <https://mpi4py.readthedocs.io/>`__
 * `MyHDL <http://docs.myhdl.org/>`__
 * `Nextflow <https://www.nextflow.io/docs/latest/index.html>`__
 * `NICOS <https://forge.frm2.tum.de/nicos/doc/nicos-master/>`__ (customized)
@@ -244,6 +249,7 @@ Documentation using sphinx_rtd_theme
 * `python-sqlparse <https://sqlparse.readthedocs.io/>`__
 * `PyVISA <https://pyvisa.readthedocs.io/>`__
 * `Read The Docs <https://docs.readthedocs.io/>`__
+* `ROCm Platform <https://rocm-documentation.readthedocs.io/>`__
 * `Free your information from their silos (French) <http://redaction-technique.org/>`__ (customized)
 * `Releases Sphinx extension <https://releases.readthedocs.io/>`__
 * `Qtile <http://docs.qtile.org/>`__
@@ -251,7 +257,7 @@ Documentation using sphinx_rtd_theme
 * `QuTiP <http://qutip.org/docs/latest/>`__
 * `Satchmo <http://docs.satchmoproject.com/>`__
 * `Scapy <https://scapy.readthedocs.io/>`__
-* `SimGrid <http://simgrid.gforge.inria.fr/simgrid/latest/doc/>`__
+* `SimGrid <https://simgrid.org/doc/latest/>`__
 * `SimPy <https://simpy.readthedocs.io/>`__
 * `six <https://six.readthedocs.io/>`__
 * `SlamData <https://newdocs.slamdata.com>`__
@@ -280,7 +286,6 @@ Documentation using sphinx_rtd_theme
 * `Web Application Attack and Audit Framework (w3af) <http://docs.w3af.org/>`__
 * `Weblate <https://docs.weblate.org/>`__
 * `x265 <https://x265.readthedocs.io/>`__
-* `ZeroNet <https://zeronet.readthedocs.io/>`__
 * `Zulip <https://zulip.readthedocs.io/>`__
 
 Documentation using sphinx_bootstrap_theme
@@ -315,6 +320,7 @@ Documentation using a custom theme or integrated in a website
 * `Django <https://docs.djangoproject.com/>`__
 * `Doctrine <https://www.doctrine-project.org/>`__
 * `Enterprise Toolkit for Acrobat products <https://www.adobe.com/devnet-docs/acrobatetk/>`__
+* `fmt <https://fmt.dev/>`__
 * `Gameduino <http://excamera.com/sphinx/gameduino/>`__
 * `gensim <https://radimrehurek.com/gensim/>`__
 * `GeoServer <http://docs.geoserver.org/>`__
@@ -324,6 +330,7 @@ Documentation using a custom theme or integrated in a website
 * `H2O.ai <http://docs.h2o.ai/>`__
 * `Heka <https://hekad.readthedocs.io/>`__
 * `Istihza (Turkish Python documentation project) <https://belgeler.yazbel.com/python-istihza/>`__
+* `JupyterHub <https://jupyterhub.readthedocs.io/>`__
 * `Kombu <http://docs.kombu.me/>`__
 * `Lasso <http://lassoguide.com/>`__
 * `Mako <http://docs.makotemplates.org/>`__

From df1b05a659d858d2034df587a14494e111339f45 Mon Sep 17 00:00:00 2001
From: Rick Wertenbroek <rick.wertenbroek@heig-vd.ch>
Date: Wed, 25 Mar 2020 11:18:18 +0100
Subject: [PATCH 014/305] Update Instalation.rst - Docker sphinx-quickstart

I suggest adding the -it option to the docker run command for sphinx-quickstart since it is an interactive command.
Without interaction, the process will simply stop with the [Interrupted.] state after the first option
...
> Separate source and build directories (y/n) [n]:
[Interrupted.]
---
 doc/usage/installation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/installation.rst b/doc/usage/installation.rst
index c7e92ad2a30..83fc74d77fd 100644
--- a/doc/usage/installation.rst
+++ b/doc/usage/installation.rst
@@ -179,7 +179,7 @@ Please choose one for your purpose.
    When using docker images, please use ``docker run`` command to invoke sphinx commands.  For example,
    you can use following command to create a Sphinx project::
 
-      $ docker run --rm -v /path/to/document:/docs sphinxdoc/sphinx sphinx-quickstart
+      $ docker run -it --rm -v /path/to/document:/docs sphinxdoc/sphinx sphinx-quickstart
 
    And you can following command this to build HTML document::
 

From 5b9e3fbf2ea253771b8a1b860803c1fb022f9ebf Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 6 Apr 2020 00:43:52 +0900
Subject: [PATCH 015/305] Fix mypy violations

---
 sphinx/domains/python.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 7b78841cacd..59c4b4f1ea9 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -14,7 +14,7 @@
 import typing
 import warnings
 from inspect import Parameter
-from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Tuple
+from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Tuple, Type
 from typing import cast
 
 from docutils import nodes
@@ -227,7 +227,7 @@ def _pseudo_parse_arglist(signode: desc_signature, arglist: str) -> None:
 # when it comes to handling "." and "~" prefixes.
 class PyXrefMixin:
     def make_xref(self, rolename: str, domain: str, target: str,
-                  innernode: "Type[TextlikeNode]" = nodes.emphasis,
+                  innernode: Type[TextlikeNode] = nodes.emphasis,
                   contnode: Node = None, env: BuildEnvironment = None) -> Node:
         result = super().make_xref(rolename, domain, target,  # type: ignore
                                    innernode, contnode, env)
@@ -244,7 +244,7 @@ def make_xref(self, rolename: str, domain: str, target: str,
         return result
 
     def make_xrefs(self, rolename: str, domain: str, target: str,
-                   innernode: "Type[TextlikeNode]" = nodes.emphasis,
+                   innernode: Type[TextlikeNode] = nodes.emphasis,
                    contnode: Node = None, env: BuildEnvironment = None) -> List[Node]:
         delims = r'(\s*[\[\]\(\),](?:\s*or\s)?\s*|\s+or\s+)'
         delims_re = re.compile(delims)
@@ -268,7 +268,7 @@ def make_xrefs(self, rolename: str, domain: str, target: str,
 
 class PyField(PyXrefMixin, Field):
     def make_xref(self, rolename: str, domain: str, target: str,
-                  innernode: "Type[TextlikeNode]" = nodes.emphasis,
+                  innernode: Type[TextlikeNode] = nodes.emphasis,
                   contnode: Node = None, env: BuildEnvironment = None) -> Node:
         if rolename == 'class' and target == 'None':
             # None is not a type, so use obj role instead.
@@ -283,7 +283,7 @@ class PyGroupedField(PyXrefMixin, GroupedField):
 
 class PyTypedField(PyXrefMixin, TypedField):
     def make_xref(self, rolename: str, domain: str, target: str,
-                  innernode: "Type[TextlikeNode]" = nodes.emphasis,
+                  innernode: Type[TextlikeNode] = nodes.emphasis,
                   contnode: Node = None, env: BuildEnvironment = None) -> Node:
         if rolename == 'class' and target == 'None':
             # None is not a type, so use obj role instead.

From bee44bedb100d325e4e9dad681521819bd774f5f Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 27 Apr 2020 01:29:13 +0900
Subject: [PATCH 016/305] Fix mypy violation

---
 sphinx/ext/autodoc/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 3b7b5a71aeb..8f8c609ff17 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -732,7 +732,7 @@ def generate(self, more_content: Any = None, real_modname: str = None,
         # This is used for situations where you have a module that collects the
         # functions and classes of internal submodules.
         guess_modname = self.get_real_modname()
-        self.real_modname = real_modname or guess_modname
+        self.real_modname = real_modname or guess_modname  # type: str
 
         # try to also get a source code analyzer for attribute docs
         try:

From c57f71cb5174a24185c82ba0c2bf2e1958daee7c Mon Sep 17 00:00:00 2001
From: Kjell Braden <afflux@pentabarf.de>
Date: Sun, 26 Apr 2020 20:09:43 +0200
Subject: [PATCH 017/305] always use separate fields for param and type in
 ext.autodoc.typehints

this fixes issues where annotations such as `x: typing.Tuple[int, int]`
will be transformed to `:field typing.Tuple[int, int] x:`, which renders
as `*int] x* (**typing.Tuple[int,**) -- `
---
 sphinx/ext/autodoc/typehints.py | 20 ++++++--------------
 1 file changed, 6 insertions(+), 14 deletions(-)

diff --git a/sphinx/ext/autodoc/typehints.py b/sphinx/ext/autodoc/typehints.py
index f917dbdf303..b763bdfc780 100644
--- a/sphinx/ext/autodoc/typehints.py
+++ b/sphinx/ext/autodoc/typehints.py
@@ -104,24 +104,16 @@ def modify_field_list(node: nodes.field_list, annotations: Dict[str, str]) -> No
             continue
 
         arg = arguments.get(name, {})
-        field = nodes.field()
-        if arg.get('param') and arg.get('type'):
-            # both param and type are already filled manually
-            continue
-        elif arg.get('param'):
-            # only param: fill type field
+        if not arg.get('type'):
+            field = nodes.field()
             field += nodes.field_name('', 'type ' + name)
             field += nodes.field_body('', nodes.paragraph('', annotation))
-        elif arg.get('type'):
-            # only type: It's odd...
+            node += field
+        if not arg.get('param'):
+            field = nodes.field()
             field += nodes.field_name('', 'param ' + name)
             field += nodes.field_body('', nodes.paragraph('', ''))
-        else:
-            # both param and type are not found
-            field += nodes.field_name('', 'param ' + annotation + ' ' + name)
-            field += nodes.field_body('', nodes.paragraph('', ''))
-
-        node += field
+            node += field
 
     if 'return' in annotations and 'return' not in arguments:
         field = nodes.field()

From a86346aca6bf99a8920da366caaad7c47809ecce Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 7 Mar 2020 20:43:25 +0900
Subject: [PATCH 018/305] Remove deprecated features marked as
 RemovedInSphinx40Warning

---
 doc/extdev/nodes.rst                          |   1 -
 sphinx/addnodes.py                            |  19 +-
 sphinx/application.py                         |  39 +--
 sphinx/builders/_epub_base.py                 |  96 ++-----
 sphinx/builders/applehelp.py                  |  42 ---
 sphinx/builders/devhelp.py                    |  38 ---
 sphinx/builders/dirhtml.py                    |   9 -
 sphinx/builders/epub3.py                      |  23 +-
 sphinx/builders/gettext.py                    |  21 --
 sphinx/builders/html/__init__.py              |  22 +-
 sphinx/builders/htmlhelp.py                   |  42 ---
 sphinx/builders/latex/__init__.py             |  45 ----
 sphinx/builders/qthelp.py                     |  39 ---
 sphinx/builders/singlehtml.py                 |   9 -
 sphinx/cmd/quickstart.py                      |  42 +--
 sphinx/config.py                              |  22 --
 sphinx/deprecation.py                         |   4 +-
 sphinx/directives/__init__.py                 |  37 +--
 sphinx/directives/code.py                     |  13 -
 sphinx/directives/other.py                    |  11 -
 sphinx/domains/math.py                        |  20 --
 sphinx/domains/python.py                      | 119 +-------
 sphinx/domains/std.py                         |  40 +--
 sphinx/environment/__init__.py                |  41 +--
 sphinx/environment/collectors/indexentries.py |  64 -----
 sphinx/events.py                              |  13 +-
 sphinx/ext/apidoc.py                          |  71 -----
 sphinx/ext/autodoc/__init__.py                |  30 +--
 sphinx/ext/autodoc/directive.py               |  17 +-
 sphinx/ext/autodoc/importer.py                |  16 --
 sphinx/ext/autosummary/__init__.py            |  54 +---
 sphinx/ext/autosummary/generate.py            |  33 +--
 sphinx/ext/doctest.py                         |   8 -
 sphinx/ext/imgmath.py                         |  37 ---
 sphinx/ext/jsmath.py                          |  36 ---
 sphinx/ext/todo.py                            | 105 +-------
 sphinx/io.py                                  |  23 --
 sphinx/pycode/__init__.py                     |  27 +-
 sphinx/roles.py                               | 254 ------------------
 sphinx/search/__init__.py                     |   7 +-
 sphinx/testing/fixtures.py                    |   6 +-
 sphinx/testing/util.py                        |  11 +-
 sphinx/transforms/__init__.py                 |  13 -
 sphinx/util/__init__.py                       | 195 +-------------
 sphinx/util/cfamily.py                        |  23 +-
 sphinx/util/compat.py                         |  22 --
 sphinx/util/docfields.py                      |  23 +-
 sphinx/util/i18n.py                           |  81 +-----
 sphinx/util/inspect.py                        | 169 +-----------
 sphinx/util/jsonimpl.py                       |  46 ----
 sphinx/util/nodes.py                          |   8 -
 sphinx/util/osutil.py                         |  25 +-
 sphinx/util/pycompat.py                       |  54 +---
 sphinx/util/texescape.py                      |  10 -
 sphinx/writers/html.py                        |  13 +-
 sphinx/writers/html5.py                       |  13 +-
 sphinx/writers/latex.py                       | 104 +------
 sphinx/writers/manpage.py                     |  11 +-
 tests/test_util_pycompat.py                   |  38 ---
 59 files changed, 106 insertions(+), 2348 deletions(-)
 delete mode 100644 sphinx/builders/applehelp.py
 delete mode 100644 sphinx/builders/devhelp.py
 delete mode 100644 sphinx/builders/htmlhelp.py
 delete mode 100644 sphinx/builders/qthelp.py
 delete mode 100644 sphinx/environment/collectors/indexentries.py
 delete mode 100644 sphinx/ext/jsmath.py
 delete mode 100644 sphinx/util/jsonimpl.py
 delete mode 100644 tests/test_util_pycompat.py

diff --git a/doc/extdev/nodes.rst b/doc/extdev/nodes.rst
index 5d8272eae2f..e38393a78c5 100644
--- a/doc/extdev/nodes.rst
+++ b/doc/extdev/nodes.rst
@@ -38,7 +38,6 @@ New inline nodes
 .. autoclass:: index
 .. autoclass:: pending_xref
 .. autoclass:: literal_emphasis
-.. autoclass:: abbreviation
 .. autoclass:: download_reference
 
 Special nodes
diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index f02f3b5d76a..42a0faed6fb 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -8,14 +8,11 @@
     :license: BSD, see LICENSE for details.
 """
 
-import warnings
 from typing import Any, Dict, List, Sequence
 from typing import TYPE_CHECKING
 
 from docutils import nodes
-from docutils.nodes import Element, Node
-
-from sphinx.deprecation import RemovedInSphinx40Warning
+from docutils.nodes import Element
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -325,20 +322,6 @@ class literal_strong(nodes.strong, not_smartquotable):
     """
 
 
-class abbreviation(nodes.abbreviation):
-    """Node for abbreviations with explanations.
-
-    .. deprecated:: 2.0
-    """
-
-    def __init__(self, rawsource: str = '', text: str = '',
-                 *children: Node, **attributes: Any) -> None:
-        warnings.warn("abbrevition node for Sphinx was replaced by docutils'.",
-                      RemovedInSphinx40Warning, stacklevel=2)
-
-        super().__init__(rawsource, text, *children, **attributes)
-
-
 class manpage(nodes.Inline, nodes.FixedTextElement):
     """Node for references to manpages."""
 
diff --git a/sphinx/application.py b/sphinx/application.py
index f782f7639bf..04d6dc95242 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -14,7 +14,6 @@
 import pickle
 import platform
 import sys
-import warnings
 from collections import deque
 from io import StringIO
 from os import path
@@ -30,14 +29,13 @@
 import sphinx
 from sphinx import package_dir, locale
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.domains import Domain, Index
 from sphinx.environment import BuildEnvironment
 from sphinx.environment.collectors import EnvironmentCollector
 from sphinx.errors import ApplicationError, ConfigError, VersionRequirementError
 from sphinx.events import EventManager
 from sphinx.extension import Extension
-from sphinx.highlighting import lexer_classes, lexers
+from sphinx.highlighting import lexer_classes
 from sphinx.locale import __
 from sphinx.project import Project
 from sphinx.registry import SphinxComponentRegistry
@@ -861,13 +859,6 @@ def add_post_transform(self, transform: "Type[Transform]") -> None:
         """
         self.registry.add_post_transform(transform)
 
-    def add_javascript(self, filename: str, **kwargs: str) -> None:
-        """An alias of :meth:`add_js_file`."""
-        warnings.warn('The app.add_javascript() is deprecated. '
-                      'Please use app.add_js_file() instead.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        self.add_js_file(filename, **kwargs)
-
     def add_js_file(self, filename: str, **kwargs: str) -> None:
         """Register a JavaScript file to include in the HTML output.
 
@@ -938,24 +929,6 @@ def add_css_file(self, filename: str, **kwargs: str) -> None:
         if hasattr(self.builder, 'add_css_file'):
             self.builder.add_css_file(filename, **kwargs)  # type: ignore
 
-    def add_stylesheet(self, filename: str, alternate: bool = False, title: str = None
-                       ) -> None:
-        """An alias of :meth:`add_css_file`."""
-        warnings.warn('The app.add_stylesheet() is deprecated. '
-                      'Please use app.add_css_file() instead.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-
-        attributes = {}  # type: Dict[str, str]
-        if alternate:
-            attributes['rel'] = 'alternate stylesheet'
-        else:
-            attributes['rel'] = 'stylesheet'
-
-        if title:
-            attributes['title'] = title
-
-        self.add_css_file(filename, **attributes)
-
     def add_latex_package(self, packagename: str, options: str = None) -> None:
         r"""Register a package to include in the LaTeX source code.
 
@@ -974,7 +947,7 @@ def add_latex_package(self, packagename: str, options: str = None) -> None:
         """
         self.registry.add_latex_package(packagename, options)
 
-    def add_lexer(self, alias: str, lexer: Union[Lexer, "Type[Lexer]"]) -> None:
+    def add_lexer(self, alias: str, lexer: Type[Lexer]) -> None:
         """Register a new lexer for source code.
 
         Use *lexer* to highlight code blocks with the given language *alias*.
@@ -985,13 +958,7 @@ def add_lexer(self, alias: str, lexer: Union[Lexer, "Type[Lexer]"]) -> None:
            still supported until Sphinx-3.x.
         """
         logger.debug('[app] adding lexer: %r', (alias, lexer))
-        if isinstance(lexer, Lexer):
-            warnings.warn('app.add_lexer() API changed; '
-                          'Please give lexer class instead instance',
-                          RemovedInSphinx40Warning)
-            lexers[alias] = lexer
-        else:
-            lexer_classes[alias] = lexer
+        lexer_classes[alias] = lexer
 
     def add_autodocumenter(self, cls: Any, override: bool = False) -> None:
         """Register a new documenter class for the autodoc extension.
diff --git a/sphinx/builders/_epub_base.py b/sphinx/builders/_epub_base.py
index d39362eb9e7..7976b4f7c52 100644
--- a/sphinx/builders/_epub_base.py
+++ b/sphinx/builders/_epub_base.py
@@ -11,7 +11,6 @@
 import html
 import os
 import re
-import warnings
 from os import path
 from typing import Any, Dict, List, NamedTuple, Set, Tuple
 from zipfile import ZIP_DEFLATED, ZIP_STORED, ZipFile
@@ -22,7 +21,6 @@
 
 from sphinx import addnodes
 from sphinx.builders.html import BuildInfo, StandaloneHTMLBuilder
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.locale import __
 from sphinx.util import logging
 from sphinx.util import status_iterator
@@ -188,18 +186,6 @@ def make_id(self, name: str) -> str:
             self.id_cache[name] = id
         return id
 
-    def esc(self, name: str) -> str:
-        """Replace all characters not allowed in text an attribute values."""
-        warnings.warn(
-            '%s.esc() is deprecated. Use html.escape() instead.' % self.__class__.__name__,
-            RemovedInSphinx40Warning)
-        name = name.replace('&', '&amp;')
-        name = name.replace('<', '&lt;')
-        name = name.replace('>', '&gt;')
-        name = name.replace('"', '&quot;')
-        name = name.replace('\'', '&#39;')
-        return name
-
     def get_refnodes(self, doctree: Node, result: List[Dict[str, Any]]) -> List[Dict[str, Any]]:  # NOQA
         """Collect section titles, their depth in the toc and the refuri."""
         # XXX: is there a better way than checking the attribute
@@ -476,30 +462,17 @@ def handle_page(self, pagename: str, addctx: Dict, templatename: str = 'page.htm
         addctx['doctype'] = self.doctype
         super().handle_page(pagename, addctx, templatename, outfilename, event_arg)
 
-    def build_mimetype(self, outdir: str = None, outname: str = 'mimetype') -> None:
+    def build_mimetype(self) -> None:
         """Write the metainfo file mimetype."""
-        if outdir:
-            warnings.warn('The arguments of EpubBuilder.build_mimetype() is deprecated.',
-                          RemovedInSphinx40Warning, stacklevel=2)
-        else:
-            outdir = self.outdir
-
-        logger.info(__('writing %s file...'), outname)
-        copy_asset_file(path.join(self.template_dir, 'mimetype'),
-                        path.join(outdir, outname))
+        logger.info(__('writing mimetype file...'))
+        copy_asset_file(path.join(self.template_dir, 'mimetype'), self.outdir)
 
-    def build_container(self, outdir: str = None, outname: str = 'META-INF/container.xml') -> None:  # NOQA
+    def build_container(self, outname: str = 'META-INF/container.xml') -> None:  # NOQA
         """Write the metainfo file META-INF/container.xml."""
-        if outdir:
-            warnings.warn('The arguments of EpubBuilder.build_container() is deprecated.',
-                          RemovedInSphinx40Warning, stacklevel=2)
-        else:
-            outdir = self.outdir
-
-        logger.info(__('writing %s file...'), outname)
-        filename = path.join(outdir, outname)
-        ensuredir(path.dirname(filename))
-        copy_asset_file(path.join(self.template_dir, 'container.xml'), filename)
+        logger.info(__('writing META-INF/container.xml file...'))
+        outdir = path.join(self.outdir, 'META-INF')
+        ensuredir(outdir)
+        copy_asset_file(path.join(self.template_dir, 'container.xml'), outdir)
 
     def content_metadata(self) -> Dict[str, Any]:
         """Create a dictionary with all metadata for the content.opf
@@ -520,23 +493,17 @@ def content_metadata(self) -> Dict[str, Any]:
         metadata['guides'] = []
         return metadata
 
-    def build_content(self, outdir: str = None, outname: str = 'content.opf') -> None:
+    def build_content(self) -> None:
         """Write the metainfo file content.opf It contains bibliographic data,
         a file list and the spine (the reading order).
         """
-        if outdir:
-            warnings.warn('The arguments of EpubBuilder.build_content() is deprecated.',
-                          RemovedInSphinx40Warning, stacklevel=2)
-        else:
-            outdir = self.outdir
-
-        logger.info(__('writing %s file...'), outname)
+        logger.info(__('writing content.opf file...'))
         metadata = self.content_metadata()
 
         # files
-        if not outdir.endswith(os.sep):
-            outdir += os.sep
-        olen = len(outdir)
+        if not self.outdir.endswith(os.sep):
+            self.outdir += os.sep
+        olen = len(self.outdir)
         self.files = []  # type: List[str]
         self.ignored_files = ['.buildinfo', 'mimetype', 'content.opf',
                               'toc.ncx', 'META-INF/container.xml',
@@ -545,7 +512,7 @@ def build_content(self, outdir: str = None, outname: str = 'content.opf') -> Non
             self.config.epub_exclude_files
         if not self.use_index:
             self.ignored_files.append('genindex' + self.out_suffix)
-        for root, dirs, files in os.walk(outdir):
+        for root, dirs, files in os.walk(self.outdir):
             dirs.sort()
             for fn in sorted(files):
                 filename = path.join(root, fn)[olen:]
@@ -635,9 +602,7 @@ def build_content(self, outdir: str = None, outname: str = 'content.opf') -> Non
                                             html.escape(self.refnodes[0]['refuri'])))
 
         # write the project file
-        copy_asset_file(path.join(self.template_dir, 'content.opf_t'),
-                        path.join(outdir, outname),
-                        metadata)
+        copy_asset_file(path.join(self.template_dir, 'content.opf_t'), self.outdir, metadata)
 
     def new_navpoint(self, node: Dict[str, Any], level: int, incr: bool = True) -> NavPoint:
         """Create a new entry in the toc from the node at given level."""
@@ -703,15 +668,9 @@ def toc_metadata(self, level: int, navpoints: List[NavPoint]) -> Dict[str, Any]:
         metadata['navpoints'] = navpoints
         return metadata
 
-    def build_toc(self, outdir: str = None, outname: str = 'toc.ncx') -> None:
+    def build_toc(self) -> None:
         """Write the metainfo file toc.ncx."""
-        if outdir:
-            warnings.warn('The arguments of EpubBuilder.build_toc() is deprecated.',
-                          RemovedInSphinx40Warning, stacklevel=2)
-        else:
-            outdir = self.outdir
-
-        logger.info(__('writing %s file...'), outname)
+        logger.info(__('writing toc.ncx file...'))
 
         if self.config.epub_tocscope == 'default':
             doctree = self.env.get_and_resolve_doctree(self.config.master_doc,
@@ -726,28 +685,21 @@ def build_toc(self, outdir: str = None, outname: str = 'toc.ncx') -> None:
         navpoints = self.build_navpoints(refnodes)
         level = max(item['level'] for item in self.refnodes)
         level = min(level, self.config.epub_tocdepth)
-        copy_asset_file(path.join(self.template_dir, 'toc.ncx_t'),
-                        path.join(outdir, outname),
+        copy_asset_file(path.join(self.template_dir, 'toc.ncx_t'), self.outdir,
                         self.toc_metadata(level, navpoints))
 
-    def build_epub(self, outdir: str = None, outname: str = None) -> None:
+    def build_epub(self) -> None:
         """Write the epub file.
 
         It is a zip file with the mimetype file stored uncompressed as the first
         entry.
         """
-        if outdir:
-            warnings.warn('The arguments of EpubBuilder.build_epub() is deprecated.',
-                          RemovedInSphinx40Warning, stacklevel=2)
-        else:
-            outdir = self.outdir
-            outname = self.config.epub_basename + '.epub'
-
+        outname = self.config.epub_basename + '.epub'
         logger.info(__('writing %s file...'), outname)
-        epub_filename = path.join(outdir, outname)
+        epub_filename = path.join(self.outdir, outname)
         with ZipFile(epub_filename, 'w', ZIP_DEFLATED) as epub:
-            epub.write(path.join(outdir, 'mimetype'), 'mimetype', ZIP_STORED)
+            epub.write(path.join(self.outdir, 'mimetype'), 'mimetype', ZIP_STORED)
             for filename in ['META-INF/container.xml', 'content.opf', 'toc.ncx']:
-                epub.write(path.join(outdir, filename), filename, ZIP_DEFLATED)
+                epub.write(path.join(self.outdir, filename), filename, ZIP_DEFLATED)
             for filename in self.files:
-                epub.write(path.join(outdir, filename), filename, ZIP_DEFLATED)
+                epub.write(path.join(self.outdir, filename), filename, ZIP_DEFLATED)
diff --git a/sphinx/builders/applehelp.py b/sphinx/builders/applehelp.py
deleted file mode 100644
index f081f9fe564..00000000000
--- a/sphinx/builders/applehelp.py
+++ /dev/null
@@ -1,42 +0,0 @@
-"""
-    sphinx.builders.applehelp
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Build Apple help books.
-
-    :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import Any, Dict
-
-from sphinxcontrib.applehelp import (
-    AppleHelpCodeSigningFailed,
-    AppleHelpIndexerFailed,
-    AppleHelpBuilder,
-)
-
-from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
-
-
-deprecated_alias('sphinx.builders.applehelp',
-                 {
-                     'AppleHelpCodeSigningFailed': AppleHelpCodeSigningFailed,
-                     'AppleHelpIndexerFailed': AppleHelpIndexerFailed,
-                     'AppleHelpBuilder': AppleHelpBuilder,
-                 },
-                 RemovedInSphinx40Warning)
-
-
-def setup(app: Sphinx) -> Dict[str, Any]:
-    warnings.warn('sphinx.builders.applehelp has been moved to sphinxcontrib-applehelp.',
-                  RemovedInSphinx40Warning)
-    app.setup_extension('sphinxcontrib.applehelp')
-
-    return {
-        'version': 'builtin',
-        'parallel_read_safe': True,
-        'parallel_write_safe': True,
-    }
diff --git a/sphinx/builders/devhelp.py b/sphinx/builders/devhelp.py
deleted file mode 100644
index dda7c411fa6..00000000000
--- a/sphinx/builders/devhelp.py
+++ /dev/null
@@ -1,38 +0,0 @@
-"""
-    sphinx.builders.devhelp
-    ~~~~~~~~~~~~~~~~~~~~~~~
-
-    Build HTML documentation and Devhelp_ support files.
-
-    .. _Devhelp: https://wiki.gnome.org/Apps/Devhelp
-
-    :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import Any, Dict
-
-from sphinxcontrib.devhelp import DevhelpBuilder
-
-from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
-
-
-deprecated_alias('sphinx.builders.devhelp',
-                 {
-                     'DevhelpBuilder': DevhelpBuilder,
-                 },
-                 RemovedInSphinx40Warning)
-
-
-def setup(app: Sphinx) -> Dict[str, Any]:
-    warnings.warn('sphinx.builders.devhelp has been moved to sphinxcontrib-devhelp.',
-                  RemovedInSphinx40Warning)
-    app.setup_extension('sphinxcontrib.devhelp')
-
-    return {
-        'version': 'builtin',
-        'parallel_read_safe': True,
-        'parallel_write_safe': True,
-    }
diff --git a/sphinx/builders/dirhtml.py b/sphinx/builders/dirhtml.py
index ba60c923cba..bf940010ac7 100644
--- a/sphinx/builders/dirhtml.py
+++ b/sphinx/builders/dirhtml.py
@@ -13,7 +13,6 @@
 
 from sphinx.application import Sphinx
 from sphinx.builders.html import StandaloneHTMLBuilder
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.util import logging
 from sphinx.util.osutil import SEP, os_path
 
@@ -46,14 +45,6 @@ def get_outfilename(self, pagename: str) -> str:
         return outfilename
 
 
-# for compatibility
-deprecated_alias('sphinx.builders.html',
-                 {
-                     'DirectoryHTMLBuilder': DirectoryHTMLBuilder,
-                 },
-                 RemovedInSphinx40Warning)
-
-
 def setup(app: Sphinx) -> Dict[str, Any]:
     app.setup_extension('sphinx.builders.html')
 
diff --git a/sphinx/builders/epub3.py b/sphinx/builders/epub3.py
index b70f7b7cba1..1bef3c5bb6a 100644
--- a/sphinx/builders/epub3.py
+++ b/sphinx/builders/epub3.py
@@ -10,7 +10,6 @@
 """
 
 import html
-import warnings
 from os import path
 from typing import Any, Dict, List, NamedTuple, Set, Tuple
 
@@ -18,7 +17,6 @@
 from sphinx.application import Sphinx
 from sphinx.builders import _epub_base
 from sphinx.config import Config, ENUM
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.locale import __
 from sphinx.util import logging, xmlname_checker
 from sphinx.util.fileutil import copy_asset_file
@@ -85,10 +83,6 @@ def handle_finish(self) -> None:
         self.build_toc()
         self.build_epub()
 
-    def validate_config_value(self) -> None:
-        warnings.warn('Epub3Builder.validate_config_value() is deprecated.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-
     def content_metadata(self) -> Dict:
         """Create a dictionary with all metadata for the content.opf
         file properly escaped.
@@ -166,15 +160,9 @@ def navigation_doc_metadata(self, navlist: List[NavPoint]) -> Dict:
         metadata['navlist'] = navlist
         return metadata
 
-    def build_navigation_doc(self, outdir: str = None, outname: str = 'nav.xhtml') -> None:
+    def build_navigation_doc(self) -> None:
         """Write the metainfo file nav.xhtml."""
-        if outdir:
-            warnings.warn('The arguments of Epub3Builder.build_navigation_doc() '
-                          'is deprecated.', RemovedInSphinx40Warning, stacklevel=2)
-        else:
-            outdir = self.outdir
-
-        logger.info(__('writing %s file...'), outname)
+        logger.info(__('writing nav.xhtml file...'))
 
         if self.config.epub_tocscope == 'default':
             doctree = self.env.get_and_resolve_doctree(
@@ -186,13 +174,12 @@ def build_navigation_doc(self, outdir: str = None, outname: str = 'nav.xhtml') -
             # 'includehidden'
             refnodes = self.refnodes
         navlist = self.build_navlist(refnodes)
-        copy_asset_file(path.join(self.template_dir, 'nav.xhtml_t'),
-                        path.join(outdir, outname),
+        copy_asset_file(path.join(self.template_dir, 'nav.xhtml_t'), self.outdir,
                         self.navigation_doc_metadata(navlist))
 
         # Add nav.xhtml to epub file
-        if outname not in self.files:
-            self.files.append(outname)
+        if 'nav.xhtml' not in self.files:
+            self.files.append('nav.xhtml')
 
 
 def validate_config_values(app: Sphinx) -> None:
diff --git a/sphinx/builders/gettext.py b/sphinx/builders/gettext.py
index 3fb7595ee3b..cfc6158479d 100644
--- a/sphinx/builders/gettext.py
+++ b/sphinx/builders/gettext.py
@@ -36,27 +36,6 @@
 
 logger = logging.getLogger(__name__)
 
-POHEADER = r"""
-# SOME DESCRIPTIVE TITLE.
-# Copyright (C) %(copyright)s
-# This file is distributed under the same license as the %(project)s package.
-# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: %(project)s %(version)s\n"
-"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: %(ctime)s\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: LANGUAGE <LL@li.org>\n"
-"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-"""[1:]  # RemovedInSphinx40Warning
-
 
 class Message:
     """An entry of translatable message."""
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 0e74c0df865..27e1d8e6a09 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -12,7 +12,6 @@
 import posixpath
 import re
 import sys
-import warnings
 from hashlib import md5
 from os import path
 from typing import Any, Dict, IO, Iterable, Iterator, List, Set, Tuple, Type
@@ -28,7 +27,6 @@
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.domains import Domain, Index, IndexEntry
 from sphinx.environment.adapters.asset import ImageAdapter
 from sphinx.environment.adapters.indexentries import IndexEntries
@@ -864,21 +862,11 @@ def index_page(self, pagename: str, doctree: nodes.document, title: str) -> None
         # only index pages with title
         if self.indexer is not None and title:
             filename = self.env.doc2path(pagename, base=None)
-            try:
-                metadata = self.env.metadata.get(pagename, {})
-                if 'nosearch' in metadata:
-                    self.indexer.feed(pagename, filename, '', new_document(''))
-                else:
-                    self.indexer.feed(pagename, filename, title, doctree)
-            except TypeError:
-                # fallback for old search-adapters
-                self.indexer.feed(pagename, title, doctree)  # type: ignore
-                indexer_name = self.indexer.__class__.__name__
-                warnings.warn(
-                    'The %s.feed() method signature is deprecated. Update to '
-                    '%s.feed(docname, filename, title, doctree).' % (
-                        indexer_name, indexer_name),
-                    RemovedInSphinx40Warning)
+            metadata = self.env.metadata.get(pagename, {})
+            if 'nosearch' in metadata:
+                self.indexer.feed(pagename, filename, '', new_document(''))
+            else:
+                self.indexer.feed(pagename, filename, title, doctree)
 
     def _get_local_toctree(self, docname: str, collapse: bool = True, **kwargs: Any) -> str:
         if 'includehidden' not in kwargs:
diff --git a/sphinx/builders/htmlhelp.py b/sphinx/builders/htmlhelp.py
deleted file mode 100644
index 8732de7fd16..00000000000
--- a/sphinx/builders/htmlhelp.py
+++ /dev/null
@@ -1,42 +0,0 @@
-"""
-    sphinx.builders.htmlhelp
-    ~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Build HTML help support files.
-    Parts adapted from Python's Doc/tools/prechm.py.
-
-    :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import Any, Dict
-
-from sphinxcontrib.htmlhelp import (
-    chm_locales, chm_htmlescape, HTMLHelpBuilder, default_htmlhelp_basename
-)
-
-from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
-
-
-deprecated_alias('sphinx.builders.htmlhelp',
-                 {
-                     'chm_locales': chm_locales,
-                     'chm_htmlescape': chm_htmlescape,
-                     'HTMLHelpBuilder': HTMLHelpBuilder,
-                     'default_htmlhelp_basename': default_htmlhelp_basename,
-                 },
-                 RemovedInSphinx40Warning)
-
-
-def setup(app: Sphinx) -> Dict[str, Any]:
-    warnings.warn('sphinx.builders.htmlhelp has been moved to sphinxcontrib-htmlhelp.',
-                  RemovedInSphinx40Warning)
-    app.setup_extension('sphinxcontrib.htmlhelp')
-
-    return {
-        'version': 'builtin',
-        'parallel_read_safe': True,
-        'parallel_write_safe': True,
-    }
diff --git a/sphinx/builders/latex/__init__.py b/sphinx/builders/latex/__init__.py
index b1fe4b73e1a..467a80e9936 100644
--- a/sphinx/builders/latex/__init__.py
+++ b/sphinx/builders/latex/__init__.py
@@ -9,7 +9,6 @@
 """
 
 import os
-import warnings
 from os import path
 from typing import Any, Dict, Iterable, List, Tuple, Union
 
@@ -24,7 +23,6 @@
 from sphinx.builders.latex.theming import Theme, ThemeFactory
 from sphinx.builders.latex.util import ExtBabel
 from sphinx.config import Config, ENUM
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.environment.adapters.asset import ImageAdapter
 from sphinx.errors import NoUri, SphinxError
 from sphinx.locale import _, __
@@ -259,7 +257,6 @@ def write(self, *ignored: Any) -> None:
             defaults=self.env.settings,
             components=(docwriter,),
             read_config_files=True).get_default_values()  # type: Any
-        patch_settings(docsettings)
 
         self.init_document_data()
         self.write_stylesheet()
@@ -361,10 +358,6 @@ def assemble_doctree(self, indexfile: str, toctree_only: bool, appendices: List[
             pendingnode.replace_self(newnodes)
         return largetree
 
-    def apply_transforms(self, doctree: nodes.document) -> None:
-        warnings.warn('LaTeXBuilder.apply_transforms() is deprecated.',
-                      RemovedInSphinx40Warning)
-
     def finish(self) -> None:
         self.copy_image_files()
         self.write_message_catalog()
@@ -447,44 +440,6 @@ def write_message_catalog(self) -> None:
         copy_asset_file(filename, self.outdir, context=context, renderer=LaTeXRenderer())
 
 
-def patch_settings(settings: Any) -> Any:
-    """Make settings object to show deprecation messages."""
-
-    class Values(type(settings)):  # type: ignore
-        @property
-        def author(self) -> str:
-            warnings.warn('settings.author is deprecated',
-                          RemovedInSphinx40Warning, stacklevel=2)
-            return self._author
-
-        @property
-        def title(self) -> str:
-            warnings.warn('settings.title is deprecated',
-                          RemovedInSphinx40Warning, stacklevel=2)
-            return self._title
-
-        @property
-        def contentsname(self) -> str:
-            warnings.warn('settings.contentsname is deprecated',
-                          RemovedInSphinx40Warning, stacklevel=2)
-            return self._contentsname
-
-        @property
-        def docname(self) -> str:
-            warnings.warn('settings.docname is deprecated',
-                          RemovedInSphinx40Warning, stacklevel=2)
-            return self._docname
-
-        @property
-        def docclass(self) -> str:
-            warnings.warn('settings.docclass is deprecated',
-                          RemovedInSphinx40Warning, stacklevel=2)
-            return self._docclass
-
-    # dynamic subclassing
-    settings.__class__ = Values
-
-
 def validate_config_values(app: Sphinx, config: Config) -> None:
     for key in list(config.latex_elements):
         if key not in DEFAULT_SETTINGS:
diff --git a/sphinx/builders/qthelp.py b/sphinx/builders/qthelp.py
deleted file mode 100644
index a4e73de9ba9..00000000000
--- a/sphinx/builders/qthelp.py
+++ /dev/null
@@ -1,39 +0,0 @@
-"""
-    sphinx.builders.qthelp
-    ~~~~~~~~~~~~~~~~~~~~~~
-
-    Build input files for the Qt collection generator.
-
-    :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import Any, Dict
-
-from sphinxcontrib.qthelp import QtHelpBuilder, render_file
-
-import sphinx
-from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
-
-
-deprecated_alias('sphinx.builders.qthelp',
-                 {
-                     'render_file': render_file,
-                     'QtHelpBuilder': QtHelpBuilder,
-                 },
-                 RemovedInSphinx40Warning)
-
-
-def setup(app: Sphinx) -> Dict[str, Any]:
-    warnings.warn('sphinx.builders.qthelp has been moved to sphinxcontrib-qthelp.',
-                  RemovedInSphinx40Warning)
-
-    app.setup_extension('sphinxcontrib.qthelp')
-
-    return {
-        'version': sphinx.__display_version__,
-        'parallel_read_safe': True,
-        'parallel_write_safe': True,
-    }
diff --git a/sphinx/builders/singlehtml.py b/sphinx/builders/singlehtml.py
index b145109a6a1..19ad9c08d4e 100644
--- a/sphinx/builders/singlehtml.py
+++ b/sphinx/builders/singlehtml.py
@@ -16,7 +16,6 @@
 
 from sphinx.application import Sphinx
 from sphinx.builders.html import StandaloneHTMLBuilder
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.environment.adapters.toctree import TocTree
 from sphinx.locale import __
 from sphinx.util import logging
@@ -188,14 +187,6 @@ def write_additional_files(self) -> None:
             self.handle_page('opensearch', {}, 'opensearch.xml', outfilename=fn)
 
 
-# for compatibility
-deprecated_alias('sphinx.builders.html',
-                 {
-                     'SingleFileHTMLBuilder': SingleFileHTMLBuilder,
-                 },
-                 RemovedInSphinx40Warning)
-
-
 def setup(app: Sphinx) -> Dict[str, Any]:
     app.setup_extension('sphinx.builders.html')
 
diff --git a/sphinx/cmd/quickstart.py b/sphinx/cmd/quickstart.py
index 8f8ae58a18d..80254930420 100644
--- a/sphinx/cmd/quickstart.py
+++ b/sphinx/cmd/quickstart.py
@@ -11,13 +11,11 @@
 import argparse
 import locale
 import os
-import re
 import sys
 import time
-import warnings
 from collections import OrderedDict
 from os import path
-from typing import Any, Callable, Dict, List, Pattern, Union
+from typing import Any, Callable, Dict, List, Union
 
 # try to import readline, unix specific enhancement
 try:
@@ -35,16 +33,11 @@
 
 import sphinx.locale
 from sphinx import __display_version__, package_dir
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.locale import __
-from sphinx.util.console import (  # type: ignore
-    colorize, bold, red, turquoise, nocolor, color_terminal
-)
+from sphinx.util.console import colorize, bold, red, nocolor, color_terminal  # type: ignore
 from sphinx.util.osutil import ensuredir
 from sphinx.util.template import SphinxRenderer
 
-TERM_ENCODING = getattr(sys.stdin, 'encoding', None)  # RemovedInSphinx40Warning
-
 EXTENSIONS = OrderedDict([
     ('autodoc', __('automatically insert docstrings from modules')),
     ('doctest', __('automatically test code snippets in doctest blocks')),
@@ -135,30 +128,6 @@ def ok(x: str) -> str:
     return x
 
 
-def term_decode(text: Union[bytes, str]) -> str:
-    warnings.warn('term_decode() is deprecated.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-
-    if isinstance(text, str):
-        return text
-
-    # Use the known encoding, if possible
-    if TERM_ENCODING:
-        return text.decode(TERM_ENCODING)
-
-    # If ascii is safe, use it with no warning
-    if text.decode('ascii', 'replace').encode('ascii', 'replace') == text:
-        return text.decode('ascii')
-
-    print(turquoise(__('* Note: non-ASCII characters entered '
-                       'and terminal encoding unknown -- assuming '
-                       'UTF-8 or Latin-1.')))
-    try:
-        return text.decode()
-    except UnicodeDecodeError:
-        return text.decode('latin1')
-
-
 def do_prompt(text: str, default: str = None, validator: Callable[[str], Any] = nonempty) -> Union[str, bool]:  # NOQA
     while True:
         if default is not None:
@@ -184,13 +153,6 @@ def do_prompt(text: str, default: str = None, validator: Callable[[str], Any] =
     return x
 
 
-def convert_python_source(source: str, rex: Pattern = re.compile(r"[uU]('.*?')")) -> str:
-    # remove Unicode literal prefixes
-    warnings.warn('convert_python_source() is deprecated.',
-                  RemovedInSphinx40Warning)
-    return rex.sub('\\1', source)
-
-
 class QuickstartRenderer(SphinxRenderer):
     def __init__(self, templatedir: str) -> None:
         self.templatedir = templatedir or ''
diff --git a/sphinx/config.py b/sphinx/config.py
index aefb60c2b7b..deccc3e62ef 100644
--- a/sphinx/config.py
+++ b/sphinx/config.py
@@ -11,7 +11,6 @@
 import re
 import traceback
 import types
-import warnings
 from collections import OrderedDict
 from os import path, getenv
 from typing import (
@@ -19,7 +18,6 @@
 )
 from typing import TYPE_CHECKING
 
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.errors import ConfigError, ExtensionError
 from sphinx.locale import _, __
 from sphinx.util import logging
@@ -75,10 +73,6 @@ def match(self, value: Union[str, List, Tuple]) -> bool:
             return value in self.candidates
 
 
-# RemovedInSphinx40Warning
-string_classes = [str]  # type: List
-
-
 class Config:
     """Configuration file abstraction.
 
@@ -442,22 +436,6 @@ def check_confval_types(app: "Sphinx", config: Config) -> None:
                                           default=type(default)))
 
 
-def check_unicode(config: Config) -> None:
-    """check all string values for non-ASCII characters in bytestrings,
-    since that can result in UnicodeErrors all over the place
-    """
-    warnings.warn('sphinx.config.check_unicode() is deprecated.',
-                  RemovedInSphinx40Warning)
-
-    nonascii_re = re.compile(br'[\x80-\xff]')
-
-    for name, value in config._raw_config.items():
-        if isinstance(value, bytes) and nonascii_re.search(value):
-            logger.warning(__('the config value %r is set to a string with non-ASCII '
-                              'characters; this can lead to Unicode errors occurring. '
-                              'Please use Unicode strings, e.g. %r.'), name, 'Content')
-
-
 def check_primary_domain(app: "Sphinx", config: Config) -> None:
     primary_domain = config.primary_domain
     if primary_domain and not app.registry.has_domain(primary_domain):
diff --git a/sphinx/deprecation.py b/sphinx/deprecation.py
index 0b980a19335..77b462da8b3 100644
--- a/sphinx/deprecation.py
+++ b/sphinx/deprecation.py
@@ -18,7 +18,7 @@ class RemovedInSphinx40Warning(DeprecationWarning):
     pass
 
 
-class RemovedInSphinx50Warning(PendingDeprecationWarning):
+class RemovedInSphinx50Warning(DeprecationWarning):
     pass
 
 
@@ -26,7 +26,7 @@ class RemovedInSphinx60Warning(PendingDeprecationWarning):
     pass
 
 
-RemovedInNextVersionWarning = RemovedInSphinx40Warning
+RemovedInNextVersionWarning = RemovedInSphinx50Warning
 
 
 def deprecated_alias(modname: str, objects: Dict, warning: "Type[Warning]") -> None:
diff --git a/sphinx/directives/__init__.py b/sphinx/directives/__init__.py
index a29a51d9535..7684931c791 100644
--- a/sphinx/directives/__init__.py
+++ b/sphinx/directives/__init__.py
@@ -18,9 +18,7 @@
 
 from sphinx import addnodes
 from sphinx.addnodes import desc_signature
-from sphinx.deprecation import (
-    RemovedInSphinx40Warning, RemovedInSphinx50Warning, deprecated_alias
-)
+from sphinx.deprecation import RemovedInSphinx50Warning, deprecated_alias
 from sphinx.util import docutils
 from sphinx.util.docfields import DocFieldTransformer, Field, TypedField
 from sphinx.util.docutils import SphinxDirective
@@ -265,39 +263,6 @@ def run(self) -> List[Node]:
         self.env.temp_data['default_domain'] = self.env.domains.get(domain_name)
         return []
 
-from sphinx.directives.code import (  # noqa
-    Highlight, CodeBlock, LiteralInclude
-)
-from sphinx.directives.other import (  # noqa
-    TocTree, Author, VersionChange, SeeAlso,
-    TabularColumns, Centered, Acks, HList, Only, Include, Class
-)
-from sphinx.directives.patches import (  # noqa
-    Figure, Meta
-)
-from sphinx.domains.index import IndexDirective  # noqa
-
-deprecated_alias('sphinx.directives',
-                 {
-                     'Highlight': Highlight,
-                     'CodeBlock': CodeBlock,
-                     'LiteralInclude': LiteralInclude,
-                     'TocTree': TocTree,
-                     'Author': Author,
-                     'Index': IndexDirective,
-                     'VersionChange': VersionChange,
-                     'SeeAlso': SeeAlso,
-                     'TabularColumns': TabularColumns,
-                     'Centered': Centered,
-                     'Acks': Acks,
-                     'HList': HList,
-                     'Only': Only,
-                     'Include': Include,
-                     'Class': Class,
-                     'Figure': Figure,
-                     'Meta': Meta,
-                 },
-                 RemovedInSphinx40Warning)
 
 deprecated_alias('sphinx.directives',
                  {
diff --git a/sphinx/directives/code.py b/sphinx/directives/code.py
index c743ec69e52..fabf259e84c 100644
--- a/sphinx/directives/code.py
+++ b/sphinx/directives/code.py
@@ -7,7 +7,6 @@
 """
 
 import sys
-import warnings
 from difflib import unified_diff
 from typing import Any, Dict, List, Tuple
 from typing import TYPE_CHECKING
@@ -19,7 +18,6 @@
 
 from sphinx import addnodes
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.locale import __
 from sphinx.util import logging
 from sphinx.util import parselinenos
@@ -57,16 +55,6 @@ def run(self) -> List[Node]:
                                        linenothreshold=linenothreshold)]
 
 
-class HighlightLang(Highlight):
-    """highlightlang directive (deprecated)"""
-
-    def run(self) -> List[Node]:
-        warnings.warn('highlightlang directive is deprecated. '
-                      'Please use highlight directive instead.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return super().run()
-
-
 def dedent_lines(lines: List[str], dedent: int, location: Tuple[str, int] = None) -> List[str]:
     if not dedent:
         return lines
@@ -468,7 +456,6 @@ def run(self) -> List[Node]:
 
 def setup(app: "Sphinx") -> Dict[str, Any]:
     directives.register_directive('highlight', Highlight)
-    directives.register_directive('highlightlang', HighlightLang)
     directives.register_directive('code-block', CodeBlock)
     directives.register_directive('sourcecode', CodeBlock)
     directives.register_directive('literalinclude', LiteralInclude)
diff --git a/sphinx/directives/other.py b/sphinx/directives/other.py
index 949e8523522..fc1631edc9c 100644
--- a/sphinx/directives/other.py
+++ b/sphinx/directives/other.py
@@ -18,7 +18,6 @@
 from docutils.parsers.rst.directives.misc import Include as BaseInclude
 
 from sphinx import addnodes
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.domains.changeset import VersionChange  # NOQA  # for compatibility
 from sphinx.locale import _
 from sphinx.util import url_re, docname_join
@@ -360,16 +359,6 @@ def run(self) -> List[Node]:
         return super().run()
 
 
-# Import old modules here for compatibility
-from sphinx.domains.index import IndexDirective  # NOQA
-
-deprecated_alias('sphinx.directives.other',
-                 {
-                     'Index': IndexDirective,
-                 },
-                 RemovedInSphinx40Warning)
-
-
 def setup(app: "Sphinx") -> Dict[str, Any]:
     directives.register_directive('toctree', TocTree)
     directives.register_directive('sectionauthor', Author)
diff --git a/sphinx/domains/math.py b/sphinx/domains/math.py
index 49c57bda8f7..02c93433a54 100644
--- a/sphinx/domains/math.py
+++ b/sphinx/domains/math.py
@@ -8,7 +8,6 @@
     :license: BSD, see LICENSE for details.
 """
 
-import warnings
 from typing import Any, Dict, Iterable, List, Tuple
 from typing import TYPE_CHECKING
 
@@ -17,7 +16,6 @@
 from docutils.nodes import make_id
 
 from sphinx.addnodes import pending_xref
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.domains import Domain
 from sphinx.environment import BuildEnvironment
 from sphinx.locale import __
@@ -140,24 +138,6 @@ def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: "Bu
     def get_objects(self) -> List:
         return []
 
-    def add_equation(self, env: BuildEnvironment, docname: str, labelid: str) -> int:
-        warnings.warn('MathDomain.add_equation() is deprecated.',
-                      RemovedInSphinx40Warning)
-        if labelid in self.equations:
-            path = env.doc2path(self.equations[labelid][0])
-            msg = __('duplicate label of equation %s, other instance in %s') % (labelid, path)
-            raise UserWarning(msg)
-        else:
-            eqno = self.get_next_equation_number(docname)
-            self.equations[labelid] = (docname, eqno)
-            return eqno
-
-    def get_next_equation_number(self, docname: str) -> int:
-        warnings.warn('MathDomain.get_next_equation_number() is deprecated.',
-                      RemovedInSphinx40Warning)
-        targets = [eq for eq in self.equations.values() if eq[0] == docname]
-        return len(targets) + 1
-
     def has_equations(self) -> bool:
         return any(self.data['has_equations'].values())
 
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 11bf0ac4d13..91ba489c796 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -25,7 +25,7 @@
 from sphinx.addnodes import pending_xref, desc_signature
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx40Warning, RemovedInSphinx50Warning
+from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.directives import ObjectDescription
 from sphinx.domains import Domain, ObjType, Index, IndexEntry
 from sphinx.environment import BuildEnvironment
@@ -516,39 +516,6 @@ def after_content(self) -> None:
                 self.env.ref_context.pop('py:module')
 
 
-class PyModulelevel(PyObject):
-    """
-    Description of an object on module level (functions, data).
-    """
-
-    def run(self) -> List[Node]:
-        for cls in self.__class__.__mro__:
-            if cls.__name__ != 'DirectiveAdapter':
-                warnings.warn('PyModulelevel is deprecated. '
-                              'Please check the implementation of %s' % cls,
-                              RemovedInSphinx40Warning)
-                break
-        else:
-            warnings.warn('PyModulelevel is deprecated', RemovedInSphinx40Warning)
-
-        return super().run()
-
-    def needs_arglist(self) -> bool:
-        return self.objtype == 'function'
-
-    def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str:
-        if self.objtype == 'function':
-            if not modname:
-                return _('%s() (built-in function)') % name_cls[0]
-            return _('%s() (in module %s)') % (name_cls[0], modname)
-        elif self.objtype == 'data':
-            if not modname:
-                return _('%s (built-in variable)') % name_cls[0]
-            return _('%s (in module %s)') % (name_cls[0], modname)
-        else:
-            return ''
-
-
 class PyFunction(PyObject):
     """Description of a function."""
 
@@ -653,90 +620,6 @@ def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str:
             return ''
 
 
-class PyClassmember(PyObject):
-    """
-    Description of a class member (methods, attributes).
-    """
-
-    def run(self) -> List[Node]:
-        for cls in self.__class__.__mro__:
-            if cls.__name__ != 'DirectiveAdapter':
-                warnings.warn('PyClassmember is deprecated. '
-                              'Please check the implementation of %s' % cls,
-                              RemovedInSphinx40Warning)
-                break
-        else:
-            warnings.warn('PyClassmember is deprecated', RemovedInSphinx40Warning)
-
-        return super().run()
-
-    def needs_arglist(self) -> bool:
-        return self.objtype.endswith('method')
-
-    def get_signature_prefix(self, sig: str) -> str:
-        if self.objtype == 'staticmethod':
-            return 'static '
-        elif self.objtype == 'classmethod':
-            return 'classmethod '
-        return ''
-
-    def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str:
-        name, cls = name_cls
-        add_modules = self.env.config.add_module_names
-        if self.objtype == 'method':
-            try:
-                clsname, methname = name.rsplit('.', 1)
-            except ValueError:
-                if modname:
-                    return _('%s() (in module %s)') % (name, modname)
-                else:
-                    return '%s()' % name
-            if modname and add_modules:
-                return _('%s() (%s.%s method)') % (methname, modname, clsname)
-            else:
-                return _('%s() (%s method)') % (methname, clsname)
-        elif self.objtype == 'staticmethod':
-            try:
-                clsname, methname = name.rsplit('.', 1)
-            except ValueError:
-                if modname:
-                    return _('%s() (in module %s)') % (name, modname)
-                else:
-                    return '%s()' % name
-            if modname and add_modules:
-                return _('%s() (%s.%s static method)') % (methname, modname,
-                                                          clsname)
-            else:
-                return _('%s() (%s static method)') % (methname, clsname)
-        elif self.objtype == 'classmethod':
-            try:
-                clsname, methname = name.rsplit('.', 1)
-            except ValueError:
-                if modname:
-                    return _('%s() (in module %s)') % (name, modname)
-                else:
-                    return '%s()' % name
-            if modname:
-                return _('%s() (%s.%s class method)') % (methname, modname,
-                                                         clsname)
-            else:
-                return _('%s() (%s class method)') % (methname, clsname)
-        elif self.objtype == 'attribute':
-            try:
-                clsname, attrname = name.rsplit('.', 1)
-            except ValueError:
-                if modname:
-                    return _('%s (in module %s)') % (name, modname)
-                else:
-                    return name
-            if modname and add_modules:
-                return _('%s (%s.%s attribute)') % (attrname, modname, clsname)
-            else:
-                return _('%s (%s attribute)') % (attrname, clsname)
-        else:
-            return ''
-
-
 class PyMethod(PyObject):
     """Description of a method."""
 
diff --git a/sphinx/domains/std.py b/sphinx/domains/std.py
index 8663b97b20a..cd86f5bc124 100644
--- a/sphinx/domains/std.py
+++ b/sphinx/domains/std.py
@@ -22,7 +22,7 @@
 
 from sphinx import addnodes
 from sphinx.addnodes import desc_signature, pending_xref
-from sphinx.deprecation import RemovedInSphinx40Warning, RemovedInSphinx50Warning
+from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.directives import ObjectDescription
 from sphinx.domains import Domain, ObjType
 from sphinx.locale import _, __
@@ -272,8 +272,8 @@ def split_term_classifiers(line: str) -> List[Optional[str]]:
 
 
 def make_glossary_term(env: "BuildEnvironment", textnodes: Iterable[Node], index_key: str,
-                       source: str, lineno: int, node_id: str = None,
-                       document: nodes.document = None) -> nodes.term:
+                       source: str, lineno: int, node_id: str, document: nodes.document
+                       ) -> nodes.term:
     # get a text-only representation of the term and register it
     # as a cross-reference target
     term = nodes.term('', '', *textnodes)
@@ -284,23 +284,10 @@ def make_glossary_term(env: "BuildEnvironment", textnodes: Iterable[Node], index
     if node_id:
         # node_id is given from outside (mainly i18n module), use it forcedly
         term['ids'].append(node_id)
-    elif document:
+    else:
         node_id = make_id(env, document, 'term', termtext)
         term['ids'].append(node_id)
         document.note_explicit_target(term)
-    else:
-        warnings.warn('make_glossary_term() expects document is passed as an argument.',
-                      RemovedInSphinx40Warning)
-        gloss_entries = env.temp_data.setdefault('gloss_entries', set())
-        node_id = nodes.make_id('term-' + termtext)
-        if node_id == 'term':
-            # "term" is not good for node_id.  Generate it by sequence number instead.
-            node_id = 'term-%d' % env.new_serialno('glossary')
-
-        while node_id in gloss_entries:
-            node_id = 'term-%d' % env.new_serialno('glossary')
-        gloss_entries.add(node_id)
-        term['ids'].append(node_id)
 
     std = cast(StandardDomain, env.get_domain('std'))
     std.note_object('term', termtext, node_id, location=term)
@@ -408,7 +395,7 @@ def run(self) -> List[Node]:
 
                 # use first classifier as a index key
                 term = make_glossary_term(self.env, textnodes, parts[1], source, lineno,
-                                          document=self.state.document)
+                                          node_id=None, document=self.state.document)
                 term.rawsource = line
                 system_messages.extend(sysmsg)
                 termtexts.append(term.astext())
@@ -782,11 +769,6 @@ def resolve_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Buil
             resolver = self._resolve_doc_xref
         elif typ == 'option':
             resolver = self._resolve_option_xref
-        elif typ == 'citation':
-            warnings.warn('pending_xref(domain=std, type=citation) is deprecated: %r' % node,
-                          RemovedInSphinx40Warning)
-            domain = env.get_domain('citation')
-            return domain.resolve_xref(env, fromdocname, builder, typ, target, node, contnode)
         elif typ == 'term':
             resolver = self._resolve_term_xref
         else:
@@ -1078,18 +1060,6 @@ def get_full_qualified_name(self, node: Element) -> str:
         else:
             return None
 
-    def note_citations(self, env: "BuildEnvironment", docname: str, document: nodes.document) -> None:  # NOQA
-        warnings.warn('StandardDomain.note_citations() is deprecated.',
-                      RemovedInSphinx40Warning)
-
-    def note_citation_refs(self, env: "BuildEnvironment", docname: str, document: nodes.document) -> None:  # NOQA
-        warnings.warn('StandardDomain.note_citation_refs() is deprecated.',
-                      RemovedInSphinx40Warning)
-
-    def note_labels(self, env: "BuildEnvironment", docname: str, document: nodes.document) -> None:  # NOQA
-        warnings.warn('StandardDomain.note_labels() is deprecated.',
-                      RemovedInSphinx40Warning)
-
 
 def setup(app: "Sphinx") -> Dict[str, Any]:
     app.add_domain(StandardDomain)
diff --git a/sphinx/environment/__init__.py b/sphinx/environment/__init__.py
index 89e51ad8348..d786decc8d9 100644
--- a/sphinx/environment/__init__.py
+++ b/sphinx/environment/__init__.py
@@ -10,19 +10,17 @@
 
 import os
 import pickle
-import warnings
 from collections import defaultdict
 from copy import copy
 from os import path
 from typing import Any, Callable, Dict, Generator, Iterator, List, Set, Tuple, Union
-from typing import TYPE_CHECKING, cast
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 from docutils.nodes import Node
 
 from sphinx import addnodes
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.domains import Domain
 from sphinx.environment.adapters.toctree import TocTree
 from sphinx.errors import SphinxError, BuildEnvironmentError, DocumentError, ExtensionError
@@ -320,28 +318,13 @@ def path2doc(self, filename: str) -> str:
         """
         return self.project.path2doc(filename)
 
-    def doc2path(self, docname: str, base: Union[bool, str] = True, suffix: str = None) -> str:
+    def doc2path(self, docname: str, base: bool = True) -> str:
         """Return the filename for the document name.
 
         If *base* is True, return absolute path under self.srcdir.
-        If *base* is None, return relative path to self.srcdir.
-        If *base* is a path string, return absolute path under that.
-        If *suffix* is not None, add it instead of config.source_suffix.
+        If *base* is False, return relative path to self.srcdir.
         """
-        if suffix:
-            warnings.warn('The suffix argument for doc2path() is deprecated.',
-                          RemovedInSphinx40Warning)
-        if base not in (True, False, None):
-            warnings.warn('The string style base argument for doc2path() is deprecated.',
-                          RemovedInSphinx40Warning)
-
-        pathname = self.project.doc2path(docname, base is True)
-        if suffix:
-            filename, _ = path.splitext(pathname)
-            pathname = filename + suffix
-        if base and base is not True:
-            pathname = path.join(base, pathname)  # type: ignore
-        return pathname
+        return self.project.doc2path(docname, base)
 
     def relfn2path(self, filename: str, docname: str = None) -> Tuple[str, str]:
         """Return paths to a file referenced from a document, relative to
@@ -639,19 +622,3 @@ def check_consistency(self) -> None:
         for domain in self.domains.values():
             domain.check_consistency()
         self.events.emit('env-check-consistency', self)
-
-    @property
-    def indexentries(self) -> Dict[str, List[Tuple[str, str, str, str, str]]]:
-        warnings.warn('env.indexentries() is deprecated. Please use IndexDomain instead.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        from sphinx.domains.index import IndexDomain
-        domain = cast(IndexDomain, self.get_domain('index'))
-        return domain.entries
-
-    @indexentries.setter
-    def indexentries(self, entries: Dict[str, List[Tuple[str, str, str, str, str]]]) -> None:
-        warnings.warn('env.indexentries() is deprecated. Please use IndexDomain instead.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        from sphinx.domains.index import IndexDomain
-        domain = cast(IndexDomain, self.get_domain('index'))
-        domain.data['entries'] = entries
diff --git a/sphinx/environment/collectors/indexentries.py b/sphinx/environment/collectors/indexentries.py
deleted file mode 100644
index 2ef59909bc2..00000000000
--- a/sphinx/environment/collectors/indexentries.py
+++ /dev/null
@@ -1,64 +0,0 @@
-"""
-    sphinx.environment.collectors.indexentries
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Index entries collector for sphinx.environment.
-
-    :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import Any, Dict, Set
-
-from docutils import nodes
-
-from sphinx import addnodes
-from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx40Warning
-from sphinx.environment import BuildEnvironment
-from sphinx.environment.collectors import EnvironmentCollector
-from sphinx.util import split_index_msg, logging
-
-
-logger = logging.getLogger(__name__)
-
-
-class IndexEntriesCollector(EnvironmentCollector):
-    name = 'indices'
-
-    def __init__(self) -> None:
-        warnings.warn('IndexEntriesCollector is deprecated.',
-                      RemovedInSphinx40Warning)
-
-    def clear_doc(self, app: Sphinx, env: BuildEnvironment, docname: str) -> None:
-        env.indexentries.pop(docname, None)
-
-    def merge_other(self, app: Sphinx, env: BuildEnvironment,
-                    docnames: Set[str], other: BuildEnvironment) -> None:
-        for docname in docnames:
-            env.indexentries[docname] = other.indexentries[docname]
-
-    def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
-        docname = app.env.docname
-        entries = app.env.indexentries[docname] = []
-        for node in doctree.traverse(addnodes.index):
-            try:
-                for entry in node['entries']:
-                    split_index_msg(entry[0], entry[1])
-            except ValueError as exc:
-                logger.warning(str(exc), location=node)
-                node.parent.remove(node)
-            else:
-                for entry in node['entries']:
-                    entries.append(entry)
-
-
-def setup(app: Sphinx) -> Dict[str, Any]:
-    app.add_env_collector(IndexEntriesCollector)
-
-    return {
-        'version': 'builtin',
-        'parallel_read_safe': True,
-        'parallel_write_safe': True,
-    }
diff --git a/sphinx/events.py b/sphinx/events.py
index 46759eccd96..4673fddd8cf 100644
--- a/sphinx/events.py
+++ b/sphinx/events.py
@@ -10,13 +10,11 @@
     :license: BSD, see LICENSE for details.
 """
 
-import warnings
 from collections import defaultdict
 from operator import attrgetter
 from typing import Any, Callable, Dict, List, NamedTuple
 from typing import TYPE_CHECKING
 
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.errors import ExtensionError
 from sphinx.locale import __
 from sphinx.util import logging
@@ -56,10 +54,7 @@
 class EventManager:
     """Event manager for Sphinx."""
 
-    def __init__(self, app: "Sphinx" = None) -> None:
-        if app is None:
-            warnings.warn('app argument is required for EventManager.',
-                          RemovedInSphinx40Warning)
+    def __init__(self, app: "Sphinx") -> None:
         self.app = app
         self.events = core_events.copy()
         self.listeners = defaultdict(list)  # type: Dict[str, List[EventListener]]
@@ -100,11 +95,7 @@ def emit(self, name: str, *args: Any) -> List:
         results = []
         listeners = sorted(self.listeners[name], key=attrgetter("priority"))
         for listener in listeners:
-            if self.app is None:
-                # for compatibility; RemovedInSphinx40Warning
-                results.append(listener.handler(*args))
-            else:
-                results.append(listener.handler(self.app, *args))
+            results.append(listener.handler(self.app, *args))
         return results
 
     def emit_firstresult(self, name: str, *args: Any) -> Any:
diff --git a/sphinx/ext/apidoc.py b/sphinx/ext/apidoc.py
index 23be0a00aa1..8e3fbd7d065 100644
--- a/sphinx/ext/apidoc.py
+++ b/sphinx/ext/apidoc.py
@@ -19,7 +19,6 @@
 import locale
 import os
 import sys
-import warnings
 from copy import copy
 from fnmatch import fnmatch
 from importlib.machinery import EXTENSION_SUFFIXES
@@ -29,9 +28,7 @@
 import sphinx.locale
 from sphinx import __display_version__, package_dir
 from sphinx.cmd.quickstart import EXTENSIONS
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.locale import __
-from sphinx.util import rst
 from sphinx.util.osutil import FileAvoidWrite, ensuredir
 from sphinx.util.template import ReSTRenderer
 
@@ -51,20 +48,6 @@
 template_dir = path.join(package_dir, 'templates', 'apidoc')
 
 
-def makename(package: str, module: str) -> str:
-    """Join package and module with a dot."""
-    warnings.warn('makename() is deprecated.',
-                  RemovedInSphinx40Warning)
-    # Both package and module can be None/empty.
-    if package:
-        name = package
-        if module:
-            name += '.' + module
-    else:
-        name = module
-    return name
-
-
 def is_initpy(filename: str) -> bool:
     """Check *filename* is __init__ file or not."""
     basename = path.basename(filename)
@@ -109,26 +92,6 @@ def write_file(name: str, text: str, opts: Any) -> None:
             f.write(text)
 
 
-def format_heading(level: int, text: str, escape: bool = True) -> str:
-    """Create a heading of <level> [1, 2 or 3 supported]."""
-    warnings.warn('format_warning() is deprecated.',
-                  RemovedInSphinx40Warning)
-    if escape:
-        text = rst.escape(text)
-    underlining = ['=', '-', '~', ][level - 1] * len(text)
-    return '%s\n%s\n\n' % (text, underlining)
-
-
-def format_directive(module: str, package: str = None) -> str:
-    """Create the automodule directive and add the options."""
-    warnings.warn('format_directive() is deprecated.',
-                  RemovedInSphinx40Warning)
-    directive = '.. automodule:: %s\n' % module_join(package, module)
-    for option in OPTIONS:
-        directive += '    :%s:\n' % option
-    return directive
-
-
 def create_module_file(package: str, basename: str, opts: Any,
                        user_template_dir: str = None) -> None:
     """Build the text of the file and write the file."""
@@ -206,33 +169,6 @@ def create_modules_toc_file(modules: List[str], opts: Any, name: str = 'modules'
     write_file(name, text, opts)
 
 
-def shall_skip(module: str, opts: Any, excludes: List[str] = []) -> bool:
-    """Check if we want to skip this module."""
-    warnings.warn('shall_skip() is deprecated.',
-                  RemovedInSphinx40Warning)
-    # skip if the file doesn't exist and not using implicit namespaces
-    if not opts.implicit_namespaces and not path.exists(module):
-        return True
-
-    # Are we a package (here defined as __init__.py, not the folder in itself)
-    if is_initpy(module):
-        # Yes, check if we have any non-excluded modules at all here
-        all_skipped = True
-        basemodule = path.dirname(module)
-        for submodule in glob.glob(path.join(basemodule, '*.py')):
-            if not is_excluded(path.join(basemodule, submodule), excludes):
-                # There's a non-excluded module here, we won't skip
-                all_skipped = False
-        if all_skipped:
-            return True
-
-    # skip if it has a "private" name and this is selected
-    filename = path.basename(module)
-    if is_initpy(filename) and filename.startswith('_') and not opts.includeprivate:
-        return True
-    return False
-
-
 def is_skipped_package(dirname: str, opts: Any, excludes: List[str] = []) -> bool:
     """Check if we want to skip this module."""
     if not path.isdir(dirname):
@@ -516,13 +452,6 @@ def main(argv: List[str] = sys.argv[1:]) -> int:
     return 0
 
 
-deprecated_alias('sphinx.ext.apidoc',
-                 {
-                     'INITPY': '__init__.py',
-                 },
-                 RemovedInSphinx40Warning)
-
-
 # So program can be started with "python -m sphinx.apidoc ..."
 if __name__ == "__main__":
     main()
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 490a1f689ff..af6399310e4 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -24,7 +24,7 @@
 import sphinx
 from sphinx.application import Sphinx
 from sphinx.config import ENUM
-from sphinx.deprecation import RemovedInSphinx40Warning, RemovedInSphinx50Warning
+from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.environment import BuildEnvironment
 from sphinx.ext.autodoc.importer import import_object, get_module_members, get_object_members
 from sphinx.ext.autodoc.mock import mock
@@ -428,12 +428,8 @@ def add_directive_header(self, sig: str) -> None:
             # etc. don't support a prepended module name
             self.add_line('   :module: %s' % self.modname, sourcename)
 
-    def get_doc(self, encoding: str = None, ignore: int = 1) -> List[List[str]]:
+    def get_doc(self, ignore: int = 1) -> List[List[str]]:
         """Decode and return lines of the docstring(s) for the object."""
-        if encoding is not None:
-            warnings.warn("The 'encoding' argument to autodoc.%s.get_doc() is deprecated."
-                          % self.__class__.__name__,
-                          RemovedInSphinx40Warning)
         docstring = getdoc(self.object, self.get_attr,
                            self.env.config.autodoc_inherit_docstrings)
         if docstring:
@@ -939,11 +935,7 @@ class DocstringSignatureMixin:
     feature of reading the signature from the docstring.
     """
 
-    def _find_signature(self, encoding: str = None) -> Tuple[str, str]:
-        if encoding is not None:
-            warnings.warn("The 'encoding' argument to autodoc.%s._find_signature() is "
-                          "deprecated." % self.__class__.__name__,
-                          RemovedInSphinx40Warning)
+    def _find_signature(self) -> Tuple[str, str]:
         docstrings = self.get_doc()
         self._new_docstrings = docstrings[:]
         result = None
@@ -973,15 +965,11 @@ def _find_signature(self, encoding: str = None) -> Tuple[str, str]:
             break
         return result
 
-    def get_doc(self, encoding: str = None, ignore: int = 1) -> List[List[str]]:
-        if encoding is not None:
-            warnings.warn("The 'encoding' argument to autodoc.%s.get_doc() is deprecated."
-                          % self.__class__.__name__,
-                          RemovedInSphinx40Warning)
+    def get_doc(self, ignore: int = 1) -> List[List[str]]:
         lines = getattr(self, '_new_docstrings', None)
         if lines is not None:
             return lines
-        return super().get_doc(None, ignore)  # type: ignore
+        return super().get_doc(ignore)  # type: ignore
 
     def format_signature(self, **kwargs: Any) -> str:
         if self.args is None and self.env.config.autodoc_docstring_signature:  # type: ignore
@@ -1228,11 +1216,7 @@ def add_directive_header(self, sig: str) -> None:
                 self.add_line('   ' + _('Bases: %s') % ', '.join(bases),
                               sourcename)
 
-    def get_doc(self, encoding: str = None, ignore: int = 1) -> List[List[str]]:
-        if encoding is not None:
-            warnings.warn("The 'encoding' argument to autodoc.%s.get_doc() is deprecated."
-                          % self.__class__.__name__,
-                          RemovedInSphinx40Warning)
+    def get_doc(self, ignore: int = 1) -> List[List[str]]:
         lines = getattr(self, '_new_docstrings', None)
         if lines is not None:
             return lines
@@ -1721,7 +1705,7 @@ def import_object(self) -> Any:
                 self.env.note_reread()
                 return False
 
-    def get_doc(self, encoding: str = None, ignore: int = 1) -> List[List[str]]:
+    def get_doc(self, ignore: int = 1) -> List[List[str]]:
         """Decode and return lines of the docstring(s) for the object."""
         name = self.objpath[-1]
         __slots__ = safe_getattr(self.parent, '__slots__', [])
diff --git a/sphinx/ext/autodoc/directive.py b/sphinx/ext/autodoc/directive.py
index c12d451be4f..5543059cb7d 100644
--- a/sphinx/ext/autodoc/directive.py
+++ b/sphinx/ext/autodoc/directive.py
@@ -6,17 +6,15 @@
     :license: BSD, see LICENSE for details.
 """
 
-import warnings
 from typing import Any, Callable, Dict, List, Set, Type
 
 from docutils import nodes
 from docutils.nodes import Element, Node
-from docutils.parsers.rst.states import RSTState, Struct
+from docutils.parsers.rst.states import RSTState
 from docutils.statemachine import StringList
 from docutils.utils import Reporter, assemble_option_dict
 
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.environment import BuildEnvironment
 from sphinx.ext.autodoc import Documenter, Options
 from sphinx.util import logging
@@ -49,23 +47,14 @@ class DocumenterBridge:
     """A parameters container for Documenters."""
 
     def __init__(self, env: BuildEnvironment, reporter: Reporter, options: Options,
-                 lineno: int, state: Any = None) -> None:
+                 lineno: int, state: Any) -> None:
         self.env = env
         self.reporter = reporter
         self.genopt = options
         self.lineno = lineno
         self.filename_set = set()  # type: Set[str]
         self.result = StringList()
-
-        if state:
-            self.state = state
-        else:
-            # create fake object for self.state.document.settings.tab_width
-            warnings.warn('DocumenterBridge requires a state object on instantiation.',
-                          RemovedInSphinx40Warning)
-            settings = Struct(tab_width=8)
-            document = Struct(settings=settings)
-            self.state = Struct(document=document)
+        self.state = state
 
     def warn(self, msg: str) -> None:
         logger.warning(msg, location=(self.env.docname, self.lineno))
diff --git a/sphinx/ext/autodoc/importer.py b/sphinx/ext/autodoc/importer.py
index a7d68d8faca..67106b77aaf 100644
--- a/sphinx/ext/autodoc/importer.py
+++ b/sphinx/ext/autodoc/importer.py
@@ -13,7 +13,6 @@
 import warnings
 from typing import Any, Callable, Dict, List, Mapping, NamedTuple, Tuple
 
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.util import logging
 from sphinx.util.inspect import isclass, isenumclass, safe_getattr
 
@@ -179,18 +178,3 @@ def get_object_members(subject: Any, objpath: List[str], attrgetter: Callable,
                 members[name] = Attribute(name, True, INSTANCEATTR)
 
     return members
-
-
-from sphinx.ext.autodoc.mock import (  # NOQA
-    _MockModule, _MockObject, MockFinder, MockLoader, mock
-)
-
-deprecated_alias('sphinx.ext.autodoc.importer',
-                 {
-                     '_MockModule': _MockModule,
-                     '_MockObject': _MockObject,
-                     'MockFinder': MockFinder,
-                     'MockLoader': MockLoader,
-                     'mock': mock,
-                 },
-                 RemovedInSphinx40Warning)
diff --git a/sphinx/ext/autosummary/__init__.py b/sphinx/ext/autosummary/__init__.py
index 539d72057e9..861b1e6b078 100644
--- a/sphinx/ext/autosummary/__init__.py
+++ b/sphinx/ext/autosummary/__init__.py
@@ -66,13 +66,13 @@
 from docutils import nodes
 from docutils.nodes import Element, Node, system_message
 from docutils.parsers.rst import directives
-from docutils.parsers.rst.states import Inliner, RSTStateMachine, Struct, state_classes
+from docutils.parsers.rst.states import RSTStateMachine, Struct, state_classes
 from docutils.statemachine import StringList
 
 import sphinx
 from sphinx import addnodes
 from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx40Warning, RemovedInSphinx50Warning
+from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.environment import BuildEnvironment
 from sphinx.environment.adapters.toctree import TocTree
 from sphinx.ext.autodoc import Documenter
@@ -404,29 +404,6 @@ def append_row(*column_texts: str) -> None:
 
         return [table_spec, table]
 
-    def warn(self, msg: str) -> None:
-        warnings.warn('Autosummary.warn() is deprecated',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        logger.warning(msg)
-
-    @property
-    def genopt(self) -> Options:
-        warnings.warn('Autosummary.genopt is deprecated',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return self.bridge.genopt
-
-    @property
-    def warnings(self) -> List[Node]:
-        warnings.warn('Autosummary.warnings is deprecated',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return []
-
-    @property
-    def result(self) -> StringList:
-        warnings.warn('Autosummary.result is deprecated',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return self.bridge.result
-
 
 def strip_arg_typehint(s: str) -> str:
     """Strip a type hint from argument definition."""
@@ -647,33 +624,6 @@ def _import_by_name(name: str) -> Tuple[Any, Any, str]:
 
 # -- :autolink: (smart default role) -------------------------------------------
 
-def autolink_role(typ: str, rawtext: str, etext: str, lineno: int, inliner: Inliner,
-                  options: Dict = {}, content: List[str] = []
-                  ) -> Tuple[List[Node], List[system_message]]:
-    """Smart linking role.
-
-    Expands to ':obj:`text`' if `text` is an object that can be imported;
-    otherwise expands to '*text*'.
-    """
-    warnings.warn('autolink_role() is deprecated.', RemovedInSphinx40Warning)
-    env = inliner.document.settings.env
-    pyobj_role = env.get_domain('py').role('obj')
-    objects, msg = pyobj_role('obj', rawtext, etext, lineno, inliner, options, content)
-    if msg != []:
-        return objects, msg
-
-    assert len(objects) == 1
-    pending_xref = cast(addnodes.pending_xref, objects[0])
-    prefixes = get_import_prefixes_from_env(env)
-    try:
-        name, obj, parent, modname = import_by_name(pending_xref['reftarget'], prefixes)
-    except ImportError:
-        literal = cast(nodes.literal, pending_xref[0])
-        objects[0] = nodes.emphasis(rawtext, literal.astext(), classes=literal['classes'])
-
-    return objects, msg
-
-
 class AutoLink(SphinxRole):
     """Smart linking role.
 
diff --git a/sphinx/ext/autosummary/generate.py b/sphinx/ext/autosummary/generate.py
index acc2a288393..d046a54a79b 100644
--- a/sphinx/ext/autosummary/generate.py
+++ b/sphinx/ext/autosummary/generate.py
@@ -27,7 +27,7 @@
 import warnings
 from gettext import NullTranslations
 from os import path
-from typing import Any, Callable, Dict, List, NamedTuple, Set, Tuple, Type, Union
+from typing import Any, Dict, List, NamedTuple, Set, Tuple, Type, Union
 
 from jinja2 import TemplateNotFound
 from jinja2.sandbox import SandboxedEnvironment
@@ -38,7 +38,7 @@
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx40Warning, RemovedInSphinx50Warning
+from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.ext.autodoc import Documenter
 from sphinx.ext.autosummary import import_by_name, get_documenter
 from sphinx.locale import __
@@ -268,25 +268,10 @@ def get_modules(obj: Any) -> Tuple[List[str], List[str]]:
 
 
 def generate_autosummary_docs(sources: List[str], output_dir: str = None,
-                              suffix: str = '.rst', warn: Callable = None,
-                              info: Callable = None, base_path: str = None,
+                              suffix: str = '.rst', base_path: str = None,
                               builder: Builder = None, template_dir: str = None,
                               imported_members: bool = False, app: Any = None,
                               overwrite: bool = True) -> None:
-    if info:
-        warnings.warn('info argument for generate_autosummary_docs() is deprecated.',
-                      RemovedInSphinx40Warning)
-        _info = info
-    else:
-        _info = logger.info
-
-    if warn:
-        warnings.warn('warn argument for generate_autosummary_docs() is deprecated.',
-                      RemovedInSphinx40Warning)
-        _warn = warn
-    else:
-        _warn = logger.warning
-
     if builder:
         warnings.warn('builder argument for generate_autosummary_docs() is deprecated.',
                       RemovedInSphinx50Warning)
@@ -298,11 +283,11 @@ def generate_autosummary_docs(sources: List[str], output_dir: str = None,
     showed_sources = list(sorted(sources))
     if len(showed_sources) > 20:
         showed_sources = showed_sources[:10] + ['...'] + showed_sources[-10:]
-    _info(__('[autosummary] generating autosummary for: %s') %
-          ', '.join(showed_sources))
+    logger.info(__('[autosummary] generating autosummary for: %s') %
+                ', '.join(showed_sources))
 
     if output_dir:
-        _info(__('[autosummary] writing to %s') % output_dir)
+        logger.info(__('[autosummary] writing to %s') % output_dir)
 
     if base_path is not None:
         sources = [os.path.join(base_path, filename) for filename in sources]
@@ -328,7 +313,7 @@ def generate_autosummary_docs(sources: List[str], output_dir: str = None,
         try:
             name, obj, parent, mod_name = import_by_name(entry.name)
         except ImportError as e:
-            _warn(__('[autosummary] failed to import %r: %s') % (entry.name, e))
+            logger.warning(__('[autosummary] failed to import %r: %s') % (entry.name, e))
             continue
 
         context = {}
@@ -357,8 +342,8 @@ def generate_autosummary_docs(sources: List[str], output_dir: str = None,
     # descend recursively to new files
     if new_files:
         generate_autosummary_docs(new_files, output_dir=output_dir,
-                                  suffix=suffix, warn=warn, info=info,
-                                  base_path=base_path,
+                                  suffix=suffix, base_path=base_path,
+                                  builder=builder, template_dir=template_dir,
                                   imported_members=imported_members, app=app,
                                   overwrite=overwrite)
 
diff --git a/sphinx/ext/doctest.py b/sphinx/ext/doctest.py
index 687bd6e0adb..48ebcd34ef4 100644
--- a/sphinx/ext/doctest.py
+++ b/sphinx/ext/doctest.py
@@ -13,7 +13,6 @@
 import re
 import sys
 import time
-import warnings
 from io import StringIO
 from os import path
 from typing import Any, Callable, Dict, Iterable, List, Sequence, Set, Tuple, Type
@@ -27,7 +26,6 @@
 
 import sphinx
 from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.locale import __
 from sphinx.util import logging
 from sphinx.util.console import bold  # type: ignore
@@ -44,12 +42,6 @@
 doctestopt_re = re.compile(r'#\s*doctest:.+$', re.MULTILINE)
 
 
-def doctest_encode(text: str, encoding: str) -> str:
-    warnings.warn('doctest_encode() is deprecated.',
-                  RemovedInSphinx40Warning)
-    return text
-
-
 def is_allowed_version(spec: str, version: str) -> bool:
     """Check `spec` satisfies `version` or not.
 
diff --git a/sphinx/ext/imgmath.py b/sphinx/ext/imgmath.py
index 911445a54a0..90271a6ee8f 100644
--- a/sphinx/ext/imgmath.py
+++ b/sphinx/ext/imgmath.py
@@ -27,7 +27,6 @@
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.errors import SphinxError
 from sphinx.locale import _, __
 from sphinx.util import logging
@@ -59,33 +58,6 @@ class InvokeError(SphinxError):
 
 SUPPORT_FORMAT = ('png', 'svg')
 
-DOC_HEAD = r'''
-\documentclass[12pt]{article}
-\usepackage[utf8x]{inputenc}
-\usepackage{amsmath}
-\usepackage{amsthm}
-\usepackage{amssymb}
-\usepackage{amsfonts}
-\usepackage{anyfontsize}
-\usepackage{bm}
-\pagestyle{empty}
-'''
-
-DOC_BODY = r'''
-\begin{document}
-\fontsize{%d}{%d}\selectfont %s
-\end{document}
-'''
-
-DOC_BODY_PREVIEW = r'''
-\usepackage[active]{preview}
-\begin{document}
-\begin{preview}
-\fontsize{%s}{%s}\selectfont %s
-\end{preview}
-\end{document}
-'''
-
 depth_re = re.compile(r'\[\d+ depth=(-?\d+)\]')
 depthsvg_re = re.compile(r'.*, depth=(.*)pt')
 depthsvgcomment_re = re.compile(r'<!-- DEPTH=(-?\d+) -->')
@@ -371,15 +343,6 @@ def html_visit_displaymath(self: HTMLTranslator, node: nodes.math_block) -> None
     raise nodes.SkipNode
 
 
-deprecated_alias('sphinx.ext.imgmath',
-                 {
-                     'DOC_BODY': DOC_BODY,
-                     'DOC_BODY_PREVIEW': DOC_BODY_PREVIEW,
-                     'DOC_HEAD': DOC_HEAD,
-                 },
-                 RemovedInSphinx40Warning)
-
-
 def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_html_math_renderer('imgmath',
                                (html_visit_math, None),
diff --git a/sphinx/ext/jsmath.py b/sphinx/ext/jsmath.py
deleted file mode 100644
index 75369a5ca62..00000000000
--- a/sphinx/ext/jsmath.py
+++ /dev/null
@@ -1,36 +0,0 @@
-"""
-    sphinx.ext.jsmath
-    ~~~~~~~~~~~~~~~~~
-
-    Set up everything for use of JSMath to display math in HTML
-    via JavaScript.
-
-    :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import Any, Dict
-
-from sphinxcontrib.jsmath import (  # NOQA
-    html_visit_math,
-    html_visit_displaymath,
-    install_jsmath,
-)
-
-import sphinx
-from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx40Warning
-
-
-def setup(app: Sphinx) -> Dict[str, Any]:
-    warnings.warn('sphinx.ext.jsmath has been moved to sphinxcontrib-jsmath.',
-                  RemovedInSphinx40Warning)
-
-    app.setup_extension('sphinxcontrib.jsmath')
-
-    return {
-        'version': sphinx.__display_version__,
-        'parallel_read_safe': True,
-        'parallel_write_safe': True,
-    }
diff --git a/sphinx/ext/todo.py b/sphinx/ext/todo.py
index c5cacc43751..44b6acabcf8 100644
--- a/sphinx/ext/todo.py
+++ b/sphinx/ext/todo.py
@@ -11,8 +11,7 @@
     :license: BSD, see LICENSE for details.
 """
 
-import warnings
-from typing import Any, Dict, Iterable, List, Tuple
+from typing import Any, Dict, List, Tuple
 from typing import cast
 
 from docutils import nodes
@@ -22,14 +21,12 @@
 
 import sphinx
 from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.domains import Domain
 from sphinx.environment import BuildEnvironment
 from sphinx.errors import NoUri
 from sphinx.locale import _, __
 from sphinx.util import logging, texescape
 from sphinx.util.docutils import SphinxDirective, new_document
-from sphinx.util.nodes import make_refnode
 from sphinx.writers.html import HTMLTranslator
 from sphinx.writers.latex import LaTeXTranslator
 
@@ -104,33 +101,6 @@ def process_doc(self, env: BuildEnvironment, docname: str,
                                location=todo)
 
 
-def process_todos(app: Sphinx, doctree: nodes.document) -> None:
-    warnings.warn('process_todos() is deprecated.', RemovedInSphinx40Warning)
-    # collect all todos in the environment
-    # this is not done in the directive itself because it some transformations
-    # must have already been run, e.g. substitutions
-    env = app.builder.env
-    if not hasattr(env, 'todo_all_todos'):
-        env.todo_all_todos = []  # type: ignore
-    for node in doctree.traverse(todo_node):
-        app.events.emit('todo-defined', node)
-
-        newnode = node.deepcopy()
-        newnode['ids'] = []
-        env.todo_all_todos.append({  # type: ignore
-            'docname': env.docname,
-            'source': node.source or env.doc2path(env.docname),
-            'lineno': node.line,
-            'todo': newnode,
-            'target': node['ids'][0],
-        })
-
-        if env.config.todo_emit_warnings:
-            label = cast(nodes.Element, node[1])
-            logger.warning(__("TODO entry found: %s"), label.astext(),
-                           location=node)
-
-
 class TodoList(SphinxDirective):
     """
     A list of all todo entries.
@@ -217,79 +187,6 @@ def create_todo_reference(self, todo: todo_node, docname: str) -> nodes.paragrap
         return para
 
 
-def process_todo_nodes(app: Sphinx, doctree: nodes.document, fromdocname: str) -> None:
-    """Replace all todolist nodes with a list of the collected todos.
-    Augment each todo with a backlink to the original location.
-    """
-    warnings.warn('process_todo_nodes() is deprecated.', RemovedInSphinx40Warning)
-
-    domain = cast(TodoDomain, app.env.get_domain('todo'))
-    todos = sum(domain.todos.values(), [])  # type: List[todo_node]
-
-    for node in doctree.traverse(todolist):
-        if node.get('ids'):
-            content = [nodes.target()]  # type: List[Element]
-        else:
-            content = []
-
-        if not app.config['todo_include_todos']:
-            node.replace_self(content)
-            continue
-
-        for todo_info in todos:
-            para = nodes.paragraph(classes=['todo-source'])
-            if app.config['todo_link_only']:
-                description = _('<<original entry>>')
-            else:
-                description = (
-                    _('(The <<original entry>> is located in %s, line %d.)') %
-                    (todo_info.source, todo_info.line)
-                )
-            desc1 = description[:description.find('<<')]
-            desc2 = description[description.find('>>') + 2:]
-            para += nodes.Text(desc1, desc1)
-
-            # Create a reference
-            innernode = nodes.emphasis(_('original entry'), _('original entry'))
-            try:
-                para += make_refnode(app.builder, fromdocname, todo_info['docname'],
-                                     todo_info['ids'][0], innernode)
-            except NoUri:
-                # ignore if no URI can be determined, e.g. for LaTeX output
-                pass
-            para += nodes.Text(desc2, desc2)
-
-            todo_entry = todo_info.deepcopy()
-            todo_entry['ids'].clear()
-
-            # (Recursively) resolve references in the todo content
-            app.env.resolve_references(todo_entry, todo_info['docname'], app.builder)  # type: ignore  # NOQA
-
-            # Insert into the todolist
-            content.append(todo_entry)
-            content.append(para)
-
-        node.replace_self(content)
-
-
-def purge_todos(app: Sphinx, env: BuildEnvironment, docname: str) -> None:
-    warnings.warn('purge_todos() is deprecated.', RemovedInSphinx40Warning)
-    if not hasattr(env, 'todo_all_todos'):
-        return
-    env.todo_all_todos = [todo for todo in env.todo_all_todos  # type: ignore
-                          if todo['docname'] != docname]
-
-
-def merge_info(app: Sphinx, env: BuildEnvironment, docnames: Iterable[str],
-               other: BuildEnvironment) -> None:
-    warnings.warn('merge_info() is deprecated.', RemovedInSphinx40Warning)
-    if not hasattr(other, 'todo_all_todos'):
-        return
-    if not hasattr(env, 'todo_all_todos'):
-        env.todo_all_todos = []  # type: ignore
-    env.todo_all_todos.extend(other.todo_all_todos)  # type: ignore
-
-
 def visit_todo_node(self: HTMLTranslator, node: todo_node) -> None:
     if self.config.todo_include_todos:
         self.visit_admonition(node)
diff --git a/sphinx/io.py b/sphinx/io.py
index fc3544cb673..3469fcc3df9 100644
--- a/sphinx/io.py
+++ b/sphinx/io.py
@@ -8,7 +8,6 @@
     :license: BSD, see LICENSE for details.
 """
 import codecs
-import warnings
 from typing import Any, List, Type
 from typing import TYPE_CHECKING
 
@@ -23,9 +22,7 @@
 from docutils.transforms.references import DanglingReferences
 from docutils.writers import UnfilteredWriter
 
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.environment import BuildEnvironment
-from sphinx.errors import FiletypeNotFoundError
 from sphinx.transforms import (
     AutoIndexUpgrader, DoctreeReadEvent, FigureAligner, SphinxTransformer
 )
@@ -63,18 +60,6 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
         super().__init__(*args, **kwargs)
 
-    @property
-    def app(self) -> "Sphinx":
-        warnings.warn('SphinxBaseReader.app is deprecated.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return self._app
-
-    @property
-    def env(self) -> BuildEnvironment:
-        warnings.warn('SphinxBaseReader.env is deprecated.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return self._env
-
     def setup(self, app: "Sphinx") -> None:
         self._app = app      # hold application object only for compatibility
         self._env = app.env
@@ -219,11 +204,3 @@ def read_doc(app: "Sphinx", env: BuildEnvironment, filename: str) -> nodes.docum
 
     pub.publish()
     return pub.document
-
-
-deprecated_alias('sphinx.io',
-                 {
-                     'FiletypeNotFoundError': FiletypeNotFoundError,
-                     'get_filetype': get_filetype,
-                 },
-                 RemovedInSphinx40Warning)
diff --git a/sphinx/pycode/__init__.py b/sphinx/pycode/__init__.py
index 55d5d2c1d05..3f6ecaf2bb8 100644
--- a/sphinx/pycode/__init__.py
+++ b/sphinx/pycode/__init__.py
@@ -10,14 +10,12 @@
 
 import re
 import tokenize
-import warnings
 from importlib import import_module
 from io import StringIO
 from os import path
 from typing import Any, Dict, IO, List, Tuple, Optional
 from zipfile import ZipFile
 
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.errors import PycodeError
 from sphinx.pycode.parser import Parser
 
@@ -77,7 +75,7 @@ def get_module_source(modname: str) -> Tuple[Optional[str], Optional[str]]:
     @classmethod
     def for_string(cls, string: str, modname: str, srcname: str = '<string>'
                    ) -> "ModuleAnalyzer":
-        return cls(StringIO(string), modname, srcname, decoded=True)
+        return cls(StringIO(string), modname, srcname)
 
     @classmethod
     def for_file(cls, filename: str, modname: str) -> "ModuleAnalyzer":
@@ -85,7 +83,7 @@ def for_file(cls, filename: str, modname: str) -> "ModuleAnalyzer":
             return cls.cache['file', filename]
         try:
             with tokenize.open(filename) as f:
-                obj = cls(f, modname, filename, decoded=True)
+                obj = cls(f, modname, filename)
                 cls.cache['file', filename] = obj
         except Exception as err:
             if '.egg' + path.sep in filename:
@@ -125,21 +123,12 @@ def for_module(cls, modname: str) -> "ModuleAnalyzer":
         cls.cache['module', modname] = obj
         return obj
 
-    def __init__(self, source: IO, modname: str, srcname: str, decoded: bool = False) -> None:
+    def __init__(self, source: IO, modname: str, srcname: str) -> None:
         self.modname = modname  # name of the module
         self.srcname = srcname  # name of the source file
 
         # cache the source code as well
-        pos = source.tell()
-        if not decoded:
-            warnings.warn('decode option for ModuleAnalyzer is deprecated.',
-                          RemovedInSphinx40Warning)
-            self._encoding, _ = tokenize.detect_encoding(source.readline)
-            source.seek(pos)
-            self.code = source.read().decode(self._encoding)
-        else:
-            self._encoding = None
-            self.code = source.read()
+        self.code = source.read()
 
         # will be filled by parse()
         self.annotations = None  # type: Dict[Tuple[str, str], str]
@@ -150,7 +139,7 @@ def __init__(self, source: IO, modname: str, srcname: str, decoded: bool = False
     def parse(self) -> None:
         """Parse the source code."""
         try:
-            parser = Parser(self.code, self._encoding)
+            parser = Parser(self.code)
             parser.parse()
 
             self.attr_docs = {}
@@ -179,9 +168,3 @@ def find_tags(self) -> Dict[str, Tuple[str, int, int]]:
             self.parse()
 
         return self.tags
-
-    @property
-    def encoding(self) -> str:
-        warnings.warn('ModuleAnalyzer.encoding is deprecated.',
-                      RemovedInSphinx40Warning)
-        return self._encoding
diff --git a/sphinx/roles.py b/sphinx/roles.py
index 922f2e02c1a..7bb7ac5e297 100644
--- a/sphinx/roles.py
+++ b/sphinx/roles.py
@@ -9,22 +9,16 @@
 """
 
 import re
-import warnings
 from typing import Any, Dict, List, Tuple, Type
 from typing import TYPE_CHECKING
 
 from docutils import nodes, utils
 from docutils.nodes import Element, Node, TextElement, system_message
-from docutils.parsers.rst.states import Inliner
 
 from sphinx import addnodes
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.locale import _
 from sphinx.util import ws_re
 from sphinx.util.docutils import ReferenceRole, SphinxRole
-from sphinx.util.nodes import (
-    split_explicit_title, process_index_entry, set_role_source_info
-)
 from sphinx.util.typing import RoleFunction
 
 if TYPE_CHECKING:
@@ -88,22 +82,6 @@ def __init__(self, fix_parens: bool = False, lowercase: bool = False,
 
         super().__init__()
 
-    def _fix_parens(self, env: "BuildEnvironment", has_explicit_title: bool, title: str,
-                    target: str) -> Tuple[str, str]:
-        warnings.warn('XRefRole._fix_parens() is deprecated.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        if not has_explicit_title:
-            if title.endswith('()'):
-                # remove parentheses
-                title = title[:-2]
-            if env.config.add_function_parentheses:
-                # add them back to all occurrences if configured
-                title += '()'
-        # remove parentheses from the target too
-        if target.endswith('()'):
-            target = target[:-2]
-        return title, target
-
     def update_title_and_target(self, title: str, target: str) -> Tuple[str, str]:
         if not self.has_explicit_title:
             if title.endswith('()'):
@@ -194,75 +172,6 @@ def process_link(self, env: "BuildEnvironment", refnode: Element, has_explicit_t
         return result
 
 
-def indexmarkup_role(typ: str, rawtext: str, text: str, lineno: int, inliner: Inliner,
-                     options: Dict = {}, content: List[str] = []
-                     ) -> Tuple[List[Node], List[system_message]]:
-    """Role for PEP/RFC references that generate an index entry."""
-    warnings.warn('indexmarkup_role() is deprecated.  Please use PEP or RFC class instead.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    env = inliner.document.settings.env
-    if not typ:
-        assert env.temp_data['default_role']
-        typ = env.temp_data['default_role'].lower()
-    else:
-        typ = typ.lower()
-
-    has_explicit_title, title, target = split_explicit_title(text)
-    title = utils.unescape(title)
-    target = utils.unescape(target)
-    targetid = 'index-%s' % env.new_serialno('index')
-    indexnode = addnodes.index()
-    targetnode = nodes.target('', '', ids=[targetid])
-    inliner.document.note_explicit_target(targetnode)
-    if typ == 'pep':
-        indexnode['entries'] = [
-            ('single', _('Python Enhancement Proposals; PEP %s') % target,
-             targetid, '', None)]
-        anchor = ''
-        anchorindex = target.find('#')
-        if anchorindex > 0:
-            target, anchor = target[:anchorindex], target[anchorindex:]
-        if not has_explicit_title:
-            title = "PEP " + utils.unescape(title)
-        try:
-            pepnum = int(target)
-        except ValueError:
-            msg = inliner.reporter.error('invalid PEP number %s' % target,
-                                         line=lineno)
-            prb = inliner.problematic(rawtext, rawtext, msg)
-            return [prb], [msg]
-        ref = inliner.document.settings.pep_base_url + 'pep-%04d' % pepnum
-        sn = nodes.strong(title, title)
-        rn = nodes.reference('', '', internal=False, refuri=ref + anchor,
-                             classes=[typ])
-        rn += sn
-        return [indexnode, targetnode, rn], []
-    elif typ == 'rfc':
-        indexnode['entries'] = [
-            ('single', 'RFC; RFC %s' % target, targetid, '', None)]
-        anchor = ''
-        anchorindex = target.find('#')
-        if anchorindex > 0:
-            target, anchor = target[:anchorindex], target[anchorindex:]
-        if not has_explicit_title:
-            title = "RFC " + utils.unescape(title)
-        try:
-            rfcnum = int(target)
-        except ValueError:
-            msg = inliner.reporter.error('invalid RFC number %s' % target,
-                                         line=lineno)
-            prb = inliner.problematic(rawtext, rawtext, msg)
-            return [prb], [msg]
-        ref = inliner.document.settings.rfc_base_url + inliner.rfc_url % rfcnum
-        sn = nodes.strong(title, title)
-        rn = nodes.reference('', '', internal=False, refuri=ref + anchor,
-                             classes=[typ])
-        rn += sn
-        return [indexnode, targetnode, rn], []
-    else:
-        raise ValueError('unknown role type: %s' % typ)
-
-
 class PEP(ReferenceRole):
     def run(self) -> Tuple[List[Node], List[system_message]]:
         target_id = 'index-%s' % self.env.new_serialno('index')
@@ -335,44 +244,6 @@ def build_uri(self) -> str:
 _amp_re = re.compile(r'(?<!&)&(?![&\s])')
 
 
-def menusel_role(typ: str, rawtext: str, text: str, lineno: int, inliner: Inliner,
-                 options: Dict = {}, content: List[str] = []
-                 ) -> Tuple[List[Node], List[system_message]]:
-    warnings.warn('menusel_role() is deprecated. '
-                  'Please use MenuSelection or GUILabel class instead.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    env = inliner.document.settings.env
-    if not typ:
-        assert env.temp_data['default_role']
-        typ = env.temp_data['default_role'].lower()
-    else:
-        typ = typ.lower()
-
-    text = utils.unescape(text)
-    if typ == 'menuselection':
-        text = text.replace('-->', '\N{TRIANGULAR BULLET}')
-    spans = _amp_re.split(text)
-
-    node = nodes.inline(rawtext=rawtext)
-    for i, span in enumerate(spans):
-        span = span.replace('&&', '&')
-        if i == 0:
-            if len(span) > 0:
-                textnode = nodes.Text(span)
-                node += textnode
-            continue
-        accel_node = nodes.inline()
-        letter_node = nodes.Text(span[0])
-        accel_node += letter_node
-        accel_node['classes'].append('accelerator')
-        node += accel_node
-        textnode = nodes.Text(span[1:])
-        node += textnode
-
-    node['classes'].append(typ)
-    return [node], []
-
-
 class GUILabel(SphinxRole):
     amp_re = re.compile(r'(?<!&)&(?![&\s])')
 
@@ -403,59 +274,6 @@ def run(self) -> Tuple[List[Node], List[system_message]]:
 parens_re = re.compile(r'(\\*{|\\*})')
 
 
-def emph_literal_role(typ: str, rawtext: str, text: str, lineno: int, inliner: Inliner,
-                      options: Dict = {}, content: List[str] = []
-                      ) -> Tuple[List[Node], List[system_message]]:
-    warnings.warn('emph_literal_role() is deprecated. '
-                  'Please use EmphasizedLiteral class instead.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    env = inliner.document.settings.env
-    if not typ:
-        assert env.temp_data['default_role']
-        typ = env.temp_data['default_role'].lower()
-    else:
-        typ = typ.lower()
-
-    retnode = nodes.literal(role=typ.lower(), classes=[typ])
-    parts = list(parens_re.split(utils.unescape(text)))
-    stack = ['']
-    for part in parts:
-        matched = parens_re.match(part)
-        if matched:
-            backslashes = len(part) - 1
-            if backslashes % 2 == 1:    # escaped
-                stack[-1] += "\\" * int((backslashes - 1) / 2) + part[-1]
-            elif part[-1] == '{':       # rparen
-                stack[-1] += "\\" * int(backslashes / 2)
-                if len(stack) >= 2 and stack[-2] == "{":
-                    # nested
-                    stack[-1] += "{"
-                else:
-                    # start emphasis
-                    stack.append('{')
-                    stack.append('')
-            else:                       # lparen
-                stack[-1] += "\\" * int(backslashes / 2)
-                if len(stack) == 3 and stack[1] == "{" and len(stack[2]) > 0:
-                    # emphasized word found
-                    if stack[0]:
-                        retnode += nodes.Text(stack[0], stack[0])
-                    retnode += nodes.emphasis(stack[2], stack[2])
-                    stack = ['']
-                else:
-                    # emphasized word not found; the rparen is not a special symbol
-                    stack.append('}')
-                    stack = [''.join(stack)]
-        else:
-            stack[-1] += part
-    if ''.join(stack):
-        # remaining is treated as Text
-        text = ''.join(stack)
-        retnode += nodes.Text(text, text)
-
-    return [retnode], []
-
-
 class EmphasizedLiteral(SphinxRole):
     parens_re = re.compile(r'(\\\\|\\{|\\}|{|})')
 
@@ -509,22 +327,6 @@ def parse(self, text: str) -> List[Node]:
 _abbr_re = re.compile(r'\((.*)\)$', re.S)
 
 
-def abbr_role(typ: str, rawtext: str, text: str, lineno: int, inliner: Inliner,
-              options: Dict = {}, content: List[str] = []
-              ) -> Tuple[List[Node], List[system_message]]:
-    warnings.warn('abbr_role() is deprecated.  Please use Abbrevation class instead.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    text = utils.unescape(text)
-    m = _abbr_re.search(text)
-    if m is None:
-        return [nodes.abbreviation(text, text, **options)], []
-    abbr = text[:m.start()].strip()
-    expl = m.group(1)
-    options = options.copy()
-    options['explanation'] = expl
-    return [nodes.abbreviation(abbr, abbr, **options)], []
-
-
 class Abbreviation(SphinxRole):
     abbr_re = re.compile(r'\((.*)\)$', re.S)
 
@@ -539,62 +341,6 @@ def run(self) -> Tuple[List[Node], List[system_message]]:
         return [nodes.abbreviation(self.rawtext, text, **self.options)], []
 
 
-def index_role(typ: str, rawtext: str, text: str, lineno: int, inliner: Inliner,
-               options: Dict = {}, content: List[str] = []
-               ) -> Tuple[List[Node], List[system_message]]:
-    warnings.warn('index_role() is deprecated.  Please use Index class instead.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    # create new reference target
-    env = inliner.document.settings.env
-    targetid = 'index-%s' % env.new_serialno('index')
-    targetnode = nodes.target('', '', ids=[targetid])
-    # split text and target in role content
-    has_explicit_title, title, target = split_explicit_title(text)
-    title = utils.unescape(title)
-    target = utils.unescape(target)
-    # if an explicit target is given, we can process it as a full entry
-    if has_explicit_title:
-        entries = process_index_entry(target, targetid)
-    # otherwise we just create a "single" entry
-    else:
-        # but allow giving main entry
-        main = ''
-        if target.startswith('!'):
-            target = target[1:]
-            title = title[1:]
-            main = 'main'
-        entries = [('single', target, targetid, main, None)]
-    indexnode = addnodes.index()
-    indexnode['entries'] = entries
-    set_role_source_info(inliner, lineno, indexnode)
-    textnode = nodes.Text(title, title)
-    return [indexnode, targetnode, textnode], []
-
-
-class Index(ReferenceRole):
-    def run(self) -> Tuple[List[Node], List[system_message]]:
-        warnings.warn('Index role is deprecated.', RemovedInSphinx40Warning)
-        target_id = 'index-%s' % self.env.new_serialno('index')
-        if self.has_explicit_title:
-            # if an explicit target is given, process it as a full entry
-            title = self.title
-            entries = process_index_entry(self.target, target_id)
-        else:
-            # otherwise we just create a single entry
-            if self.target.startswith('!'):
-                title = self.title[1:]
-                entries = [('single', self.target[1:], target_id, 'main', None)]
-            else:
-                title = self.title
-                entries = [('single', self.target, target_id, '', None)]
-
-        index = addnodes.index(entries=entries)
-        target = nodes.target('', '', ids=[target_id])
-        text = nodes.Text(title, title)
-        self.set_source_info(index)
-        return [index, target, text], []
-
-
 specific_docroles = {
     # links to download references
     'download': XRefRole(nodeclass=addnodes.download_reference),
diff --git a/sphinx/search/__init__.py b/sphinx/search/__init__.py
index 25a80481625..68850a5571b 100644
--- a/sphinx/search/__init__.py
+++ b/sphinx/search/__init__.py
@@ -20,7 +20,6 @@
 
 from sphinx import addnodes
 from sphinx import package_dir
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.environment import BuildEnvironment
 from sphinx.search.jssplitter import splitter_code
 from sphinx.util import jsdump, rpartition
@@ -196,11 +195,7 @@ def __init__(self, document: nodes.document, lang: SearchLanguage) -> None:
         self.found_title_words = []     # type: List[str]
         self.lang = lang
 
-    def is_meta_keywords(self, node: addnodes.meta, nodetype: Any = None) -> bool:
-        if nodetype is not None:
-            warnings.warn('"nodetype" argument for WordCollector.is_meta_keywords() '
-                          'is deprecated.', RemovedInSphinx40Warning)
-
+    def is_meta_keywords(self, node: addnodes.meta) -> bool:
         if isinstance(node, addnodes.meta) and node.get('name') == 'keywords':
             meta_lang = node.get('lang')
             if meta_lang is None:  # lang not specified
diff --git a/sphinx/testing/fixtures.py b/sphinx/testing/fixtures.py
index a864e19d16e..0b20e6990ef 100644
--- a/sphinx/testing/fixtures.py
+++ b/sphinx/testing/fixtures.py
@@ -8,7 +8,6 @@
     :license: BSD, see LICENSE for details.
 """
 
-import os
 import subprocess
 import sys
 from collections import namedtuple
@@ -221,10 +220,7 @@ def sphinx_test_tempdir(tmpdir_factory: Any) -> "util.path":
     """
     temporary directory that wrapped with `path` class.
     """
-    tmpdir = os.environ.get('SPHINX_TEST_TEMPDIR')  # RemovedInSphinx40Warning
-    if tmpdir is None:
-        tmpdir = tmpdir_factory.getbasetemp()
-
+    tmpdir = tmpdir_factory.getbasetemp()
     return util.path(tmpdir).abspath()
 
 
diff --git a/sphinx/testing/util.py b/sphinx/testing/util.py
index 450241f5513..6c0e2213973 100644
--- a/sphinx/testing/util.py
+++ b/sphinx/testing/util.py
@@ -21,16 +21,13 @@
 
 from sphinx import application, locale
 from sphinx.builders.latex import LaTeXBuilder
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.pycode import ModuleAnalyzer
 from sphinx.testing.path import path
 from sphinx.util.osutil import relpath
 
 
 __all__ = [
-    'Struct',
-    'SphinxTestApp', 'SphinxTestAppWrapperForSkipBuilding',
-    'remove_unicode_literals',
+    'Struct', 'SphinxTestApp', 'SphinxTestAppWrapperForSkipBuilding',
 ]
 
 
@@ -179,12 +176,6 @@ def build(self, *args: Any, **kwargs: Any) -> None:
 _unicode_literals_re = re.compile(r'u(".*?")|u(\'.*?\')')
 
 
-def remove_unicode_literals(s: str) -> str:
-    warnings.warn('remove_unicode_literals() is deprecated.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    return _unicode_literals_re.sub(lambda x: x.group(1) or x.group(2), s)
-
-
 def find_files(root: str, suffix: bool = None) -> Generator[str, None, None]:
     for dirpath, dirs, files in os.walk(root, followlinks=True):
         dirpath = path(dirpath)
diff --git a/sphinx/transforms/__init__.py b/sphinx/transforms/__init__.py
index 2185b3de1e4..1e9abced1fd 100644
--- a/sphinx/transforms/__init__.py
+++ b/sphinx/transforms/__init__.py
@@ -22,7 +22,6 @@
 
 from sphinx import addnodes
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.locale import _, __
 from sphinx.util import logging
 from sphinx.util.docutils import new_document
@@ -394,18 +393,6 @@ def apply(self, **kwargs: Any) -> None:
             node.attributes.update(info)
 
 
-from sphinx.domains.citation import (  # NOQA
-    CitationDefinitionTransform, CitationReferenceTransform
-)
-
-deprecated_alias('sphinx.transforms',
-                 {
-                     'CitationReferences': CitationReferenceTransform,
-                     'SmartQuotesSkipper': CitationDefinitionTransform,
-                 },
-                 RemovedInSphinx40Warning)
-
-
 def setup(app: "Sphinx") -> Dict[str, Any]:
     app.add_transform(ApplySourceWorkaround)
     app.add_transform(ExtraTranslatableNodes)
diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index 8e1d4df84f2..9a188775941 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -8,7 +8,6 @@
     :license: BSD, see LICENSE for details.
 """
 
-import fnmatch
 import functools
 import os
 import posixpath
@@ -17,9 +16,6 @@
 import tempfile
 import traceback
 import unicodedata
-import warnings
-from codecs import BOM_UTF8
-from collections import deque
 from datetime import datetime
 from hashlib import md5
 from importlib import import_module
@@ -29,10 +25,7 @@
 from typing import TYPE_CHECKING
 from urllib.parse import urlsplit, urlunsplit, quote_plus, parse_qsl, urlencode
 
-from sphinx.deprecation import RemovedInSphinx40Warning
-from sphinx.errors import (
-    PycodeError, SphinxParallelError, ExtensionError, FiletypeNotFoundError
-)
+from sphinx.errors import SphinxParallelError, ExtensionError, FiletypeNotFoundError
 from sphinx.locale import __
 from sphinx.util import logging
 from sphinx.util.console import strip_colors, colorize, bold, term_width_line  # type: ignore
@@ -42,7 +35,7 @@
 # import other utilities; partly for backwards compatibility, so don't
 # prune unused ones indiscriminately
 from sphinx.util.osutil import (  # noqa
-    SEP, os_path, relative_uri, ensuredir, walk, mtimes_of_files, movefile,
+    SEP, os_path, relative_uri, ensuredir, mtimes_of_files, movefile,
     copyfile, copytimes, make_filename)
 from sphinx.util.nodes import (   # noqa
     nested_parse_with_titles, split_explicit_title, explicit_title_re,
@@ -101,23 +94,6 @@ def get_matching_files(dirname: str,
             yield filename
 
 
-def get_matching_docs(dirname: str, suffixes: List[str],
-                      exclude_matchers: Tuple[PathMatcher, ...] = ()) -> Iterable[str]:
-    """Get all file names (without suffixes) matching a suffix in a directory,
-    recursively.
-
-    Exclude files and dirs matching a pattern in *exclude_patterns*.
-    """
-    warnings.warn('get_matching_docs() is now deprecated. Use get_matching_files() instead.',
-                  RemovedInSphinx40Warning)
-    suffixpatterns = ['*' + s for s in suffixes]
-    for filename in get_matching_files(dirname, exclude_matchers):
-        for suffixpattern in suffixpatterns:
-            if fnmatch.fnmatch(filename, suffixpattern):
-                yield filename[:-len(suffixpattern) + 1]
-                break
-
-
 def get_filetype(source_suffix: Dict[str, str], filename: str) -> str:
     for suffix, filetype in source_suffix.items():
         if filename.endswith(suffix):
@@ -243,53 +219,6 @@ def save_traceback(app: "Sphinx") -> str:
     return path
 
 
-def get_module_source(modname: str) -> Tuple[str, str]:
-    """Try to find the source code for a module.
-
-    Can return ('file', 'filename') in which case the source is in the given
-    file, or ('string', 'source') which which case the source is the string.
-    """
-    warnings.warn('get_module_source() is deprecated.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    try:
-        mod = import_module(modname)
-    except Exception as err:
-        raise PycodeError('error importing %r' % modname, err)
-    filename = getattr(mod, '__file__', None)
-    loader = getattr(mod, '__loader__', None)
-    if loader and getattr(loader, 'get_filename', None):
-        try:
-            filename = loader.get_filename(modname)
-        except Exception as err:
-            raise PycodeError('error getting filename for %r' % filename, err)
-    if filename is None and loader:
-        try:
-            filename = loader.get_source(modname)
-            if filename:
-                return 'string', filename
-        except Exception as err:
-            raise PycodeError('error getting source for %r' % modname, err)
-    if filename is None:
-        raise PycodeError('no source found for module %r' % modname)
-    filename = path.normpath(path.abspath(filename))
-    lfilename = filename.lower()
-    if lfilename.endswith('.pyo') or lfilename.endswith('.pyc'):
-        filename = filename[:-1]
-        if not path.isfile(filename) and path.isfile(filename + 'w'):
-            filename += 'w'
-    elif not (lfilename.endswith('.py') or lfilename.endswith('.pyw')):
-        raise PycodeError('source is not a .py file: %r' % filename)
-    elif ('.egg' + os.path.sep) in filename:
-        pat = '(?<=\\.egg)' + re.escape(os.path.sep)
-        eggpath, _ = re.split(pat, filename, 1)
-        if path.isfile(eggpath):
-            return 'file', filename
-
-    if not path.isfile(filename):
-        raise PycodeError('source file is not present: %r' % filename)
-    return 'file', filename
-
-
 def get_full_modname(modname: str, attribute: str) -> str:
     if modname is None:
         # Prevents a TypeError: if the last getattr() call will return None
@@ -311,58 +240,6 @@ def get_full_modname(modname: str, attribute: str) -> str:
 _coding_re = re.compile(r'coding[:=]\s*([-\w.]+)')
 
 
-def detect_encoding(readline: Callable[[], bytes]) -> str:
-    """Like tokenize.detect_encoding() from Py3k, but a bit simplified."""
-    warnings.warn('sphinx.util.detect_encoding() is deprecated',
-                  RemovedInSphinx40Warning)
-
-    def read_or_stop() -> bytes:
-        try:
-            return readline()
-        except StopIteration:
-            return None
-
-    def get_normal_name(orig_enc: str) -> str:
-        """Imitates get_normal_name in tokenizer.c."""
-        # Only care about the first 12 characters.
-        enc = orig_enc[:12].lower().replace('_', '-')
-        if enc == 'utf-8' or enc.startswith('utf-8-'):
-            return 'utf-8'
-        if enc in ('latin-1', 'iso-8859-1', 'iso-latin-1') or \
-           enc.startswith(('latin-1-', 'iso-8859-1-', 'iso-latin-1-')):
-            return 'iso-8859-1'
-        return orig_enc
-
-    def find_cookie(line: bytes) -> str:
-        try:
-            line_string = line.decode('ascii')
-        except UnicodeDecodeError:
-            return None
-
-        matches = _coding_re.findall(line_string)
-        if not matches:
-            return None
-        return get_normal_name(matches[0])
-
-    default = sys.getdefaultencoding()
-    first = read_or_stop()
-    if first and first.startswith(BOM_UTF8):
-        first = first[3:]
-        default = 'utf-8-sig'
-    if not first:
-        return default
-    encoding = find_cookie(first)
-    if encoding:
-        return encoding
-    second = read_or_stop()
-    if not second:
-        return default
-    encoding = find_cookie(second)
-    if encoding:
-        return encoding
-    return default
-
-
 class UnicodeDecodeErrorHandler:
     """Custom error handler for open() that warns and replaces."""
 
@@ -431,39 +308,6 @@ def parselinenos(spec: str, total: int) -> List[int]:
     return items
 
 
-def force_decode(string: str, encoding: str) -> str:
-    """Forcibly get a unicode string out of a bytestring."""
-    warnings.warn('force_decode() is deprecated.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    if isinstance(string, bytes):
-        try:
-            if encoding:
-                string = string.decode(encoding)
-            else:
-                # try decoding with utf-8, should only work for real UTF-8
-                string = string.decode()
-        except UnicodeError:
-            # last resort -- can't fail
-            string = string.decode('latin1')
-    return string
-
-
-class attrdict(dict):
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        super().__init__(*args, **kwargs)
-        warnings.warn('The attrdict class is deprecated.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-
-    def __getattr__(self, key: str) -> str:
-        return self[key]
-
-    def __setattr__(self, key: str, val: str) -> None:
-        self[key] = val
-
-    def __delattr__(self, key: str) -> None:
-        del self[key]
-
-
 def rpartition(s: str, t: str) -> Tuple[str, str]:
     """Similar to str.rpartition from 2.5, but doesn't return the separator."""
     i = s.rfind(t)
@@ -512,41 +356,6 @@ def format_exception_cut_frames(x: int = 1) -> str:
     return ''.join(res)
 
 
-class PeekableIterator:
-    """
-    An iterator which wraps any iterable and makes it possible to peek to see
-    what's the next item.
-    """
-    def __init__(self, iterable: Iterable) -> None:
-        self.remaining = deque()  # type: deque
-        self._iterator = iter(iterable)
-        warnings.warn('PeekableIterator is deprecated.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-
-    def __iter__(self) -> "PeekableIterator":
-        return self
-
-    def __next__(self) -> Any:
-        """Return the next item from the iterator."""
-        if self.remaining:
-            return self.remaining.popleft()
-        return next(self._iterator)
-
-    next = __next__  # Python 2 compatibility
-
-    def push(self, item: Any) -> None:
-        """Push the `item` on the internal stack, it will be returned on the
-        next :meth:`next` call.
-        """
-        self.remaining.append(item)
-
-    def peek(self) -> Any:
-        """Return the next item without changing the state of the iterator."""
-        item = next(self)
-        self.push(item)
-        return item
-
-
 def import_object(objname: str, source: str = None) -> Any:
     """Import python object by qualname."""
     try:
diff --git a/sphinx/util/cfamily.py b/sphinx/util/cfamily.py
index 790a492a5ee..4cef9a56397 100644
--- a/sphinx/util/cfamily.py
+++ b/sphinx/util/cfamily.py
@@ -9,7 +9,6 @@
 """
 
 import re
-import warnings
 from copy import deepcopy
 from typing import (
     Any, Callable, List, Match, Pattern, Tuple, Union
@@ -19,7 +18,6 @@
 from docutils.nodes import TextElement
 
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.util import logging
 
 logger = logging.getLogger(__name__)
@@ -75,12 +73,7 @@ def verify_description_mode(mode: str) -> None:
 
 class NoOldIdError(Exception):
     # Used to avoid implementing unneeded id generation for old id schemes.
-    @property
-    def description(self) -> str:
-        warnings.warn('%s.description is deprecated. '
-                      'Coerce the instance to a string instead.' % self.__class__.__name__,
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return str(self)
+    pass
 
 
 class ASTBaseBase:
@@ -201,21 +194,11 @@ def describe_signature(self, signode: TextElement) -> None:
 
 
 class UnsupportedMultiCharacterCharLiteral(Exception):
-    @property
-    def decoded(self) -> str:
-        warnings.warn('%s.decoded is deprecated. '
-                      'Coerce the instance to a string instead.' % self.__class__.__name__,
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return str(self)
+    pass
 
 
 class DefinitionError(Exception):
-    @property
-    def description(self) -> str:
-        warnings.warn('%s.description is deprecated. '
-                      'Coerce the instance to a string instead.' % self.__class__.__name__,
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return str(self)
+    pass
 
 
 class BaseParser:
diff --git a/sphinx/util/compat.py b/sphinx/util/compat.py
index 502edb5256c..2c38f668b8d 100644
--- a/sphinx/util/compat.py
+++ b/sphinx/util/compat.py
@@ -9,16 +9,9 @@
 """
 
 import sys
-import warnings
 from typing import Any, Dict
 from typing import TYPE_CHECKING
 
-from docutils.utils import get_source_line
-
-from sphinx import addnodes
-from sphinx.deprecation import RemovedInSphinx40Warning
-from sphinx.transforms import SphinxTransform
-
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
@@ -36,22 +29,7 @@ def register_application_for_autosummary(app: "Sphinx") -> None:
         autosummary._app = app
 
 
-class IndexEntriesMigrator(SphinxTransform):
-    """Migrating indexentries from old style (4columns) to new style (5columns)."""
-    default_priority = 700
-
-    def apply(self, **kwargs: Any) -> None:
-        for node in self.document.traverse(addnodes.index):
-            for i, entries in enumerate(node['entries']):
-                if len(entries) == 4:
-                    source, line = get_source_line(node)
-                    warnings.warn('An old styled index node found: %r at (%s:%s)' %
-                                  (node, source, line), RemovedInSphinx40Warning)
-                    node['entries'][i] = entries + (None,)
-
-
 def setup(app: "Sphinx") -> Dict[str, Any]:
-    app.add_transform(IndexEntriesMigrator)
     app.connect('builder-inited', register_application_for_autosummary)
 
     return {
diff --git a/sphinx/util/docfields.py b/sphinx/util/docfields.py
index 561271c4fec..cb11a799d19 100644
--- a/sphinx/util/docfields.py
+++ b/sphinx/util/docfields.py
@@ -9,7 +9,6 @@
     :license: BSD, see LICENSE for details.
 """
 
-import warnings
 from typing import Any, Dict, List, Tuple, Type, Union
 from typing import TYPE_CHECKING, cast
 
@@ -17,7 +16,6 @@
 from docutils.nodes import Node
 
 from sphinx import addnodes
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.util.typing import TextlikeNode
 
 if TYPE_CHECKING:
@@ -217,26 +215,7 @@ class DocFieldTransformer:
     def __init__(self, directive: "ObjectDescription") -> None:
         self.directive = directive
 
-        try:
-            self.typemap = directive.get_field_type_map()
-        except Exception:
-            # for 3rd party extensions directly calls this transformer.
-            warnings.warn('DocFieldTransformer expects given directive object is a subclass '
-                          'of ObjectDescription.', RemovedInSphinx40Warning)
-            self.typemap = self.preprocess_fieldtypes(directive.__class__.doc_field_types)
-
-    def preprocess_fieldtypes(self, types: List[Field]) -> Dict[str, Tuple[Field, bool]]:
-        warnings.warn('DocFieldTransformer.preprocess_fieldtypes() is deprecated.',
-                      RemovedInSphinx40Warning)
-        typemap = {}
-        for fieldtype in types:
-            for name in fieldtype.names:
-                typemap[name] = fieldtype, False
-            if fieldtype.is_typed:
-                typed_field = cast(TypedField, fieldtype)
-                for name in typed_field.typenames:
-                    typemap[name] = typed_field, True
-        return typemap
+        self.typemap = directive.get_field_type_map()
 
     def transform_all(self, node: addnodes.desc_content) -> None:
         """Transform all field list children of a node."""
diff --git a/sphinx/util/i18n.py b/sphinx/util/i18n.py
index f58b0faaf0a..398accf1a08 100644
--- a/sphinx/util/i18n.py
+++ b/sphinx/util/i18n.py
@@ -7,24 +7,21 @@
     :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
-import gettext
+
 import os
 import re
-import warnings
 from datetime import datetime, timezone
 from os import path
-from typing import Callable, Generator, List, NamedTuple, Set, Tuple
+from typing import Callable, Generator, List, NamedTuple, Tuple
 from typing import TYPE_CHECKING
 
 import babel.dates
 from babel.messages.mofile import write_mo
 from babel.messages.pofile import read_po
 
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.errors import SphinxError
 from sphinx.locale import __
 from sphinx.util import logging
-from sphinx.util.matching import Matcher
 from sphinx.util.osutil import SEP, canon_path, relpath
 
 if TYPE_CHECKING:
@@ -120,17 +117,6 @@ def catalogs(self) -> Generator[CatalogInfo, None, None]:
             yield CatalogInfo(basedir, domain, self.encoding)
 
 
-def find_catalog(docname: str, compaction: bool) -> str:
-    warnings.warn('find_catalog() is deprecated.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    if compaction:
-        ret = docname.split(SEP, 1)[0]
-    else:
-        ret = docname
-
-    return ret
-
-
 def docname_to_domain(docname: str, compation: bool) -> str:
     """Convert docname to domain for catalogs."""
     if compation:
@@ -139,69 +125,6 @@ def docname_to_domain(docname: str, compation: bool) -> str:
         return docname
 
 
-def find_catalog_files(docname: str, srcdir: str, locale_dirs: List[str],
-                       lang: str, compaction: bool) -> List[str]:
-    warnings.warn('find_catalog_files() is deprecated.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-    if not(lang and locale_dirs):
-        return []
-
-    domain = find_catalog(docname, compaction)
-    files = [gettext.find(domain, path.join(srcdir, dir_), [lang])
-             for dir_ in locale_dirs]
-    files = [relpath(f, srcdir) for f in files if f]
-    return files
-
-
-def find_catalog_source_files(locale_dirs: List[str], locale: str, domains: List[str] = None,
-                              charset: str = 'utf-8', force_all: bool = False,
-                              excluded: Matcher = Matcher([])) -> Set[CatalogInfo]:
-    """
-    :param list locale_dirs:
-       list of path as `['locale_dir1', 'locale_dir2', ...]` to find
-       translation catalogs. Each path contains a structure such as
-       `<locale>/LC_MESSAGES/domain.po`.
-    :param str locale: a language as `'en'`
-    :param list domains: list of domain names to get. If empty list or None
-       is specified, get all domain names. default is None.
-    :param boolean force_all:
-       Set True if you want to get all catalogs rather than updated catalogs.
-       default is False.
-    :return: [CatalogInfo(), ...]
-    """
-    warnings.warn('find_catalog_source_files() is deprecated.',
-                  RemovedInSphinx40Warning, stacklevel=2)
-
-    catalogs = set()  # type: Set[CatalogInfo]
-
-    if not locale:
-        return catalogs  # locale is not specified
-
-    for locale_dir in locale_dirs:
-        if not locale_dir:
-            continue  # skip system locale directory
-
-        base_dir = path.join(locale_dir, locale, 'LC_MESSAGES')
-
-        if not path.exists(base_dir):
-            continue  # locale path is not found
-
-        for dirpath, dirnames, filenames in os.walk(base_dir, followlinks=True):
-            filenames = [f for f in filenames if f.endswith('.po')]
-            for filename in filenames:
-                if excluded(path.join(relpath(dirpath, base_dir), filename)):
-                    continue
-                base = path.splitext(filename)[0]
-                domain = relpath(path.join(dirpath, base), base_dir).replace(path.sep, SEP)
-                if domains and domain not in domains:
-                    continue
-                cat = CatalogInfo(base_dir, domain, charset)
-                if force_all or cat.is_outdated():
-                    catalogs.add(cat)
-
-    return catalogs
-
-
 # date_format mappings: ustrftime() to bable.dates.format_datetime()
 date_format_mappings = {
     '%a':  'EEE',     # Weekday as locale’s abbreviated name.
diff --git a/sphinx/util/inspect.py b/sphinx/util/inspect.py
index 5a73774c7b6..17b19ae76b1 100644
--- a/sphinx/util/inspect.py
+++ b/sphinx/util/inspect.py
@@ -20,10 +20,10 @@
     Parameter, isclass, ismethod, ismethoddescriptor
 )
 from io import StringIO
-from typing import Any, Callable, Mapping, List, Optional, Tuple
+from typing import Any, Callable
 from typing import cast
 
-from sphinx.deprecation import RemovedInSphinx40Warning, RemovedInSphinx50Warning
+from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.pycode.ast import ast  # for py36-37
 from sphinx.pycode.ast import unparse as ast_unparse
 from sphinx.util import logging
@@ -323,23 +323,6 @@ def safe_getattr(obj: Any, name: str, *defargs: Any) -> Any:
         raise AttributeError(name)
 
 
-def safe_getmembers(object: Any, predicate: Callable[[str], bool] = None,
-                    attr_getter: Callable = safe_getattr) -> List[Tuple[str, Any]]:
-    """A version of inspect.getmembers() that uses safe_getattr()."""
-    warnings.warn('safe_getmembers() is deprecated', RemovedInSphinx40Warning)
-
-    results = []  # type: List[Tuple[str, Any]]
-    for key in dir(object):
-        try:
-            value = attr_getter(object, key, None)
-        except AttributeError:
-            continue
-        if not predicate or predicate(value):
-            results.append((key, value))
-    results.sort()
-    return results
-
-
 def object_description(object: Any) -> str:
     """A repr() implementation that returns text safe to use in reST context."""
     if isinstance(object, dict):
@@ -542,154 +525,6 @@ def signature_from_str(signature: str) -> inspect.Signature:
     return inspect.Signature(params, return_annotation=return_annotation)
 
 
-class Signature:
-    """The Signature object represents the call signature of a callable object and
-    its return annotation.
-    """
-
-    empty = inspect.Signature.empty
-
-    def __init__(self, subject: Callable, bound_method: bool = False,
-                 has_retval: bool = True) -> None:
-        warnings.warn('sphinx.util.inspect.Signature() is deprecated',
-                      RemovedInSphinx40Warning)
-
-        # check subject is not a built-in class (ex. int, str)
-        if (isinstance(subject, type) and
-                is_builtin_class_method(subject, "__new__") and
-                is_builtin_class_method(subject, "__init__")):
-            raise TypeError("can't compute signature for built-in type {}".format(subject))
-
-        self.subject = subject
-        self.has_retval = has_retval
-        self.partialmethod_with_noargs = False
-
-        try:
-            self.signature = inspect.signature(subject)  # type: Optional[inspect.Signature]
-        except IndexError:
-            # Until python 3.6.4, cpython has been crashed on inspection for
-            # partialmethods not having any arguments.
-            # https://bugs.python.org/issue33009
-            if hasattr(subject, '_partialmethod'):
-                self.signature = None
-                self.partialmethod_with_noargs = True
-            else:
-                raise
-
-        try:
-            self.annotations = typing.get_type_hints(subject)
-        except Exception:
-            # get_type_hints() does not support some kind of objects like partial,
-            # ForwardRef and so on.  For them, it raises an exception. In that case,
-            # we try to build annotations from argspec.
-            self.annotations = {}
-
-        if bound_method:
-            # client gives a hint that the subject is a bound method
-
-            if inspect.ismethod(subject):
-                # inspect.signature already considers the subject is bound method.
-                # So it is not need to skip first argument.
-                self.skip_first_argument = False
-            else:
-                self.skip_first_argument = True
-        else:
-            # inspect.signature recognizes type of method properly without any hints
-            self.skip_first_argument = False
-
-    @property
-    def parameters(self) -> Mapping:
-        if self.partialmethod_with_noargs:
-            return {}
-        else:
-            return self.signature.parameters
-
-    @property
-    def return_annotation(self) -> Any:
-        if self.signature:
-            if self.has_retval:
-                return self.signature.return_annotation
-            else:
-                return Parameter.empty
-        else:
-            return None
-
-    def format_args(self, show_annotation: bool = True) -> str:
-        def get_annotation(param: Parameter) -> Any:
-            if isinstance(param.annotation, str) and param.name in self.annotations:
-                return self.annotations[param.name]
-            else:
-                return param.annotation
-
-        args = []
-        last_kind = None
-        for i, param in enumerate(self.parameters.values()):
-            # skip first argument if subject is bound method
-            if self.skip_first_argument and i == 0:
-                continue
-
-            arg = StringIO()
-
-            # insert '*' between POSITIONAL args and KEYWORD_ONLY args::
-            #     func(a, b, *, c, d):
-            if param.kind == param.KEYWORD_ONLY and last_kind in (param.POSITIONAL_OR_KEYWORD,
-                                                                  param.POSITIONAL_ONLY,
-                                                                  None):
-                args.append('*')
-
-            if param.kind in (param.POSITIONAL_ONLY,
-                              param.POSITIONAL_OR_KEYWORD,
-                              param.KEYWORD_ONLY):
-                arg.write(param.name)
-                if show_annotation and param.annotation is not param.empty:
-                    arg.write(': ')
-                    arg.write(stringify_annotation(get_annotation(param)))
-                if param.default is not param.empty:
-                    if param.annotation is param.empty or show_annotation is False:
-                        arg.write('=')
-                        arg.write(object_description(param.default))
-                    else:
-                        arg.write(' = ')
-                        arg.write(object_description(param.default))
-            elif param.kind == param.VAR_POSITIONAL:
-                arg.write('*')
-                arg.write(param.name)
-                if show_annotation and param.annotation is not param.empty:
-                    arg.write(': ')
-                    arg.write(stringify_annotation(get_annotation(param)))
-            elif param.kind == param.VAR_KEYWORD:
-                arg.write('**')
-                arg.write(param.name)
-                if show_annotation and param.annotation is not param.empty:
-                    arg.write(': ')
-                    arg.write(stringify_annotation(get_annotation(param)))
-
-            args.append(arg.getvalue())
-            last_kind = param.kind
-
-        if self.return_annotation is Parameter.empty or show_annotation is False:
-            return '(%s)' % ', '.join(args)
-        else:
-            if 'return' in self.annotations:
-                annotation = stringify_annotation(self.annotations['return'])
-            else:
-                annotation = stringify_annotation(self.return_annotation)
-
-            return '(%s) -> %s' % (', '.join(args), annotation)
-
-    def format_annotation(self, annotation: Any) -> str:
-        """Return formatted representation of a type annotation."""
-        return stringify_annotation(annotation)
-
-    def format_annotation_new(self, annotation: Any) -> str:
-        """format_annotation() for py37+"""
-        return stringify_annotation(annotation)
-
-    def format_annotation_old(self, annotation: Any) -> str:
-        """format_annotation() for py36 or below"""
-        return stringify_annotation(annotation)
-
-
 def getdoc(obj: Any, attrgetter: Callable = safe_getattr,
            allow_inherited: bool = False) -> str:
     """Get the docstring for the object.
diff --git a/sphinx/util/jsonimpl.py b/sphinx/util/jsonimpl.py
deleted file mode 100644
index 35501f03a6c..00000000000
--- a/sphinx/util/jsonimpl.py
+++ /dev/null
@@ -1,46 +0,0 @@
-"""
-    sphinx.util.jsonimpl
-    ~~~~~~~~~~~~~~~~~~~~
-
-    JSON serializer implementation wrapper.
-
-    :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import json
-import warnings
-from collections import UserString
-from typing import Any, IO
-
-from sphinx.deprecation import RemovedInSphinx40Warning
-
-
-warnings.warn('sphinx.util.jsonimpl is deprecated',
-              RemovedInSphinx40Warning, stacklevel=2)
-
-
-class SphinxJSONEncoder(json.JSONEncoder):
-    """JSONEncoder subclass that forces translation proxies."""
-    def default(self, obj: Any) -> str:
-        if isinstance(obj, UserString):
-            return str(obj)
-        return super().default(obj)
-
-
-def dump(obj: Any, fp: IO, *args: Any, **kwargs: Any) -> None:
-    kwargs['cls'] = SphinxJSONEncoder
-    json.dump(obj, fp, *args, **kwargs)
-
-
-def dumps(obj: Any, *args: Any, **kwargs: Any) -> str:
-    kwargs['cls'] = SphinxJSONEncoder
-    return json.dumps(obj, *args, **kwargs)
-
-
-def load(*args: Any, **kwargs: Any) -> Any:
-    return json.load(*args, **kwargs)
-
-
-def loads(*args: Any, **kwargs: Any) -> Any:
-    return json.loads(*args, **kwargs)
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index 35594c087d6..1d92ce83699 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -10,7 +10,6 @@
 
 import re
 import unicodedata
-import warnings
 from typing import Any, Callable, Iterable, List, Set, Tuple, Type
 from typing import TYPE_CHECKING, cast
 
@@ -21,7 +20,6 @@
 from docutils.statemachine import StringList
 
 from sphinx import addnodes
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.locale import __
 from sphinx.util import logging
 
@@ -276,12 +274,6 @@ def extract_messages(doctree: Element) -> Iterable[Tuple[Element, str]]:
             yield node, msg
 
 
-def find_source_node(node: Element) -> str:
-    warnings.warn('find_source_node() is deprecated.',
-                  RemovedInSphinx40Warning)
-    return get_node_source(node)
-
-
 def get_node_source(node: Element) -> str:
     for pnode in traverse_parent(node):
         if pnode.source:
diff --git a/sphinx/util/osutil.py b/sphinx/util/osutil.py
index 6f432253551..e3c4ebedbbf 100644
--- a/sphinx/util/osutil.py
+++ b/sphinx/util/osutil.py
@@ -9,18 +9,14 @@
 """
 
 import contextlib
-import errno
 import filecmp
 import os
 import re
 import shutil
 import sys
-import warnings
 from io import StringIO
 from os import path
-from typing import Any, Generator, Iterator, List, Optional, Tuple, Type
-
-from sphinx.deprecation import RemovedInSphinx40Warning
+from typing import Any, Generator, Iterator, List, Optional, Type
 
 try:
     # for ALT Linux (#6712)
@@ -28,11 +24,6 @@
 except ImportError:
     Path = None  # type: ignore
 
-# Errnos that we need.
-EEXIST = getattr(errno, 'EEXIST', 0)  # RemovedInSphinx40Warning
-ENOENT = getattr(errno, 'ENOENT', 0)  # RemovedInSphinx40Warning
-EPIPE = getattr(errno, 'EPIPE', 0)    # RemovedInSphinx40Warning
-EINVAL = getattr(errno, 'EINVAL', 0)  # RemovedInSphinx40Warning
 
 # SEP separates path elements in the canonical file names
 #
@@ -79,13 +70,6 @@ def ensuredir(path: str) -> None:
     os.makedirs(path, exist_ok=True)
 
 
-def walk(top: str, topdown: bool = True, followlinks: bool = False) -> Iterator[Tuple[str, List[str], List[str]]]:  # NOQA
-    warnings.warn('sphinx.util.osutil.walk() is deprecated for removal. '
-                  'Please use os.walk() instead.',
-                  RemovedInSphinx40Warning)
-    return os.walk(top, topdown=topdown, followlinks=followlinks)
-
-
 def mtimes_of_files(dirnames: List[str], suffix: str) -> Iterator[float]:
     for dirname in dirnames:
         for root, dirs, files in os.walk(dirname):
@@ -171,13 +155,6 @@ def abspath(pathdir: str) -> str:
         return pathdir
 
 
-def getcwd() -> str:
-    warnings.warn('sphinx.util.osutil.getcwd() is deprecated. '
-                  'Please use os.getcwd() instead.',
-                  RemovedInSphinx40Warning)
-    return os.getcwd()
-
-
 @contextlib.contextmanager
 def cd(target_dir: str) -> Generator[None, None, None]:
     cwd = os.getcwd()
diff --git a/sphinx/util/pycompat.py b/sphinx/util/pycompat.py
index 88e9ac8d570..bcd90a71893 100644
--- a/sphinx/util/pycompat.py
+++ b/sphinx/util/pycompat.py
@@ -8,23 +8,10 @@
     :license: BSD, see LICENSE for details.
 """
 
-import html
-import io
-import sys
-import textwrap
 import warnings
 from typing import Any, Callable
 
-from sphinx.deprecation import (
-    RemovedInSphinx40Warning, RemovedInSphinx60Warning, deprecated_alias
-)
-from sphinx.locale import __
-from sphinx.util import logging
-from sphinx.util.console import terminal_safe
-from sphinx.util.typing import NoneType
-
-
-logger = logging.getLogger(__name__)
+from sphinx.deprecation import RemovedInSphinx60Warning
 
 
 # ------------------------------------------------------------------------------
@@ -51,18 +38,6 @@ def convert_with_2to3(filepath: str) -> str:
     return str(tree)
 
 
-class UnicodeMixin:
-    """Mixin class to handle defining the proper __str__/__unicode__
-    methods in Python 2 or 3.
-
-    .. deprecated:: 2.0
-    """
-    def __str__(self) -> str:
-        warnings.warn('UnicodeMixin is deprecated',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return self.__unicode__()  # type: ignore
-
-
 def execfile_(filepath: str, _globals: Any, open: Callable = open) -> None:
     warnings.warn('execfile_() is deprecated',
                   RemovedInSphinx60Warning, stacklevel=2)
@@ -72,30 +47,5 @@ def execfile_(filepath: str, _globals: Any, open: Callable = open) -> None:
 
     # compile to a code object, handle syntax errors
     filepath_enc = filepath.encode(fs_encoding)
-    try:
-        code = compile(source, filepath_enc, 'exec')
-    except SyntaxError:
-        # maybe the file uses 2.x syntax; try to refactor to
-        # 3.x syntax using 2to3
-        source = convert_with_2to3(filepath)
-        code = compile(source, filepath_enc, 'exec')
-        # TODO: When support for evaluating Python 2 syntax is removed,
-        # deprecate convert_with_2to3().
-        logger.warning(__('Support for evaluating Python 2 syntax is deprecated '
-                          'and will be removed in Sphinx 4.0. '
-                          'Convert %s to Python 3 syntax.'),
-                       filepath)
+    code = compile(source, filepath_enc, 'exec')
     exec(code, _globals)
-
-
-deprecated_alias('sphinx.util.pycompat',
-                 {
-                     'NoneType': NoneType,  # type: ignore
-                     'TextIOWrapper': io.TextIOWrapper,
-                     'htmlescape': html.escape,
-                     'indent': textwrap.indent,
-                     'terminal_safe': terminal_safe,
-                     'sys_encoding': sys.getdefaultencoding(),
-                     'u': '',
-                 },
-                 RemovedInSphinx40Warning)
diff --git a/sphinx/util/texescape.py b/sphinx/util/texescape.py
index afa1c349e92..0513704811d 100644
--- a/sphinx/util/texescape.py
+++ b/sphinx/util/texescape.py
@@ -11,8 +11,6 @@
 import re
 from typing import Dict
 
-from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
-
 
 tex_replacements = [
     # map TeX special chars
@@ -109,14 +107,6 @@
 _tex_hlescape_map_without_unicode = {}  # type: Dict[int, str]
 
 
-deprecated_alias('sphinx.util.texescape',
-                 {
-                     'tex_escape_map': _tex_escape_map,
-                     'tex_hl_escape_map_new': _tex_hlescape_map,
-                 },
-                 RemovedInSphinx40Warning)
-
-
 def escape(s: str, latex_engine: str = None) -> str:
     """Escape text for LaTeX output."""
     if latex_engine in ('lualatex', 'xelatex'):
diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py
index 07c4a59b86b..deed9891c1a 100644
--- a/sphinx/writers/html.py
+++ b/sphinx/writers/html.py
@@ -12,8 +12,7 @@
 import os
 import posixpath
 import re
-import warnings
-from typing import Any, Iterable, Tuple
+from typing import Iterable, Tuple
 from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
@@ -22,7 +21,6 @@
 
 from sphinx import addnodes
 from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.locale import admonitionlabels, _, __
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxTranslator
@@ -85,14 +83,7 @@ class HTMLTranslator(SphinxTranslator, BaseTranslator):
 
     builder = None  # type: StandaloneHTMLBuilder
 
-    def __init__(self, *args: Any) -> None:
-        if isinstance(args[0], nodes.document) and isinstance(args[1], Builder):
-            document, builder = args
-        else:
-            warnings.warn('The order of arguments for HTMLTranslator has been changed. '
-                          'Please give "document" as 1st and "builder" as 2nd.',
-                          RemovedInSphinx40Warning, stacklevel=2)
-            builder, document = args
+    def __init__(self, document: nodes.document, builder: Builder) -> None:
         super().__init__(document, builder)
 
         self.highlighter = self.builder.highlighter
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index 57b9f8eb9e6..9cbd50f6c07 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -12,7 +12,7 @@
 import posixpath
 import re
 import warnings
-from typing import Any, Iterable, Tuple
+from typing import Iterable, Tuple
 from typing import TYPE_CHECKING, cast
 
 from docutils import nodes
@@ -21,7 +21,7 @@
 
 from sphinx import addnodes
 from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx40Warning, RemovedInSphinx60Warning
+from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.locale import admonitionlabels, _, __
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxTranslator
@@ -57,14 +57,7 @@ class HTML5Translator(SphinxTranslator, BaseTranslator):
 
     builder = None  # type: StandaloneHTMLBuilder
 
-    def __init__(self, *args: Any) -> None:
-        if isinstance(args[0], nodes.document) and isinstance(args[1], Builder):
-            document, builder = args
-        else:
-            warnings.warn('The order of arguments for HTML5Translator has been changed. '
-                          'Please give "document" as 1st and "builder" as 2nd.',
-                          RemovedInSphinx40Warning, stacklevel=2)
-            builder, document = args
+    def __init__(self, document: nodes.document, builder: Builder) -> None:
         super().__init__(document, builder)
 
         self.highlighter = self.builder.highlighter
diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py
index e97271a187d..2dc1e2e8cb3 100644
--- a/sphinx/writers/latex.py
+++ b/sphinx/writers/latex.py
@@ -15,7 +15,7 @@
 import warnings
 from collections import defaultdict
 from os import path
-from typing import Any, Dict, Iterable, Iterator, List, Tuple, Set, Union
+from typing import Any, Dict, Iterable, List, Tuple, Set
 from typing import TYPE_CHECKING, cast
 
 from docutils import nodes, writers
@@ -23,9 +23,7 @@
 
 from sphinx import addnodes
 from sphinx import highlighting
-from sphinx.deprecation import (
-    RemovedInSphinx40Warning, RemovedInSphinx50Warning, deprecated_alias
-)
+from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.domains import IndexEntry
 from sphinx.domains.std import StandardDomain
 from sphinx.errors import SphinxError
@@ -2039,104 +2037,6 @@ def depart_math_reference(self, node: Element) -> None:
     def unknown_visit(self, node: Node) -> None:
         raise NotImplementedError('Unknown node: ' + node.__class__.__name__)
 
-    # --------- METHODS FOR COMPATIBILITY --------------------------------------
-
-    def collect_footnotes(self, node: Element) -> Dict[str, List[Union["collected_footnote", bool]]]:  # NOQA
-        def footnotes_under(n: Element) -> Iterator[nodes.footnote]:
-            if isinstance(n, nodes.footnote):
-                yield n
-            else:
-                for c in n.children:
-                    if isinstance(c, addnodes.start_of_file):
-                        continue
-                    elif isinstance(c, nodes.Element):
-                        yield from footnotes_under(c)
-
-        warnings.warn('LaTeXWriter.collected_footnote() is deprecated.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-
-        fnotes = {}  # type: Dict[str, List[Union[collected_footnote, bool]]]
-        for fn in footnotes_under(node):
-            label = cast(nodes.label, fn[0])
-            num = label.astext().strip()
-            newnode = collected_footnote('', *fn.children, number=num)
-            fnotes[num] = [newnode, False]
-        return fnotes
-
-    @property
-    def no_contractions(self) -> int:
-        warnings.warn('LaTeXTranslator.no_contractions is deprecated.',
-                      RemovedInSphinx40Warning, stacklevel=2)
-        return 0
-
-    def babel_defmacro(self, name: str, definition: str) -> str:
-        warnings.warn('babel_defmacro() is deprecated.',
-                      RemovedInSphinx40Warning)
-
-        if self.elements['babel']:
-            prefix = '\\addto\\extras%s{' % self.babel.get_language()
-            suffix = '}'
-        else:  # babel is disabled (mainly for Japanese environment)
-            prefix = ''
-            suffix = ''
-
-        return ('%s\\def%s{%s}%s\n' % (prefix, name, definition, suffix))
-
-    def generate_numfig_format(self, builder: "LaTeXBuilder") -> str:
-        warnings.warn('generate_numfig_format() is deprecated.',
-                      RemovedInSphinx40Warning)
-        ret = []  # type: List[str]
-        figure = self.builder.config.numfig_format['figure'].split('%s', 1)
-        if len(figure) == 1:
-            ret.append('\\def\\fnum@figure{%s}\n' % self.escape(figure[0]).strip())
-        else:
-            definition = escape_abbr(self.escape(figure[0]))
-            ret.append(self.babel_renewcommand('\\figurename', definition))
-            ret.append('\\makeatletter\n')
-            ret.append('\\def\\fnum@figure{\\figurename\\thefigure{}%s}\n' %
-                       self.escape(figure[1]))
-            ret.append('\\makeatother\n')
-
-        table = self.builder.config.numfig_format['table'].split('%s', 1)
-        if len(table) == 1:
-            ret.append('\\def\\fnum@table{%s}\n' % self.escape(table[0]).strip())
-        else:
-            definition = escape_abbr(self.escape(table[0]))
-            ret.append(self.babel_renewcommand('\\tablename', definition))
-            ret.append('\\makeatletter\n')
-            ret.append('\\def\\fnum@table{\\tablename\\thetable{}%s}\n' %
-                       self.escape(table[1]))
-            ret.append('\\makeatother\n')
-
-        codeblock = self.builder.config.numfig_format['code-block'].split('%s', 1)
-        if len(codeblock) == 1:
-            pass  # FIXME
-        else:
-            definition = self.escape(codeblock[0]).strip()
-            ret.append(self.babel_renewcommand('\\literalblockname', definition))
-            if codeblock[1]:
-                pass  # FIXME
-
-        return ''.join(ret)
-
-
-# Import old modules here for compatibility
-from sphinx.builders.latex import constants  # NOQA
-from sphinx.builders.latex.util import ExtBabel  # NOQA
-
-
-deprecated_alias('sphinx.writers.latex',
-                 {
-                     'ADDITIONAL_SETTINGS': constants.ADDITIONAL_SETTINGS,
-                     'DEFAULT_SETTINGS': constants.DEFAULT_SETTINGS,
-                     'LUALATEX_DEFAULT_FONTPKG': constants.LUALATEX_DEFAULT_FONTPKG,
-                     'PDFLATEX_DEFAULT_FONTPKG': constants.PDFLATEX_DEFAULT_FONTPKG,
-                     'SHORTHANDOFF': constants.SHORTHANDOFF,
-                     'XELATEX_DEFAULT_FONTPKG': constants.XELATEX_DEFAULT_FONTPKG,
-                     'XELATEX_GREEK_DEFAULT_FONTPKG': constants.XELATEX_GREEK_DEFAULT_FONTPKG,
-                     'ExtBabel': ExtBabel,
-                 },
-                 RemovedInSphinx40Warning)
 
 # FIXME: Workaround to avoid circular import
 # refs: https://github.com/sphinx-doc/sphinx/issues/5433
diff --git a/sphinx/writers/manpage.py b/sphinx/writers/manpage.py
index 7da2f4e8f04..2af96b530e1 100644
--- a/sphinx/writers/manpage.py
+++ b/sphinx/writers/manpage.py
@@ -8,7 +8,6 @@
     :license: BSD, see LICENSE for details.
 """
 
-import warnings
 from typing import Any, Dict, Iterable
 from typing import cast
 
@@ -21,7 +20,6 @@
 
 from sphinx import addnodes
 from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.locale import admonitionlabels, _
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxTranslator
@@ -81,14 +79,7 @@ class ManualPageTranslator(SphinxTranslator, BaseTranslator):
 
     _docinfo = {}  # type: Dict[str, Any]
 
-    def __init__(self, *args: Any) -> None:
-        if isinstance(args[0], nodes.document) and isinstance(args[1], Builder):
-            document, builder = args
-        else:
-            warnings.warn('The order of arguments for ManualPageTranslator has been changed. '
-                          'Please give "document" as 1st and "builder" as 2nd.',
-                          RemovedInSphinx40Warning, stacklevel=2)
-            builder, document = args
+    def __init__(self, document: nodes.document, builder: Builder) -> None:
         super().__init__(document, builder)
 
         self.in_productionlist = 0
diff --git a/tests/test_util_pycompat.py b/tests/test_util_pycompat.py
deleted file mode 100644
index 67e61bb5866..00000000000
--- a/tests/test_util_pycompat.py
+++ /dev/null
@@ -1,38 +0,0 @@
-"""
-    test_util_pycompat
-    ~~~~~~~~~~~~~~~~~~
-
-    Tests sphinx.util.pycompat functions.
-
-    :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from sphinx.testing.util import strip_escseq
-from sphinx.util import logging
-from sphinx.util.pycompat import execfile_
-
-
-def test_execfile_python2(capsys, app, status, warning, tempdir):
-    logging.setup(app, status, warning)
-
-    conf_py = tempdir / 'conf.py'
-    conf_py.write_bytes(b'print "hello"\n')
-    execfile_(conf_py, {})
-
-    msg = (
-        'Support for evaluating Python 2 syntax is deprecated '
-        'and will be removed in Sphinx 4.0. '
-        'Convert %s to Python 3 syntax.\n' % conf_py)
-    assert msg in strip_escseq(warning.getvalue())
-    captured = capsys.readouterr()
-    assert captured.out == 'hello\n'
-
-
-def test_execfile(capsys, tempdir):
-    conf_py = tempdir / 'conf.py'
-    conf_py.write_bytes(b'print("hello")\n')
-    execfile_(conf_py, {})
-
-    captured = capsys.readouterr()
-    assert captured.out == 'hello\n'

From b8e41aa15f29fb68c956ade63fb67f2f03c5f6d1 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 23 Apr 2020 22:21:39 +0900
Subject: [PATCH 019/305] refactor: Update type annotations

---
 sphinx/ext/autodoc/mock.py |  6 +++---
 sphinx/pycode/ast.py       | 11 +++++++++++
 sphinx/pycode/parser.py    |  5 ++++-
 sphinx/util/docutils.py    | 30 +++++++++++++++---------------
 4 files changed, 33 insertions(+), 19 deletions(-)

diff --git a/sphinx/ext/autodoc/mock.py b/sphinx/ext/autodoc/mock.py
index 98a3a3a96e5..f2ed8971293 100644
--- a/sphinx/ext/autodoc/mock.py
+++ b/sphinx/ext/autodoc/mock.py
@@ -14,7 +14,7 @@
 from importlib.abc import Loader, MetaPathFinder
 from importlib.machinery import ModuleSpec
 from types import FunctionType, MethodType, ModuleType
-from typing import Any, Generator, Iterator, List, Sequence, Tuple, Union
+from typing import Any, Generator, Iterator, List, Optional, Sequence, Tuple, Union
 
 from sphinx.util import logging
 
@@ -117,8 +117,8 @@ def __init__(self, modnames: List[str]) -> None:
         self.loader = MockLoader(self)
         self.mocked_modules = []  # type: List[str]
 
-    def find_spec(self, fullname: str, path: Sequence[Union[bytes, str]],
-                  target: ModuleType = None) -> ModuleSpec:
+    def find_spec(self, fullname: str, path: Optional[Sequence[Union[bytes, str]]],
+                  target: ModuleType = None) -> Optional[ModuleSpec]:
         for modname in self.modnames:
             # check if fullname is (or is a descendant of) one of our targets
             if modname == fullname or fullname.startswith(modname + '.'):
diff --git a/sphinx/pycode/ast.py b/sphinx/pycode/ast.py
index 9664e7edbd9..3f4717f45b2 100644
--- a/sphinx/pycode/ast.py
+++ b/sphinx/pycode/ast.py
@@ -10,6 +10,7 @@
 
 import sys
 from typing import Dict, List, Type, Optional
+from typing import overload
 
 if sys.version_info > (3, 8):
     import ast
@@ -58,6 +59,16 @@ def parse(code: str, mode: str = 'exec') -> "ast.AST":
         return ast.parse(code, mode=mode)
 
 
+@overload
+def unparse(node: None) -> None:
+    ...
+
+
+@overload
+def unparse(node: ast.AST) -> str:
+    ...
+
+
 def unparse(node: Optional[ast.AST]) -> Optional[str]:
     """Unparse an AST to string."""
     if node is None:
diff --git a/sphinx/pycode/parser.py b/sphinx/pycode/parser.py
index a776549394a..7eb2419c063 100644
--- a/sphinx/pycode/parser.py
+++ b/sphinx/pycode/parser.py
@@ -93,7 +93,10 @@ def dummy() -> None:
 
     dummy.__doc__ = s
     docstring = inspect.getdoc(dummy)
-    return docstring.lstrip("\r\n").rstrip("\r\n")
+    if docstring:
+        return docstring.lstrip("\r\n").rstrip("\r\n")
+    else:
+        return ""
 
 
 class Token:
diff --git a/sphinx/util/docutils.py b/sphinx/util/docutils.py
index 827d451bba7..65c8ffbc4dd 100644
--- a/sphinx/util/docutils.py
+++ b/sphinx/util/docutils.py
@@ -143,7 +143,7 @@ def patched_get_language(language_code: str, reporter: Reporter = None) -> Any:
 
 
 @contextmanager
-def using_user_docutils_conf(confdir: str) -> Generator[None, None, None]:
+def using_user_docutils_conf(confdir: Optional[str]) -> Generator[None, None, None]:
     """Let docutils know the location of ``docutils.conf`` for Sphinx."""
     try:
         docutilsconfig = os.environ.get('DOCUTILSCONFIG', None)
@@ -159,7 +159,7 @@ def using_user_docutils_conf(confdir: str) -> Generator[None, None, None]:
 
 
 @contextmanager
-def patch_docutils(confdir: str = None) -> Generator[None, None, None]:
+def patch_docutils(confdir: Optional[str] = None) -> Generator[None, None, None]:
     """Patch to docutils temporarily."""
     with patched_get_language(), using_user_docutils_conf(confdir):
         yield
@@ -345,15 +345,15 @@ class SphinxRole:
     .. note:: The subclasses of this class might not work with docutils.
               This class is strongly coupled with Sphinx.
     """
-    name = None     #: The role name actually used in the document.
-    rawtext = None  #: A string containing the entire interpreted text input.
-    text = None     #: The interpreted text content.
-    lineno = None   #: The line number where the interpreted text begins.
-    inliner = None  #: The ``docutils.parsers.rst.states.Inliner`` object.
-    options = None  #: A dictionary of directive options for customization
-                    #: (from the "role" directive).
-    content = None  #: A list of strings, the directive content for customization
-                    #: (from the "role" directive).
+    name: str           #: The role name actually used in the document.
+    rawtext: str        #: A string containing the entire interpreted text input.
+    text: str           #: The interpreted text content.
+    lineno: int         #: The line number where the interpreted text begins.
+    inliner: Inliner    #: The ``docutils.parsers.rst.states.Inliner`` object.
+    options: Dict       #: A dictionary of directive options for customization
+                        #: (from the "role" directive).
+    content: List[str]  #: A list of strings, the directive content for customization
+                        #: (from the "role" directive).
 
     def __call__(self, name: str, rawtext: str, text: str, lineno: int,
                  inliner: Inliner, options: Dict = {}, content: List[str] = []
@@ -406,10 +406,10 @@ class ReferenceRole(SphinxRole):
     the role.  The parsed result; link title and target will be stored to
     ``self.title`` and ``self.target``.
     """
-    has_explicit_title = None   #: A boolean indicates the role has explicit title or not.
-    disabled = False            #: A boolean indicates the reference is disabled.
-    title = None                #: The link title for the interpreted text.
-    target = None               #: The link target for the interpreted text.
+    has_explicit_title: bool    #: A boolean indicates the role has explicit title or not.
+    disabled: bool              #: A boolean indicates the reference is disabled.
+    title: str                  #: The link title for the interpreted text.
+    target: str                 #: The link target for the interpreted text.
 
     # \x00 means the "<" was backslash-escaped
     explicit_title_re = re.compile(r'^(.+?)\s*(?<!\x00)<(.*?)>$', re.DOTALL)

From 471298064138f405da27cec40ad5c36df54e651b Mon Sep 17 00:00:00 2001
From: Kjell Braden <afflux@pentabarf.de>
Date: Sat, 2 May 2020 08:57:54 +0200
Subject: [PATCH 020/305] add testcase for complex
 typehintsext.autodoc.typehints

---
 tests/roots/test-ext-autodoc/index.rst        |  2 ++
 .../test-ext-autodoc/target/typehints.py      |  7 +++++++
 tests/test_ext_autodoc_configs.py             | 21 +++++++++++++++++--
 3 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/tests/roots/test-ext-autodoc/index.rst b/tests/roots/test-ext-autodoc/index.rst
index 1a60fc28191..1746a0a0313 100644
--- a/tests/roots/test-ext-autodoc/index.rst
+++ b/tests/roots/test-ext-autodoc/index.rst
@@ -9,3 +9,5 @@
    :members:
 
 .. autofunction:: target.typehints.incr
+
+.. autofunction:: target.typehints.tuple_args
diff --git a/tests/roots/test-ext-autodoc/target/typehints.py b/tests/roots/test-ext-autodoc/target/typehints.py
index ab5bfb62465..4503d41e4f5 100644
--- a/tests/roots/test-ext-autodoc/target/typehints.py
+++ b/tests/roots/test-ext-autodoc/target/typehints.py
@@ -1,3 +1,6 @@
+from typing import Tuple, Union
+
+
 def incr(a: int, b: int = 1) -> int:
     return a + b
 
@@ -30,6 +33,10 @@ def horse(self,
         return
 
 
+def tuple_args(x: Tuple[int, Union[int, str]]) -> Tuple[int, int]:
+    pass
+
+
 def complex_func(arg1, arg2, arg3=None, *args, **kwargs):
     # type: (str, List[int], Tuple[int, Union[str, Unknown]], *str, **str) -> None
     pass
diff --git a/tests/test_ext_autodoc_configs.py b/tests/test_ext_autodoc_configs.py
index f351d0e4b57..d82666fb3f6 100644
--- a/tests/test_ext_autodoc_configs.py
+++ b/tests/test_ext_autodoc_configs.py
@@ -508,7 +508,11 @@ def test_autodoc_typehints_signature(app):
         '',
         '.. py:function:: missing_attr(c, a: str, b: Optional[str] = None) -> str',
         '   :module: target.typehints',
-        ''
+        '',
+        '',
+        '.. py:function:: tuple_args(x: Tuple[int, Union[int, str]]) -> Tuple[int, int]',
+        '   :module: target.typehints',
+        '',
     ]
 
 
@@ -557,7 +561,11 @@ def test_autodoc_typehints_none(app):
         '',
         '.. py:function:: missing_attr(c, a, b=None)',
         '   :module: target.typehints',
-        ''
+        '',
+        '',
+        '.. py:function:: tuple_args(x)',
+        '   :module: target.typehints',
+        '',
     ]
 
 
@@ -576,6 +584,15 @@ def test_autodoc_typehints_description(app):
             '   Return type:\n'
             '      int\n'
             in context)
+    assert ('target.typehints.tuple_args(x)\n'
+            '\n'
+            '   Parameters:\n'
+            '      **x** (*Tuple**[**int**, **Union**[**int**, **str**]**]*) --\n'
+            '\n'
+            '   Return type:\n'
+            '      Tuple[int, int]\n'
+            in context)
+
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc')

From 08f25d39afcb778a2d0161f6dc52c2f07b3674d1 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 3 May 2020 23:23:25 +0900
Subject: [PATCH 021/305] Allow to build docs in readthedocs.org

At present, readthedocs_ext expects that DirectoryHTMLBuilder and
SingleFileHTMLBuilder are placed at sphinx.builders.html module.
But they were deprecated since Sphinx-2.0 and will be removed at
Sphinx-4.0.

This revives them temporarily to build our document successfully on
RTD until readthedocs_ext supports the new structure of Sphinx
components.

refs: https://github.com/readthedocs/readthedocs-sphinx-ext/pull/86
---
 sphinx/builders/dirhtml.py       | 9 +++++++++
 sphinx/builders/html/__init__.py | 2 +-
 sphinx/builders/singlehtml.py    | 9 +++++++++
 3 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/sphinx/builders/dirhtml.py b/sphinx/builders/dirhtml.py
index bf940010ac7..ba60c923cba 100644
--- a/sphinx/builders/dirhtml.py
+++ b/sphinx/builders/dirhtml.py
@@ -13,6 +13,7 @@
 
 from sphinx.application import Sphinx
 from sphinx.builders.html import StandaloneHTMLBuilder
+from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.util import logging
 from sphinx.util.osutil import SEP, os_path
 
@@ -45,6 +46,14 @@ def get_outfilename(self, pagename: str) -> str:
         return outfilename
 
 
+# for compatibility
+deprecated_alias('sphinx.builders.html',
+                 {
+                     'DirectoryHTMLBuilder': DirectoryHTMLBuilder,
+                 },
+                 RemovedInSphinx40Warning)
+
+
 def setup(app: Sphinx) -> Dict[str, Any]:
     app.setup_extension('sphinx.builders.html')
 
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 27e1d8e6a09..9ac265e1e40 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1162,7 +1162,7 @@ def validate_html_favicon(app: Sphinx, config: Config) -> None:
         config.html_favicon = None  # type: ignore
 
 
-# for compatibility
+# for compatibility; RemovedInSphinx40Warning
 import sphinx.builders.dirhtml  # NOQA
 import sphinx.builders.singlehtml  # NOQA
 import sphinxcontrib.serializinghtml  # NOQA
diff --git a/sphinx/builders/singlehtml.py b/sphinx/builders/singlehtml.py
index 19ad9c08d4e..b145109a6a1 100644
--- a/sphinx/builders/singlehtml.py
+++ b/sphinx/builders/singlehtml.py
@@ -16,6 +16,7 @@
 
 from sphinx.application import Sphinx
 from sphinx.builders.html import StandaloneHTMLBuilder
+from sphinx.deprecation import RemovedInSphinx40Warning, deprecated_alias
 from sphinx.environment.adapters.toctree import TocTree
 from sphinx.locale import __
 from sphinx.util import logging
@@ -187,6 +188,14 @@ def write_additional_files(self) -> None:
             self.handle_page('opensearch', {}, 'opensearch.xml', outfilename=fn)
 
 
+# for compatibility
+deprecated_alias('sphinx.builders.html',
+                 {
+                     'SingleFileHTMLBuilder': SingleFileHTMLBuilder,
+                 },
+                 RemovedInSphinx40Warning)
+
+
 def setup(app: Sphinx) -> Dict[str, Any]:
     app.setup_extension('sphinx.builders.html')
 

From 41963e35597e4710eb11d0cef08565d98745a43b Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 4 May 2020 02:03:20 +0900
Subject: [PATCH 022/305] refactor: Clean up filterwarnings

Since 4.0, Sphinx does not use lib2to3.  Therefore a filterwarnings
entry for lib2to3 is no longer needed.
---
 setup.cfg | 1 -
 1 file changed, 1 deletion(-)

diff --git a/setup.cfg b/setup.cfg
index cf28fc77742..3e0a292b04b 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -55,7 +55,6 @@ filterwarnings =
     all
     ignore::DeprecationWarning:docutils.io
     ignore::DeprecationWarning:pyximport.pyximport
-    ignore::PendingDeprecationWarning:sphinx.util.pycompat
 markers =
     sphinx
     apidoc

From e5dad73cf231b014f6f6146387f271e1551d04b4 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 31 Mar 2020 00:16:20 +0900
Subject: [PATCH 023/305] py domain: Add :canonical: option

---
 CHANGES                                |  6 +++
 doc/usage/restructuredtext/domains.rst | 40 ++++++++++++++++
 sphinx/domains/python.py               | 22 +++++++--
 tests/test_domain_py.py                | 63 ++++++++++++++++----------
 tests/test_environment.py              |  2 +-
 5 files changed, 104 insertions(+), 29 deletions(-)

diff --git a/CHANGES b/CHANGES
index 4c983abafa4..9bb47a4e7a8 100644
--- a/CHANGES
+++ b/CHANGES
@@ -10,6 +10,9 @@ Dependencies
 Incompatible changes
 --------------------
 
+* #4826: py domain: The structure of python objects is changed.  A boolean value
+  is added to indicate that the python object is canonical one
+
 Deprecated
 ----------
 
@@ -23,6 +26,9 @@ Deprecated
 Features added
 --------------
 
+* #4826: py domain: Add ``:canonical:`` option to python directives to describe
+  the location where the object is defined
+
 Bugs fixed
 ----------
 
diff --git a/doc/usage/restructuredtext/domains.rst b/doc/usage/restructuredtext/domains.rst
index 9559acf2200..59e273c9394 100644
--- a/doc/usage/restructuredtext/domains.rst
+++ b/doc/usage/restructuredtext/domains.rst
@@ -189,6 +189,14 @@ The following directives are provided for module and class contents:
 
       .. versionadded:: 2.1
 
+   .. rst:directive:option:: canonical
+      :type: full qualified name including module name
+
+      Describe the location where the object is defined if the object is
+      imported from other modules
+
+      .. versionadded:: 4.0
+
 .. rst:directive:: .. py:data:: name
 
    Describes global data in a module, including both variables and values used
@@ -207,6 +215,14 @@ The following directives are provided for module and class contents:
 
       .. versionadded:: 2.4
 
+   .. rst:directive:option:: canonical
+      :type: full qualified name including module name
+
+      Describe the location where the object is defined if the object is
+      imported from other modules
+
+      .. versionadded:: 4.0
+
 .. rst:directive:: .. py:exception:: name
 
    Describes an exception class.  The signature can, but need not include
@@ -246,6 +262,14 @@ The following directives are provided for module and class contents:
 
    .. rubric:: options
 
+   .. rst:directive:option:: canonical
+      :type: full qualified name including module name
+
+      Describe the location where the object is defined if the object is
+      imported from other modules
+
+      .. versionadded:: 4.0
+
    .. rst:directive:option:: final
       :type: no value
 
@@ -271,6 +295,14 @@ The following directives are provided for module and class contents:
 
       .. versionadded:: 2.4
 
+   .. rst:directive:option:: canonical
+      :type: full qualified name including module name
+
+      Describe the location where the object is defined if the object is
+      imported from other modules
+
+      .. versionadded:: 4.0
+
 .. rst:directive:: .. py:method:: name(parameters)
 
    Describes an object method.  The parameters should not include the ``self``
@@ -294,6 +326,14 @@ The following directives are provided for module and class contents:
 
       .. versionadded:: 2.1
 
+   .. rst:directive:option:: canonical
+      :type: full qualified name including module name
+
+      Describe the location where the object is defined if the object is
+      imported from other modules
+
+      .. versionadded:: 4.0
+
    .. rst:directive:option:: classmethod
       :type: no value
 
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 2cebccaab99..0f3f089a7d7 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -65,7 +65,8 @@
 
 ObjectEntry = NamedTuple('ObjectEntry', [('docname', str),
                                          ('node_id', str),
-                                         ('objtype', str)])
+                                         ('objtype', str),
+                                         ('canonical', bool)])
 ModuleEntry = NamedTuple('ModuleEntry', [('docname', str),
                                          ('node_id', str),
                                          ('synopsis', str),
@@ -312,6 +313,7 @@ class PyObject(ObjectDescription):
     option_spec = {
         'noindex': directives.flag,
         'module': directives.unchanged,
+        'canonical': directives.unchanged,
         'annotation': directives.unchanged,
     }
 
@@ -453,6 +455,11 @@ def add_target_and_index(self, name_cls: Tuple[str, str], sig: str,
         domain = cast(PythonDomain, self.env.get_domain('py'))
         domain.note_object(fullname, self.objtype, node_id, location=signode)
 
+        canonical_name = self.options.get('canonical')
+        if canonical_name:
+            domain.note_object(canonical_name, self.objtype, node_id, canonical=True,
+                               location=signode)
+
         indextext = self.get_index_text(modname, name_cls)
         if indextext:
             self.indexnode['entries'].append(('single', indextext, node_id, '', None))
@@ -1037,7 +1044,8 @@ class PythonDomain(Domain):
     def objects(self) -> Dict[str, ObjectEntry]:
         return self.data.setdefault('objects', {})  # fullname -> ObjectEntry
 
-    def note_object(self, name: str, objtype: str, node_id: str, location: Any = None) -> None:
+    def note_object(self, name: str, objtype: str, node_id: str,
+                    canonical: bool = False, location: Any = None) -> None:
         """Note a python object for cross reference.
 
         .. versionadded:: 2.1
@@ -1047,7 +1055,7 @@ def note_object(self, name: str, objtype: str, node_id: str, location: Any = Non
             logger.warning(__('duplicate object description of %s, '
                               'other instance in %s, use :noindex: for one of them'),
                            name, other.docname, location=location)
-        self.objects[name] = ObjectEntry(self.env.docname, node_id, objtype)
+        self.objects[name] = ObjectEntry(self.env.docname, node_id, objtype, canonical)
 
     @property
     def modules(self) -> Dict[str, ModuleEntry]:
@@ -1200,7 +1208,11 @@ def get_objects(self) -> Iterator[Tuple[str, str, str, str, str, int]]:
             yield (modname, modname, 'module', mod.docname, mod.node_id, 0)
         for refname, obj in self.objects.items():
             if obj.objtype != 'module':  # modules are already handled
-                yield (refname, refname, obj.objtype, obj.docname, obj.node_id, 1)
+                if obj.canonical:
+                    # canonical names are not full-text searchable.
+                    yield (refname, refname, obj.objtype, obj.docname, obj.node_id, -1)
+                else:
+                    yield (refname, refname, obj.objtype, obj.docname, obj.node_id, 1)
 
     def get_full_qualified_name(self, node: Element) -> str:
         modname = node.get('py:module')
@@ -1246,7 +1258,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
 
     return {
         'version': 'builtin',
-        'env_version': 2,
+        'env_version': 3,
         'parallel_read_safe': True,
         'parallel_write_safe': True,
     }
diff --git a/tests/test_domain_py.py b/tests/test_domain_py.py
index 5a1d73cfe66..6f91323a6e3 100644
--- a/tests/test_domain_py.py
+++ b/tests/test_domain_py.py
@@ -192,20 +192,22 @@ def find_obj(modname, prefix, obj_name, obj_type, searchmode=0):
 
     assert (find_obj(None, None, 'NONEXISTANT', 'class') == [])
     assert (find_obj(None, None, 'NestedParentA', 'class') ==
-            [('NestedParentA', ('roles', 'NestedParentA', 'class'))])
+            [('NestedParentA', ('roles', 'NestedParentA', 'class', False))])
     assert (find_obj(None, None, 'NestedParentA.NestedChildA', 'class') ==
-            [('NestedParentA.NestedChildA', ('roles', 'NestedParentA.NestedChildA', 'class'))])
+            [('NestedParentA.NestedChildA',
+              ('roles', 'NestedParentA.NestedChildA', 'class', False))])
     assert (find_obj(None, 'NestedParentA', 'NestedChildA', 'class') ==
-            [('NestedParentA.NestedChildA', ('roles', 'NestedParentA.NestedChildA', 'class'))])
+            [('NestedParentA.NestedChildA',
+              ('roles', 'NestedParentA.NestedChildA', 'class', False))])
     assert (find_obj(None, None, 'NestedParentA.NestedChildA.subchild_1', 'meth') ==
             [('NestedParentA.NestedChildA.subchild_1',
-              ('roles', 'NestedParentA.NestedChildA.subchild_1', 'method'))])
+              ('roles', 'NestedParentA.NestedChildA.subchild_1', 'method', False))])
     assert (find_obj(None, 'NestedParentA', 'NestedChildA.subchild_1', 'meth') ==
             [('NestedParentA.NestedChildA.subchild_1',
-              ('roles', 'NestedParentA.NestedChildA.subchild_1', 'method'))])
+              ('roles', 'NestedParentA.NestedChildA.subchild_1', 'method', False))])
     assert (find_obj(None, 'NestedParentA.NestedChildA', 'subchild_1', 'meth') ==
             [('NestedParentA.NestedChildA.subchild_1',
-              ('roles', 'NestedParentA.NestedChildA.subchild_1', 'method'))])
+              ('roles', 'NestedParentA.NestedChildA.subchild_1', 'method', False))])
 
 
 def test_get_full_qualified_name():
@@ -464,7 +466,7 @@ def test_pydata(app):
                           [desc, ([desc_signature, desc_name, "var"],
                                   [desc_content, ()])]))
     assert 'var' in domain.objects
-    assert domain.objects['var'] == ('index', 'var', 'data')
+    assert domain.objects['var'] == ('index', 'var', 'data', False)
 
 
 def test_pyfunction(app):
@@ -494,9 +496,9 @@ def test_pyfunction(app):
                 entries=[('single', 'func2() (in module example)', 'example.func2', '', None)])
 
     assert 'func1' in domain.objects
-    assert domain.objects['func1'] == ('index', 'func1', 'function')
+    assert domain.objects['func1'] == ('index', 'func1', 'function', False)
     assert 'example.func2' in domain.objects
-    assert domain.objects['example.func2'] == ('index', 'example.func2', 'function')
+    assert domain.objects['example.func2'] == ('index', 'example.func2', 'function', False)
 
 
 def test_pyclass_options(app):
@@ -518,13 +520,13 @@ def test_pyclass_options(app):
     assert_node(doctree[0], addnodes.index,
                 entries=[('single', 'Class1 (built-in class)', 'Class1', '', None)])
     assert 'Class1' in domain.objects
-    assert domain.objects['Class1'] == ('index', 'Class1', 'class')
+    assert domain.objects['Class1'] == ('index', 'Class1', 'class', False)
 
     # :final:
     assert_node(doctree[2], addnodes.index,
                 entries=[('single', 'Class2 (built-in class)', 'Class2', '', None)])
     assert 'Class2' in domain.objects
-    assert domain.objects['Class2'] == ('index', 'Class2', 'class')
+    assert domain.objects['Class2'] == ('index', 'Class2', 'class', False)
 
 
 def test_pymethod_options(app):
@@ -570,7 +572,7 @@ def test_pymethod_options(app):
                                                      [desc_parameterlist, ()])],
                                    [desc_content, ()]))
     assert 'Class.meth1' in domain.objects
-    assert domain.objects['Class.meth1'] == ('index', 'Class.meth1', 'method')
+    assert domain.objects['Class.meth1'] == ('index', 'Class.meth1', 'method', False)
 
     # :classmethod:
     assert_node(doctree[1][1][2], addnodes.index,
@@ -580,7 +582,7 @@ def test_pymethod_options(app):
                                                      [desc_parameterlist, ()])],
                                    [desc_content, ()]))
     assert 'Class.meth2' in domain.objects
-    assert domain.objects['Class.meth2'] == ('index', 'Class.meth2', 'method')
+    assert domain.objects['Class.meth2'] == ('index', 'Class.meth2', 'method', False)
 
     # :staticmethod:
     assert_node(doctree[1][1][4], addnodes.index,
@@ -590,7 +592,7 @@ def test_pymethod_options(app):
                                                      [desc_parameterlist, ()])],
                                    [desc_content, ()]))
     assert 'Class.meth3' in domain.objects
-    assert domain.objects['Class.meth3'] == ('index', 'Class.meth3', 'method')
+    assert domain.objects['Class.meth3'] == ('index', 'Class.meth3', 'method', False)
 
     # :async:
     assert_node(doctree[1][1][6], addnodes.index,
@@ -600,7 +602,7 @@ def test_pymethod_options(app):
                                                      [desc_parameterlist, ()])],
                                    [desc_content, ()]))
     assert 'Class.meth4' in domain.objects
-    assert domain.objects['Class.meth4'] == ('index', 'Class.meth4', 'method')
+    assert domain.objects['Class.meth4'] == ('index', 'Class.meth4', 'method', False)
 
     # :property:
     assert_node(doctree[1][1][8], addnodes.index,
@@ -609,7 +611,7 @@ def test_pymethod_options(app):
                                                      [desc_name, "meth5"])],
                                    [desc_content, ()]))
     assert 'Class.meth5' in domain.objects
-    assert domain.objects['Class.meth5'] == ('index', 'Class.meth5', 'method')
+    assert domain.objects['Class.meth5'] == ('index', 'Class.meth5', 'method', False)
 
     # :abstractmethod:
     assert_node(doctree[1][1][10], addnodes.index,
@@ -619,7 +621,7 @@ def test_pymethod_options(app):
                                                       [desc_parameterlist, ()])],
                                     [desc_content, ()]))
     assert 'Class.meth6' in domain.objects
-    assert domain.objects['Class.meth6'] == ('index', 'Class.meth6', 'method')
+    assert domain.objects['Class.meth6'] == ('index', 'Class.meth6', 'method', False)
 
     # :final:
     assert_node(doctree[1][1][12], addnodes.index,
@@ -629,7 +631,7 @@ def test_pymethod_options(app):
                                                       [desc_parameterlist, ()])],
                                     [desc_content, ()]))
     assert 'Class.meth7' in domain.objects
-    assert domain.objects['Class.meth7'] == ('index', 'Class.meth7', 'method')
+    assert domain.objects['Class.meth7'] == ('index', 'Class.meth7', 'method', False)
 
 
 def test_pyclassmethod(app):
@@ -650,7 +652,7 @@ def test_pyclassmethod(app):
                                                      [desc_parameterlist, ()])],
                                    [desc_content, ()]))
     assert 'Class.meth' in domain.objects
-    assert domain.objects['Class.meth'] == ('index', 'Class.meth', 'method')
+    assert domain.objects['Class.meth'] == ('index', 'Class.meth', 'method', False)
 
 
 def test_pystaticmethod(app):
@@ -671,7 +673,7 @@ def test_pystaticmethod(app):
                                                      [desc_parameterlist, ()])],
                                    [desc_content, ()]))
     assert 'Class.meth' in domain.objects
-    assert domain.objects['Class.meth'] == ('index', 'Class.meth', 'method')
+    assert domain.objects['Class.meth'] == ('index', 'Class.meth', 'method', False)
 
 
 def test_pyattribute(app):
@@ -694,7 +696,7 @@ def test_pyattribute(app):
                                                      [desc_annotation, " = ''"])],
                                    [desc_content, ()]))
     assert 'Class.attr' in domain.objects
-    assert domain.objects['Class.attr'] == ('index', 'Class.attr', 'attribute')
+    assert domain.objects['Class.attr'] == ('index', 'Class.attr', 'attribute', False)
 
 
 def test_pydecorator_signature(app):
@@ -709,7 +711,7 @@ def test_pydecorator_signature(app):
                 domain="py", objtype="function", noindex=False)
 
     assert 'deco' in domain.objects
-    assert domain.objects['deco'] == ('index', 'deco', 'function')
+    assert domain.objects['deco'] == ('index', 'deco', 'function', False)
 
 
 def test_pydecoratormethod_signature(app):
@@ -724,7 +726,22 @@ def test_pydecoratormethod_signature(app):
                 domain="py", objtype="method", noindex=False)
 
     assert 'deco' in domain.objects
-    assert domain.objects['deco'] == ('index', 'deco', 'method')
+    assert domain.objects['deco'] == ('index', 'deco', 'method', False)
+
+
+def test_canonical(app):
+    text = (".. py:class:: io.StringIO\n"
+            "   :canonical: _io.StringIO")
+    domain = app.env.get_domain('py')
+    doctree = restructuredtext.parse(app, text)
+    assert_node(doctree, (addnodes.index,
+                          [desc, ([desc_signature, ([desc_annotation, "class "],
+                                                    [desc_addname, "io."],
+                                                    [desc_name, "StringIO"])],
+                                  desc_content)]))
+    assert 'io.StringIO' in domain.objects
+    assert domain.objects['io.StringIO'] == ('index', 'io.StringIO', 'class', False)
+    assert domain.objects['_io.StringIO'] == ('index', 'io.StringIO', 'class', True)
 
 
 @pytest.mark.sphinx(freshenv=True)
diff --git a/tests/test_environment.py b/tests/test_environment.py
index 7290eb6a0cb..73d0c3edc2e 100644
--- a/tests/test_environment.py
+++ b/tests/test_environment.py
@@ -84,7 +84,7 @@ def test_object_inventory(app):
     refs = app.env.domaindata['py']['objects']
 
     assert 'func_without_module' in refs
-    assert refs['func_without_module'] == ('objects', 'func_without_module', 'function')
+    assert refs['func_without_module'] == ('objects', 'func_without_module', 'function', False)
     assert 'func_without_module2' in refs
     assert 'mod.func_in_module' in refs
     assert 'mod.Cls' in refs

From 5121b6210e588998505fc031d5806d8670fde798 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 27 May 2020 01:32:40 +0900
Subject: [PATCH 024/305] Fix an isort violation

---
 sphinx/util/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index f3659cc4c2a..f0794bed0fa 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -16,8 +16,8 @@
 import sys
 import tempfile
 import traceback
-import warnings
 import unicodedata
+import warnings
 from datetime import datetime
 from importlib import import_module
 from os import path

From 1dcc26eeda6bbb610edc28528cd911b2b9bbc256 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 27 May 2020 01:35:40 +0900
Subject: [PATCH 025/305] Fix a mypy violation

---
 sphinx/pycode/ast.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/pycode/ast.py b/sphinx/pycode/ast.py
index 0b403b61e55..3d2af342687 100644
--- a/sphinx/pycode/ast.py
+++ b/sphinx/pycode/ast.py
@@ -189,7 +189,7 @@ def visit_Tuple(self, node: ast.Tuple) -> str:
             return "()"
 
     if sys.version_info >= (3, 6):
-        def visit_Constant(self, node: ast.Constant) -> str:
+        def visit_Constant(self, node: ast.Constant) -> str:  # type: ignore
             if node.value is Ellipsis:
                 return "..."
             else:

From 49b91b076dee1f88eab2e551380acfad3c2f8d22 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 27 May 2020 01:38:25 +0900
Subject: [PATCH 026/305] refactor pycode: sort methods

---
 sphinx/pycode/ast.py | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/sphinx/pycode/ast.py b/sphinx/pycode/ast.py
index 3d2af342687..9734cb476f2 100644
--- a/sphinx/pycode/ast.py
+++ b/sphinx/pycode/ast.py
@@ -155,6 +155,12 @@ def visit_Call(self, node: ast.Call) -> str:
                 ["%s=%s" % (k.arg, self.visit(k.value)) for k in node.keywords])
         return "%s(%s)" % (self.visit(node.func), ", ".join(args))
 
+    def visit_Constant(self, node: ast.Constant) -> str:  # type: ignore
+        if node.value is Ellipsis:
+            return "..."
+        else:
+            return repr(node.value)
+
     def visit_Dict(self, node: ast.Dict) -> str:
         keys = (self.visit(k) for k in node.keys)
         values = (self.visit(v) for v in node.values)
@@ -188,13 +194,6 @@ def visit_Tuple(self, node: ast.Tuple) -> str:
         else:
             return "()"
 
-    if sys.version_info >= (3, 6):
-        def visit_Constant(self, node: ast.Constant) -> str:  # type: ignore
-            if node.value is Ellipsis:
-                return "..."
-            else:
-                return repr(node.value)
-
     if sys.version_info < (3, 8):
         # these ast nodes were deprecated in python 3.8
         def visit_Bytes(self, node: ast.Bytes) -> str:

From cfbd0e6ca7d46ee00144e87b4ebe4c0286b5e703 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 29 May 2020 02:33:28 +0900
Subject: [PATCH 027/305] Test with python 3.10

It seems "nightly" python in Travis CI has been changed to 3.10.0a0.
This starts to test with 3.10!
---
 .travis.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 9e4b07aac29..61f400f63e9 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -21,9 +21,12 @@ jobs:
       env:
         - TOXENV=du16
         - PYTEST_ADDOPTS="--cov ./ --cov-append --cov-config setup.cfg"
-    - python: 'nightly'
+    - python: '3.9-dev'
       env:
         - TOXENV=py39
+    - python: 'nightly'
+      env:
+        - TOXENV=py310
     - python: '3.6'
       env: TOXENV=docs
     - python: '3.6'

From 24cdbd43d4b3e8bf56881d18bd77d266563be5dd Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 4 Jun 2020 00:18:35 +0900
Subject: [PATCH 028/305] Fix mypy violations (with mypy-0.780)

---
 sphinx/ext/autodoc/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 083f2aaa719..72121131797 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -950,7 +950,7 @@ def sort_members(self, documenters: List[Tuple["Documenter", bool]],
             # Sort by __all__
             def keyfunc(entry: Tuple[Documenter, bool]) -> int:
                 name = entry[0].name.split('::')[1]
-                if name in self.__all__:
+                if self.__all__ and name in self.__all__:
                     return self.__all__.index(name)
                 else:
                     return len(self.__all__)

From 2953eb81043208ebcf4cc714c57f42ea002ee6e5 Mon Sep 17 00:00:00 2001
From: shimizukawa <shimizukawa@gmail.com>
Date: Sun, 31 May 2020 03:06:44 +0900
Subject: [PATCH 029/305] add debug logs for change detection:
 added/changed/outdated, mtime of sources and templates

---
 sphinx/builders/html/__init__.py | 11 +++++++++++
 sphinx/environment/__init__.py   |  8 ++++++++
 2 files changed, 19 insertions(+)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 963a07ece4d..440ee1f1ebc 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -12,6 +12,7 @@
 import posixpath
 import re
 import sys
+from datetime import datetime
 from os import path
 from typing import Any, Dict, IO, Iterable, Iterator, List, Set, Tuple, Type
 
@@ -344,6 +345,7 @@ def get_outdated_docs(self) -> Iterator[str]:
                 buildinfo = BuildInfo.load(fp)
 
             if self.build_info != buildinfo:
+                logger.debug('[build target] did not match: build_info ')
                 yield from self.env.found_docs
                 return
         except ValueError as exc:
@@ -358,6 +360,7 @@ def get_outdated_docs(self) -> Iterator[str]:
             template_mtime = 0
         for docname in self.env.found_docs:
             if docname not in self.env.all_docs:
+                logger.debug('[build target] did not in env: %r', docname)
                 yield docname
                 continue
             targetname = self.get_outfilename(docname)
@@ -369,6 +372,14 @@ def get_outdated_docs(self) -> Iterator[str]:
                 srcmtime = max(path.getmtime(self.env.doc2path(docname)),
                                template_mtime)
                 if srcmtime > targetmtime:
+                    logger.debug(
+                        '[build target] targetname %r(%s), template(%s), docname %r(%s)',
+                        targetname,
+                        datetime.utcfromtimestamp(targetmtime),
+                        datetime.utcfromtimestamp(template_mtime),
+                        docname,
+                        datetime.utcfromtimestamp(path.getmtime(self.env.doc2path(docname))),
+                    )
                     yield docname
             except OSError:
                 # source doesn't exist anymore
diff --git a/sphinx/environment/__init__.py b/sphinx/environment/__init__.py
index d786decc8d9..9451d145154 100644
--- a/sphinx/environment/__init__.py
+++ b/sphinx/environment/__init__.py
@@ -12,6 +12,7 @@
 import pickle
 from collections import defaultdict
 from copy import copy
+from datetime import datetime
 from os import path
 from typing import Any, Callable, Dict, Generator, Iterator, List, Set, Tuple, Union
 from typing import TYPE_CHECKING
@@ -391,21 +392,28 @@ def get_outdated_files(self, config_changed: bool) -> Tuple[Set[str], Set[str],
         else:
             for docname in self.found_docs:
                 if docname not in self.all_docs:
+                    logger.debug('[build target] added %r', docname)
                     added.add(docname)
                     continue
                 # if the doctree file is not there, rebuild
                 filename = path.join(self.doctreedir, docname + '.doctree')
                 if not path.isfile(filename):
+                    logger.debug('[build target] changed %r', docname)
                     changed.add(docname)
                     continue
                 # check the "reread always" list
                 if docname in self.reread_always:
+                    logger.debug('[build target] changed %r', docname)
                     changed.add(docname)
                     continue
                 # check the mtime of the document
                 mtime = self.all_docs[docname]
                 newmtime = path.getmtime(self.doc2path(docname))
                 if newmtime > mtime:
+                    logger.debug('[build target] outdated %r: %s -> %s',
+                                 docname,
+                                 datetime.utcfromtimestamp(mtime),
+                                 datetime.utcfromtimestamp(newmtime))
                     changed.add(docname)
                     continue
                 # finally, check the mtime of dependencies

From 6d5478b04b04ff4271756a19f8e50535d20cc7c8 Mon Sep 17 00:00:00 2001
From: Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
Date: Thu, 18 Jun 2020 05:38:41 +0900
Subject: [PATCH 030/305] refs #7830: Update CHANGES

---
 CHANGES | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGES b/CHANGES
index 40a0d22b4d9..6b7f0e477c3 100644
--- a/CHANGES
+++ b/CHANGES
@@ -28,6 +28,7 @@ Features added
 
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined
+* #7830: Add debug logs for change detection of sources and templates
 
 Bugs fixed
 ----------

From e98da5ac0d56945fc6a505e774d163e2c97e8701 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 5 Jul 2020 00:24:02 +0900
Subject: [PATCH 031/305] autodoc: Drop encoding parameter from get_doc()

---
 sphinx/ext/autodoc/__init__.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 3df1844674b..ed69a0f6f7d 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -1911,14 +1911,14 @@ def add_directive_header(self, sig: str) -> None:
         else:
             self.add_line('   :annotation: %s' % self.options.annotation, sourcename)
 
-    def get_doc(self, encoding: str = None, ignore: int = None) -> List[List[str]]:
+    def get_doc(self, ignore: int = None) -> List[List[str]]:
         try:
             # Disable `autodoc_inherit_docstring` temporarily to avoid to obtain
             # a docstring from the value which descriptor returns unexpectedly.
             # ref: https://github.com/sphinx-doc/sphinx/issues/7805
             orig = self.env.config.autodoc_inherit_docstrings
             self.env.config.autodoc_inherit_docstrings = False  # type: ignore
-            return super().get_doc(encoding, ignore)
+            return super().get_doc(ignore)
         finally:
             self.env.config.autodoc_inherit_docstrings = orig  # type: ignore
 

From eb07b070e468025c91c8c4adc615effcb62f8057 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 5 Jul 2020 00:30:40 +0900
Subject: [PATCH 032/305] Fix a mypy violation

---
 sphinx/ext/autodoc/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index ed69a0f6f7d..a8c571f3ee1 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -1656,7 +1656,7 @@ def add_directive_header(self, sig: str) -> None:
         self.options.annotation = SUPPRESS  # type: ignore
         super().add_directive_header(sig)
 
-    def get_doc(self, encoding: str = None, ignore: int = None) -> List[List[str]]:
+    def get_doc(self, ignore: int = None) -> List[List[str]]:
         if ignore is not None:
             warnings.warn("The 'ignore' argument to autodoc.%s.get_doc() is deprecated."
                           % self.__class__.__name__,

From ec1ad83be31ff0aca57f6a2e4a76e71aa5996e40 Mon Sep 17 00:00:00 2001
From: Erik Faye-Lund <kusmabite@gmail.com>
Date: Tue, 7 Jul 2020 22:10:54 +0200
Subject: [PATCH 033/305] Add docs.mesa3d.org to EXAMPLES

We started using Sphinx for docs.mesa3d.org, thanks for a great product!
---
 EXAMPLES | 1 +
 1 file changed, 1 insertion(+)

diff --git a/EXAMPLES b/EXAMPLES
index 2690b0bd55c..87bf8feb6f0 100644
--- a/EXAMPLES
+++ b/EXAMPLES
@@ -223,6 +223,7 @@ Documentation using sphinx_rtd_theme
 * `Mailman <http://docs.list.org/>`__
 * `MathJax <https://docs.mathjax.org/>`__
 * `MDTraj <http://mdtraj.org/latest/>`__ (customized)
+* `Mesa 3D <https://docs.mesa3d.org/>`__
 * `micca - MICrobial Community Analysis <https://micca.readthedocs.io/>`__
 * `MicroPython <https://docs.micropython.org/>`__
 * `Minds <https://www.minds.org/docs/>`__ (customized)

From 436519743baa70b16ecc881ccadc40ce6ec83fba Mon Sep 17 00:00:00 2001
From: Hameer Abbasi <einstein.edison@gmail.com>
Date: Wed, 15 Jul 2020 12:39:22 +0200
Subject: [PATCH 034/305] Move to MathJax 3.

---
 doc/usage/extensions/math.rst | 8 ++++++--
 sphinx/ext/mathjax.py         | 4 ++--
 tests/test_ext_math.py        | 4 ++--
 3 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/doc/usage/extensions/math.rst b/doc/usage/extensions/math.rst
index 780e57ee29d..62d8603c9ee 100644
--- a/doc/usage/extensions/math.rst
+++ b/doc/usage/extensions/math.rst
@@ -140,6 +140,10 @@ are built:
 .. module:: sphinx.ext.mathjax
    :synopsis: Render math using JavaScript via MathJax.
 
+.. warning::
+   Version 4.0 changes the version of MathJax used to version 3. You may need to
+   to override ``mathjax_path`` or change your configuration options.
+
 .. versionadded:: 1.1
 
 This extension puts math as-is into the HTML files.  The JavaScript package
@@ -161,12 +165,12 @@ Sphinx but is set to automatically include it from a third-party site.
    MathJax.
 
    The default is the ``https://`` URL that loads the JS files from the
-   `cdnjs`__ Content Delivery Network. See the `MathJax Getting Started
+   `jsdelivr`__ Content Delivery Network. See the `MathJax Getting Started
    page`__ for details. If you want MathJax to be available offline or
    without including resources from a third-party site, you have to
    download it and set this value to a different path.
 
-   __ https://cdnjs.com
+   __ https://www.jsdelivr.com/
 
    __ https://docs.mathjax.org/en/latest/start.html
 
diff --git a/sphinx/ext/mathjax.py b/sphinx/ext/mathjax.py
index cc3cd4ba34e..59eb160472e 100644
--- a/sphinx/ext/mathjax.py
+++ b/sphinx/ext/mathjax.py
@@ -96,8 +96,8 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     # more information for mathjax secure url is here:
     # https://docs.mathjax.org/en/latest/start.html#secure-access-to-the-cdn
     app.add_config_value('mathjax_path',
-                         'https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?'
-                         'config=TeX-AMS-MML_HTMLorMML', 'html')
+                         'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js',
+                         'html')
     app.add_config_value('mathjax_options', {}, 'html')
     app.add_config_value('mathjax_inline', [r'\(', r'\)'], 'html')
     app.add_config_value('mathjax_display', [r'\[', r'\]'], 'html')
diff --git a/tests/test_ext_math.py b/tests/test_ext_math.py
index 4df7d47c7c2..d094def7ae7 100644
--- a/tests/test_ext_math.py
+++ b/tests/test_ext_math.py
@@ -71,8 +71,8 @@ def test_mathjax_options(app, status, warning):
 
     content = (app.outdir / 'index.html').read_text()
     assert ('<script async="async" integrity="sha384-0123456789" '
-            'src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?'
-            'config=TeX-AMS-MML_HTMLorMML"></script>' in content)
+            'src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js">'
+            '</script>' in content)
 
 
 @pytest.mark.sphinx('html', testroot='ext-math',

From 72f359279684b931180414e6d7bf653774a6cf8e Mon Sep 17 00:00:00 2001
From: Hameer Abbasi <einstein.edison@gmail.com>
Date: Wed, 15 Jul 2020 14:39:56 +0200
Subject: [PATCH 035/305] Delete repeated word.

Co-authored-by: Dmitry Shachnev <mitya57@users.noreply.github.com>
---
 doc/usage/extensions/math.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/extensions/math.rst b/doc/usage/extensions/math.rst
index 62d8603c9ee..91cb451248c 100644
--- a/doc/usage/extensions/math.rst
+++ b/doc/usage/extensions/math.rst
@@ -142,7 +142,7 @@ are built:
 
 .. warning::
    Version 4.0 changes the version of MathJax used to version 3. You may need to
-   to override ``mathjax_path`` or change your configuration options.
+   override ``mathjax_path`` or change your configuration options.
 
 .. versionadded:: 1.1
 

From 882376886bc81d3977ebcd47d1be58a7fe671cb3 Mon Sep 17 00:00:00 2001
From: Hameer Abbasi <einstein.edison@gmail.com>
Date: Thu, 16 Jul 2020 12:07:46 +0200
Subject: [PATCH 036/305] Add changes entry.

---
 CHANGES | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES b/CHANGES
index 38c18256d95..1393ae8adbe 100644
--- a/CHANGES
+++ b/CHANGES
@@ -12,6 +12,9 @@ Incompatible changes
 
 * #4826: py domain: The structure of python objects is changed.  A boolean value
   is added to indicate that the python object is canonical one
+* #7425: MathJax: The MathJax was changed from 2 to 3. Users using a custom
+  MathJax configuration may have to set the old MathJax path or update their
+  configuration for version 3.
 
 Deprecated
 ----------

From 68327ba2e617807eb3c59e9964cebd0c5f2642f9 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 16 Jul 2020 02:24:07 +0900
Subject: [PATCH 037/305] refactor: namedtuples with PEP 526

Apply PEP 526 based variable annotation style to namedtuples.  It
is available since python 3.6.
---
 sphinx/domains/__init__.py                | 15 ++++++++-------
 sphinx/domains/python.py                  | 23 ++++++++++++++---------
 sphinx/events.py                          |  8 +++++---
 sphinx/ext/autosummary/generate.py        |  9 +++++----
 sphinx/transforms/post_transforms/code.py |  7 ++++---
 sphinx/util/images.py                     |  8 +++++---
 6 files changed, 41 insertions(+), 29 deletions(-)

diff --git a/sphinx/domains/__init__.py b/sphinx/domains/__init__.py
index f1d8523d488..e333af8ed71 100644
--- a/sphinx/domains/__init__.py
+++ b/sphinx/domains/__init__.py
@@ -54,13 +54,14 @@ def __init__(self, lname: str, *roles: Any, **attrs: Any) -> None:
         self.attrs.update(attrs)
 
 
-IndexEntry = NamedTuple('IndexEntry', [('name', str),
-                                       ('subtype', int),
-                                       ('docname', str),
-                                       ('anchor', str),
-                                       ('extra', str),
-                                       ('qualifier', str),
-                                       ('descr', str)])
+class IndexEntry(NamedTuple):
+    name: str
+    subtype: int
+    docname: str
+    anchor: str
+    extra: str
+    qualifier: str
+    descr: str
 
 
 class Index:
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index a5989bf7e6e..ba07b8847f2 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -63,15 +63,20 @@
     'builtin':   _('built-in function'),
 }
 
-ObjectEntry = NamedTuple('ObjectEntry', [('docname', str),
-                                         ('node_id', str),
-                                         ('objtype', str),
-                                         ('canonical', bool)])
-ModuleEntry = NamedTuple('ModuleEntry', [('docname', str),
-                                         ('node_id', str),
-                                         ('synopsis', str),
-                                         ('platform', str),
-                                         ('deprecated', bool)])
+
+class ObjectEntry(NamedTuple):
+    docname: str
+    node_id: str
+    objtype: str
+    canonical: bool
+
+
+class ModuleEntry(NamedTuple):
+    docname: str
+    node_id: str
+    synopsis: str
+    platform: str
+    deprecated: bool
 
 
 def type_to_xref(text: str) -> addnodes.pending_xref:
diff --git a/sphinx/events.py b/sphinx/events.py
index 3a3753895e4..9d7402554c1 100644
--- a/sphinx/events.py
+++ b/sphinx/events.py
@@ -25,9 +25,11 @@
 
 logger = logging.getLogger(__name__)
 
-EventListener = NamedTuple('EventListener', [('id', int),
-                                             ('handler', Callable),
-                                             ('priority', int)])
+
+class EventListener(NamedTuple):
+    id: int
+    handler: Callable
+    priority: int
 
 
 # List of all known core events. Maps name to arguments description.
diff --git a/sphinx/ext/autosummary/generate.py b/sphinx/ext/autosummary/generate.py
index 91ef067a944..c45b90cdd92 100644
--- a/sphinx/ext/autosummary/generate.py
+++ b/sphinx/ext/autosummary/generate.py
@@ -76,10 +76,11 @@ def emit_firstresult(self, *args: Any) -> None:
         pass
 
 
-AutosummaryEntry = NamedTuple('AutosummaryEntry', [('name', str),
-                                                   ('path', str),
-                                                   ('template', str),
-                                                   ('recursive', bool)])
+class AutosummaryEntry(NamedTuple):
+    name: str
+    path: str
+    template: str
+    recursive: bool
 
 
 def setup_documenters(app: Any) -> None:
diff --git a/sphinx/transforms/post_transforms/code.py b/sphinx/transforms/post_transforms/code.py
index add35647bbb..f6ddb521f9b 100644
--- a/sphinx/transforms/post_transforms/code.py
+++ b/sphinx/transforms/post_transforms/code.py
@@ -21,9 +21,10 @@
 from sphinx.transforms import SphinxTransform
 
 
-HighlightSetting = NamedTuple('HighlightSetting', [('language', str),
-                                                   ('force', bool),
-                                                   ('lineno_threshold', int)])
+class HighlightSetting(NamedTuple):
+    language: str
+    force: bool
+    lineno_threshold: int
 
 
 class HighlightLanguageTransform(SphinxTransform):
diff --git a/sphinx/util/images.py b/sphinx/util/images.py
index 0ddf6490864..69bccb351e9 100644
--- a/sphinx/util/images.py
+++ b/sphinx/util/images.py
@@ -31,9 +31,11 @@
     ('.ai', 'application/illustrator'),
 ])
 
-DataURI = NamedTuple('DataURI', [('mimetype', str),
-                                 ('charset', str),
-                                 ('data', bytes)])
+
+class DataURI(NamedTuple):
+    mimetype: str
+    charset: str
+    data: bytes
 
 
 def get_image_size(filename: str) -> Optional[Tuple[int, int]]:

From 897be0ebae09117d64222dcee23daa80d32a28cb Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 19 Jul 2020 02:12:41 +0900
Subject: [PATCH 038/305] Close #7784: i18n: The alt text for image is
 translated by default

Make alt text for image translatable by default without settings of
gettext_additional_targets.
---
 CHANGES                                       |  3 +++
 doc/usage/configuration.rst                   |  5 ++++-
 sphinx/transforms/i18n.py                     |  9 ++++++--
 sphinx/util/nodes.py                          | 16 +++++++++-----
 .../roots/test-intl/xx/LC_MESSAGES/figure.po  | 22 +++++++++----------
 tests/test_intl.py                            | 12 +++++-----
 6 files changed, 40 insertions(+), 27 deletions(-)

diff --git a/CHANGES b/CHANGES
index 38c18256d95..1f2d2f56901 100644
--- a/CHANGES
+++ b/CHANGES
@@ -12,6 +12,7 @@ Incompatible changes
 
 * #4826: py domain: The structure of python objects is changed.  A boolean value
   is added to indicate that the python object is canonical one
+* #7784: i18n: The msgid for alt text of image is changed
 
 Deprecated
 ----------
@@ -28,6 +29,8 @@ Features added
 
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined
+* #7784: i18n: The alt text for image is translated by default (without
+  :confval:`gettext_additional_targets` setting)
 * #7830: Add debug logs for change detection of sources and templates
 
 Bugs fixed
diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index c17bc58adac..382e4091e8e 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -801,13 +801,16 @@ documentation on :ref:`intl` for details.
    :literal-block: literal blocks (``::`` annotation and ``code-block`` directive)
    :doctest-block: doctest block
    :raw: raw content
-   :image: image/figure uri and alt
+   :image: image/figure uri
 
    For example: ``gettext_additional_targets = ['literal-block', 'image']``.
 
    The default is ``[]``.
 
    .. versionadded:: 1.3
+   .. versionchanged:: 4.0
+
+      The alt text for image is translated by default.
 
 .. confval:: figure_language_filename
 
diff --git a/sphinx/transforms/i18n.py b/sphinx/transforms/i18n.py
index e6a12b9626b..028044de20d 100644
--- a/sphinx/transforms/i18n.py
+++ b/sphinx/transforms/i18n.py
@@ -237,6 +237,10 @@ def apply(self, **kwargs: Any) -> None:
                 node.details['nodes'][0]['content'] = msgstr
                 continue
 
+            if isinstance(node, nodes.image) and node.get('alt') == msg:
+                node['alt'] = msgstr
+                continue
+
             # Avoid "Literal block expected; none found." warnings.
             # If msgstr ends with '::' then it cause warning message at
             # parser.parse() processing.
@@ -440,8 +444,9 @@ def get_ref_key(node: addnodes.pending_xref) -> Tuple[str, str, str]:
             if isinstance(node, LITERAL_TYPE_NODES):
                 node.rawsource = node.astext()
 
-            if isinstance(node, IMAGE_TYPE_NODES):
-                node.update_all_atts(patch)
+            if isinstance(node, nodes.image) and node.get('alt') != msg:
+                node['uri'] = patch['uri']
+                continue  # do not mark translated
 
             node['translated'] = True  # to avoid double translation
 
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index e360ffb7fdc..099866d6635 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -197,6 +197,10 @@ def is_translatable(node: Node) -> bool:
     if isinstance(node, addnodes.translatable):
         return True
 
+    # image node marked as translatable or having alt text
+    if isinstance(node, nodes.image) and (node.get('translatable') or node.get('alt')):
+        return True
+
     if isinstance(node, nodes.Inline) and 'translatable' not in node:  # type: ignore
         # inline node must not be translated if 'translatable' is not set
         return False
@@ -224,9 +228,6 @@ def is_translatable(node: Node) -> bool:
             return False
         return True
 
-    if isinstance(node, nodes.image) and node.get('translatable'):
-        return True
-
     if isinstance(node, addnodes.meta):
         return True
     if is_pending_meta(node):
@@ -259,10 +260,13 @@ def extract_messages(doctree: Element) -> Iterable[Tuple[Element, str]]:
             msg = node.rawsource
             if not msg:
                 msg = node.astext()
-        elif isinstance(node, IMAGE_TYPE_NODES):
-            msg = '.. image:: %s' % node['uri']
+        elif isinstance(node, nodes.image):
             if node.get('alt'):
-                msg += '\n   :alt: %s' % node['alt']
+                yield node, node['alt']
+            if node.get('translatable'):
+                msg = '.. image:: %s' % node['uri']
+            else:
+                msg = None
         elif isinstance(node, META_TYPE_NODES):
             msg = node.rawcontent
         elif isinstance(node, nodes.pending) and is_pending_meta(node):
diff --git a/tests/roots/test-intl/xx/LC_MESSAGES/figure.po b/tests/roots/test-intl/xx/LC_MESSAGES/figure.po
index 449b15e3f3e..64bbdf763db 100644
--- a/tests/roots/test-intl/xx/LC_MESSAGES/figure.po
+++ b/tests/roots/test-intl/xx/LC_MESSAGES/figure.po
@@ -37,19 +37,17 @@ msgstr "BLOCK"
 msgid "image url and alt"
 msgstr "IMAGE URL AND ALT"
 
-msgid ""
-".. image:: img.png\n"
-"   :alt: img"
-msgstr ""
-".. image:: i18n.png\n"
-"   :alt: IMG -> I18N"
+msgid "img"
+msgstr "IMG -> I18N"
 
-msgid ""
-".. image:: i18n.png\n"
-"   :alt: i18n"
-msgstr ""
-".. image:: img.png\n"
-"   :alt: I18N -> IMG"
+msgid ".. image:: img.png"
+msgstr ".. image:: i18n.png"
+
+msgid "i18n"
+msgstr "I18N -> IMG"
+
+msgid ".. image:: i18n.png"
+msgstr ".. image:: img.png"
 
 msgid "image on substitution"
 msgstr "IMAGE ON SUBSTITUTION"
diff --git a/tests/test_intl.py b/tests/test_intl.py
index d0c64b589df..d9701343ef9 100644
--- a/tests/test_intl.py
+++ b/tests/test_intl.py
@@ -345,9 +345,9 @@ def test_text_figure_captions(app):
               "14.2. IMAGE URL AND ALT\n"
               "=======================\n"
               "\n"
-              "[image: i18n][image]\n"
+              "[image: I18N -> IMG][image]\n"
               "\n"
-              "   [image: img][image]\n"
+              "   [image: IMG -> I18N][image]\n"
               "\n"
               "\n"
               "14.3. IMAGE ON SUBSTITUTION\n"
@@ -1102,12 +1102,12 @@ def test_additional_targets_should_not_be_translated(app):
 
     result = (app.outdir / 'figure.html').read_text()
 
-    # alt and src for image block should not be translated
-    expected_expr = """<img alt="i18n" src="_images/i18n.png" />"""
+    # src for image block should not be translated (alt is translated)
+    expected_expr = """<img alt="I18N -&gt; IMG" src="_images/i18n.png" />"""
     assert_count(expected_expr, result, 1)
 
-    # alt and src for figure block should not be translated
-    expected_expr = """<img alt="img" src="_images/img.png" />"""
+    # src for figure block should not be translated (alt is translated)
+    expected_expr = """<img alt="IMG -&gt; I18N" src="_images/img.png" />"""
     assert_count(expected_expr, result, 1)
 
 

From aed8f719ca9a2657cd37ae674f7f7ff67d5d24e1 Mon Sep 17 00:00:00 2001
From: Hameer Abbasi <einstein.edison@gmail.com>
Date: Fri, 24 Jul 2020 11:52:30 +0200
Subject: [PATCH 039/305] Expand warning and refer to it from CHANGES.

---
 CHANGES                       | 2 +-
 doc/usage/extensions/math.rst | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 1393ae8adbe..23dae4c1380 100644
--- a/CHANGES
+++ b/CHANGES
@@ -14,7 +14,7 @@ Incompatible changes
   is added to indicate that the python object is canonical one
 * #7425: MathJax: The MathJax was changed from 2 to 3. Users using a custom
   MathJax configuration may have to set the old MathJax path or update their
-  configuration for version 3.
+  configuration for version 3. See :mod:`sphinx.ext.mathjax`.
 
 Deprecated
 ----------
diff --git a/doc/usage/extensions/math.rst b/doc/usage/extensions/math.rst
index 91cb451248c..ff860bd379a 100644
--- a/doc/usage/extensions/math.rst
+++ b/doc/usage/extensions/math.rst
@@ -142,7 +142,8 @@ are built:
 
 .. warning::
    Version 4.0 changes the version of MathJax used to version 3. You may need to
-   override ``mathjax_path`` or change your configuration options.
+   override ``mathjax_path`` to ``https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML``
+   or update your configuration options for version 3.
 
 .. versionadded:: 1.1
 
@@ -172,7 +173,7 @@ Sphinx but is set to automatically include it from a third-party site.
 
    __ https://www.jsdelivr.com/
 
-   __ https://docs.mathjax.org/en/latest/start.html
+   __ https://www.mathjax.org/#gettingstarted
 
    The path can be absolute or relative; if it is relative, it is relative to
    the ``_static`` directory of the built docs.

From 496ac3fe8bd8c81c569a31b25c0a1a9e536e94d7 Mon Sep 17 00:00:00 2001
From: Hameer Abbasi <einstein.edison@gmail.com>
Date: Fri, 24 Jul 2020 12:31:23 +0200
Subject: [PATCH 040/305] Change MathJax 2 path string.

Co-authored-by: Dmitry Shachnev <mitya57@users.noreply.github.com>
---
 doc/usage/extensions/math.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/extensions/math.rst b/doc/usage/extensions/math.rst
index ff860bd379a..648e4ab6bc1 100644
--- a/doc/usage/extensions/math.rst
+++ b/doc/usage/extensions/math.rst
@@ -142,7 +142,7 @@ are built:
 
 .. warning::
    Version 4.0 changes the version of MathJax used to version 3. You may need to
-   override ``mathjax_path`` to ``https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML``
+   override ``mathjax_path`` to ``https://cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-AMS-MML_HTMLorMML``
    or update your configuration options for version 3.
 
 .. versionadded:: 1.1

From 8f5ce152a134415bc1604740bcf397c7f124fdf7 Mon Sep 17 00:00:00 2001
From: Hameer Abbasi <einstein.edison@gmail.com>
Date: Fri, 24 Jul 2020 16:59:40 +0200
Subject: [PATCH 041/305] Fold line.

---
 doc/usage/extensions/math.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/usage/extensions/math.rst b/doc/usage/extensions/math.rst
index ff860bd379a..dec64c8cd12 100644
--- a/doc/usage/extensions/math.rst
+++ b/doc/usage/extensions/math.rst
@@ -142,7 +142,8 @@ are built:
 
 .. warning::
    Version 4.0 changes the version of MathJax used to version 3. You may need to
-   override ``mathjax_path`` to ``https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML``
+   override ``mathjax_path`` to
+   ``https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML``
    or update your configuration options for version 3.
 
 .. versionadded:: 1.1

From df2d4839c45de9dfbd1971e7def82263ddad4f29 Mon Sep 17 00:00:00 2001
From: Ebram Shehata <ebram96@gmail.com>
Date: Wed, 29 Jul 2020 15:14:29 +0200
Subject: [PATCH 042/305] Update basics.rst

---
 doc/usage/restructuredtext/basics.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/restructuredtext/basics.rst b/doc/usage/restructuredtext/basics.rst
index 8f596ed9a96..03b690f4411 100644
--- a/doc/usage/restructuredtext/basics.rst
+++ b/doc/usage/restructuredtext/basics.rst
@@ -288,7 +288,7 @@ Roles
 -----
 
 A role or "custom interpreted text role" (:duref:`ref <roles>`) is an inline
-piece of explicit markup. It signifies that that the enclosed text should be
+piece of explicit markup. It signifies that the enclosed text should be
 interpreted in a specific way.  Sphinx uses this to provide semantic markup and
 cross-referencing of identifiers, as described in the appropriate section.  The
 general syntax is ``:rolename:`content```.

From 49018ec68d15d116728e57714a746057baf79006 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 1 Aug 2020 18:01:56 +0900
Subject: [PATCH 043/305] Fix a mypy violation

---
 sphinx/domains/python.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 469bfe8846c..03edce922c7 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -138,7 +138,7 @@ def unparse(node: ast.AST) -> List[Node]:
             return result
         else:
             if sys.version_info >= (3, 6):
-                if isinstance(node, ast.Constant):
+                if isinstance(node, ast.Constant):  # type: ignore
                     if node.value is Ellipsis:
                         return [addnodes.desc_sig_punctuation('', "...")]
                     else:

From 2df385e96c23b8267f7f3b7c38bea7bbe3ec5921 Mon Sep 17 00:00:00 2001
From: Mateusz Lapsa-Malawski <m@cr3.io>
Date: Fri, 7 Aug 2020 18:19:22 +0100
Subject: [PATCH 044/305] Synchronise word length between python stemmer and
 javascript stemmer. Python rejects words shorter then 3 while javascript
 allows user to search fo them.

---
 sphinx/search/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/search/__init__.py b/sphinx/search/__init__.py
index 5413957a0e4..4fd566eeb64 100644
--- a/sphinx/search/__init__.py
+++ b/sphinx/search/__init__.py
@@ -112,7 +112,7 @@ def word_filter(self, word: str) -> bool:
             len(word) == 0 or not (
                 ((len(word) < 3) and (12353 < ord(word[0]) < 12436)) or
                 (ord(word[0]) < 256 and (
-                    len(word) < 3 or word in self.stopwords
+                    word in self.stopwords
                 ))))
 
 

From 7aa52e658cc21c0c758b768806d6d8e3c97e1ba5 Mon Sep 17 00:00:00 2001
From: Mateusz Lapsa-Malawski <m@cr3.io>
Date: Fri, 7 Aug 2020 19:22:17 +0100
Subject: [PATCH 045/305] update tests

---
 tests/test_search.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/tests/test_search.py b/tests/test_search.py
index a4cefbc67f9..738b1c86f54 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -143,6 +143,7 @@ def test_IndexBuilder():
     assert index._titles == {'docname': 'title', 'docname2': 'title2'}
     assert index._filenames == {'docname': 'filename', 'docname2': 'filename2'}
     assert index._mapping == {
+        'ar': {'docname', 'docname2'},
         'fermion': {'docname', 'docname2'},
         'comment': {'docname', 'docname2'},
         'non': {'docname', 'docname2'},
@@ -161,7 +162,8 @@ def test_IndexBuilder():
         'objects': {'': {'objdispname': (0, 0, 1, '#anchor')}},
         'objnames': {0: ('dummy', 'objtype', 'objtype')},
         'objtypes': {0: 'dummy:objtype'},
-        'terms': {'comment': [0, 1],
+        'terms': {'ar': [0, 1],
+                  'comment': [0, 1],
                   'fermion': [0, 1],
                   'index': [0, 1],
                   'non': [0, 1],
@@ -197,6 +199,7 @@ def test_IndexBuilder():
     assert index._titles == {'docname2': 'title2'}
     assert index._filenames == {'docname2': 'filename2'}
     assert index._mapping == {
+        'ar': {'docname2'},
         'fermion': {'docname2'},
         'comment': {'docname2'},
         'non': {'docname2'},
@@ -215,7 +218,8 @@ def test_IndexBuilder():
         'objects': {},
         'objnames': {0: ('dummy', 'objtype', 'objtype')},
         'objtypes': {0: 'dummy:objtype'},
-        'terms': {'comment': 0,
+        'terms': {'ar': 0,
+                  'comment': 0,
                   'fermion': 0,
                   'index': 0,
                   'non': 0,
@@ -261,4 +265,3 @@ def test_nosearch(app):
     assert index['docnames'] == ['index', 'nosearch', 'tocitem']
     assert 'latex' not in index['terms']
     assert 'zfs' in index['terms']
-    assert index['terms']['zfs'] == 0  # zfs on nosearch.rst is not registered to index

From 2aa54e54f54d76b39770f6075dad822377b1c7b7 Mon Sep 17 00:00:00 2001
From: Mateusz Lapsa-Malawski <m@cr3.io>
Date: Fri, 7 Aug 2020 19:30:12 +0100
Subject: [PATCH 046/305] improve test_nosearch

---
 tests/test_search.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/test_search.py b/tests/test_search.py
index 738b1c86f54..72eb39a0ae2 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -265,3 +265,4 @@ def test_nosearch(app):
     assert index['docnames'] == ['index', 'nosearch', 'tocitem']
     assert 'latex' not in index['terms']
     assert 'zfs' in index['terms']
+    assert index['terms']['zfs'] == []  # zfs on nosearch.rst is not registered to index

From fa8ad979afbe28599063c2f2bd0745349dbf45c3 Mon Sep 17 00:00:00 2001
From: "Adam J. Stewart" <ajstewart426@gmail.com>
Date: Tue, 11 Aug 2020 11:05:00 -0500
Subject: [PATCH 047/305] sphinx.ext.autodoc: fix typo in docs

---
 doc/usage/extensions/autodoc.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index 71f49c24044..971472c0398 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -526,7 +526,7 @@ There are also config values that you can set:
 
    This value controls the docstrings inheritance.
    If set to True the docstring for classes or methods, if not explicitly set,
-   is inherited form parents.
+   is inherited from parents.
 
    The default is ``True``.
 

From 359290b92b4c1770eb652bb2125514a483fca2d9 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 13 Sep 2020 01:07:14 +0900
Subject: [PATCH 048/305] Close #8201: Emit a warning if toctree contains
 duplicated entries

---
 CHANGES                    | 1 +
 sphinx/directives/other.py | 8 +++++++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index bb1530e7734..814b5b4ca4b 100644
--- a/CHANGES
+++ b/CHANGES
@@ -35,6 +35,7 @@ Features added
 * #7784: i18n: The alt text for image is translated by default (without
   :confval:`gettext_additional_targets` setting)
 * #7830: Add debug logs for change detection of sources and templates
+* #8201: Emit a warning if toctree contains duplicated entries
 
 Bugs fixed
 ----------
diff --git a/sphinx/directives/other.py b/sphinx/directives/other.py
index fc1631edc9c..ec7f846615a 100644
--- a/sphinx/directives/other.py
+++ b/sphinx/directives/other.py
@@ -136,7 +136,13 @@ def parse_content(self, toctree: addnodes.toctree) -> List[Node]:
                                                                     line=self.lineno))
                     self.env.note_reread()
                 else:
-                    all_docnames.discard(docname)
+                    if docname in all_docnames:
+                        all_docnames.remove(docname)
+                    else:
+                        message = 'duplicated entry found in toctree: %s'
+                        ret.append(self.state.document.reporter.warning(message % docname,
+                                                                        line=self.lineno))
+
                     toctree['entries'].append((title, docname))
                     toctree['includefiles'].append(docname)
 

From eef2f2a8b6471cb4d88c0c0895e7a8f8b59070e6 Mon Sep 17 00:00:00 2001
From: Tetsuo Koyama <tkoyama010@gmail.com>
Date: Sun, 20 Sep 2020 00:53:57 +0900
Subject: [PATCH 049/305] :pencil2: Fix grammer

---
 doc/usage/advanced/intl.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/advanced/intl.rst b/doc/usage/advanced/intl.rst
index 67d5e10e569..1a730f8ced5 100644
--- a/doc/usage/advanced/intl.rst
+++ b/doc/usage/advanced/intl.rst
@@ -306,7 +306,7 @@ Contributing to Sphinx reference translation
 The recommended way for new contributors to translate Sphinx reference is to
 join the translation team on Transifex.
 
-There is `sphinx translation page`_ for Sphinx (master) documentation.
+There is a `sphinx translation page`_ for Sphinx (master) documentation.
 
 1. Login to transifex_ service.
 2. Go to `sphinx translation page`_.

From 9fe3fe4f6bae8b7bd39c8d0ef0ed1e0a6b22947f Mon Sep 17 00:00:00 2001
From: Tetsuo Koyama <tkoyama010@gmail.com>
Date: Sun, 20 Sep 2020 01:08:21 +0900
Subject: [PATCH 050/305] Add "Getting Started as a Translator"

---
 doc/usage/advanced/intl.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/usage/advanced/intl.rst b/doc/usage/advanced/intl.rst
index 1a730f8ced5..03b77fb6b38 100644
--- a/doc/usage/advanced/intl.rst
+++ b/doc/usage/advanced/intl.rst
@@ -314,6 +314,8 @@ There is a `sphinx translation page`_ for Sphinx (master) documentation.
 4. Wait acceptance by transifex sphinx translation maintainers.
 5. (After acceptance) Translate on transifex.
 
+Detail is here: https://docs.transifex.com/getting-started-1/translators
+
 .. rubric:: Footnotes
 
 .. [1] See the `GNU gettext utilities

From 81d7f2ee8a5f497008bbf475234e8aa97bfb1d18 Mon Sep 17 00:00:00 2001
From: Steve Piercy <web@stevepiercy.com>
Date: Sat, 26 Sep 2020 16:32:59 -0700
Subject: [PATCH 051/305] Update link to sphinxcontrib on GitHub

---
 doc/usage/restructuredtext/domains.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/restructuredtext/domains.rst b/doc/usage/restructuredtext/domains.rst
index eb9c6fb93ff..aa93b8cf1b0 100644
--- a/doc/usage/restructuredtext/domains.rst
+++ b/doc/usage/restructuredtext/domains.rst
@@ -1851,7 +1851,7 @@ currently Ada_, CoffeeScript_, Erlang_, HTTP_, Lasso_, MATLAB_, PHP_, and Ruby_
 domains. Also available are domains for `Chapel`_, `Common Lisp`_, dqn_, Go_,
 Jinja_, Operation_, and Scala_.
 
-.. _sphinx-contrib: https://bitbucket.org/birkenfeld/sphinx-contrib/
+.. _sphinx-contrib: https://github.com/sphinx-contrib
 
 .. _Ada: https://pypi.org/project/sphinxcontrib-adadomain/
 .. _Chapel: https://pypi.org/project/sphinxcontrib-chapeldomain/

From 7d1ea39d4319ac7641aa087f34ee4b47b5a80a00 Mon Sep 17 00:00:00 2001
From: Aaron Carlisle <carlisle.b3d@gmail.com>
Date: Thu, 1 Oct 2020 16:08:50 -0400
Subject: [PATCH 052/305] Makefiles: Include clean in help message

The make clean help command was missing from all make files.
---
 sphinx/cmd/make_mode.py                | 1 +
 sphinx/templates/quickstart/Makefile_t | 2 +-
 sphinx/templates/quickstart/make.bat_t | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/sphinx/cmd/make_mode.py b/sphinx/cmd/make_mode.py
index aff2ea7f537..1961d37d51b 100644
--- a/sphinx/cmd/make_mode.py
+++ b/sphinx/cmd/make_mode.py
@@ -51,6 +51,7 @@
     ("",      "doctest",     "to run all doctests embedded in the documentation "
                              "(if enabled)"),
     ("",      "coverage",    "to run coverage check of the documentation (if enabled)"),
+    ("",      "clean",       "to remove everything in the build directory"),
 ]
 
 
diff --git a/sphinx/templates/quickstart/Makefile_t b/sphinx/templates/quickstart/Makefile_t
index 7b656dff051..be1f44151f0 100644
--- a/sphinx/templates/quickstart/Makefile_t
+++ b/sphinx/templates/quickstart/Makefile_t
@@ -46,6 +46,7 @@ help:
 	@echo "  doctest     to run all doctests embedded in the documentation (if enabled)"
 	@echo "  coverage    to run coverage check of the documentation (if enabled)"
 	@echo "  dummy       to check syntax errors of document sources"
+	@echo "  clean       to remove everything in the build directory"
 
 .PHONY: clean
 clean:
@@ -94,4 +95,3 @@ gettext:
 .PHONY: Makefile
 %: Makefile
 	$(SPHINXBUILD) -b "$@" $(ALLSPHINXOPTS) "$(BUILDDIR)/$@"
-
diff --git a/sphinx/templates/quickstart/make.bat_t b/sphinx/templates/quickstart/make.bat_t
index 830cf656e34..9ac1fef4f11 100644
--- a/sphinx/templates/quickstart/make.bat_t
+++ b/sphinx/templates/quickstart/make.bat_t
@@ -43,6 +43,7 @@ if "%1" == "help" (
 	echo.  doctest    to run all doctests embedded in the documentation if enabled
 	echo.  coverage   to run coverage check of the documentation if enabled
 	echo.  dummy      to check syntax errors of document sources
+	echo.  clean      to remove everything in the build directory
 	goto end
 )
 
@@ -106,4 +107,3 @@ goto end
 
 :end
 popd
-

From 62d94729ab8060a67ac87e4976e608cdb1fa71da Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 3 Oct 2020 14:10:21 +0900
Subject: [PATCH 053/305] Fix missing module: warnings

---
 sphinx/builders/latex/__init__.py | 1 +
 sphinx/ext/autodoc/__init__.py    | 6 ------
 2 files changed, 1 insertion(+), 6 deletions(-)

diff --git a/sphinx/builders/latex/__init__.py b/sphinx/builders/latex/__init__.py
index 73d85d26996..34518c42da4 100644
--- a/sphinx/builders/latex/__init__.py
+++ b/sphinx/builders/latex/__init__.py
@@ -9,6 +9,7 @@
 """
 
 import os
+import warnings
 from os import path
 from typing import Any, Dict, Iterable, List, Tuple, Union
 
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index f850ad1de42..9325c0f4c10 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -1616,9 +1616,6 @@ def add_directive_header(self, sig: str) -> None:
             except KeyError:
                 # a broken class found (refs: https://github.com/sphinx-doc/sphinx/issues/8084)
                 annotations = {}
-            except AttributeError:
-                # AttributeError is raised on 3.5.2 (fixed by 3.5.3)
-                annotations = {}
 
             if self.objpath[-1] in annotations:
                 objrepr = stringify_typehint(annotations.get(self.objpath[-1]))
@@ -1995,9 +1992,6 @@ def add_directive_header(self, sig: str) -> None:
             except KeyError:
                 # a broken class found (refs: https://github.com/sphinx-doc/sphinx/issues/8084)
                 annotations = {}
-            except AttributeError:
-                # AttributeError is raised on 3.5.2 (fixed by 3.5.3)
-                annotations = {}
 
             if self.objpath[-1] in annotations:
                 objrepr = stringify_typehint(annotations.get(self.objpath[-1]))

From 11633f2e53bf01f6844256558444991836815690 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 4 Oct 2020 14:27:53 +0900
Subject: [PATCH 054/305] Update CHANGES for PR #8070

---
 CHANGES | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGES b/CHANGES
index eefd5384665..4702c75a4f6 100644
--- a/CHANGES
+++ b/CHANGES
@@ -34,6 +34,7 @@ Features added
   the location where the object is defined
 * #7784: i18n: The alt text for image is translated by default (without
   :confval:`gettext_additional_targets` setting)
+* #8070: html search: Support searching for 2characters word
 * #7830: Add debug logs for change detection of sources and templates
 * #8201: Emit a warning if toctree contains duplicated entries
 

From fcd62b9a6cae49dd6599c270de94f3ccd60882a1 Mon Sep 17 00:00:00 2001
From: Aaron Carlisle <carlisle.b3d@gmail.com>
Date: Mon, 5 Oct 2020 09:15:33 -0400
Subject: [PATCH 055/305] Makefiles: Include clean in help message

The make clean help command was missing from all make files.
---
 sphinx/cmd/make_mode.py                | 1 +
 sphinx/templates/quickstart/Makefile_t | 1 +
 sphinx/templates/quickstart/make.bat_t | 1 +
 3 files changed, 3 insertions(+)

diff --git a/sphinx/cmd/make_mode.py b/sphinx/cmd/make_mode.py
index aff2ea7f537..1961d37d51b 100644
--- a/sphinx/cmd/make_mode.py
+++ b/sphinx/cmd/make_mode.py
@@ -51,6 +51,7 @@
     ("",      "doctest",     "to run all doctests embedded in the documentation "
                              "(if enabled)"),
     ("",      "coverage",    "to run coverage check of the documentation (if enabled)"),
+    ("",      "clean",       "to remove everything in the build directory"),
 ]
 
 
diff --git a/sphinx/templates/quickstart/Makefile_t b/sphinx/templates/quickstart/Makefile_t
index 7b656dff051..8a71a928aa6 100644
--- a/sphinx/templates/quickstart/Makefile_t
+++ b/sphinx/templates/quickstart/Makefile_t
@@ -46,6 +46,7 @@ help:
 	@echo "  doctest     to run all doctests embedded in the documentation (if enabled)"
 	@echo "  coverage    to run coverage check of the documentation (if enabled)"
 	@echo "  dummy       to check syntax errors of document sources"
+	@echo "  clean       to remove everything in the build directory"
 
 .PHONY: clean
 clean:
diff --git a/sphinx/templates/quickstart/make.bat_t b/sphinx/templates/quickstart/make.bat_t
index 830cf656e34..e5d93d1aedd 100644
--- a/sphinx/templates/quickstart/make.bat_t
+++ b/sphinx/templates/quickstart/make.bat_t
@@ -43,6 +43,7 @@ if "%1" == "help" (
 	echo.  doctest    to run all doctests embedded in the documentation if enabled
 	echo.  coverage   to run coverage check of the documentation if enabled
 	echo.  dummy      to check syntax errors of document sources
+	echo.  clean      to remove everything in the build directory
 	goto end
 )
 

From 853e702a9813d44d7001a74773e10e500c926d2e Mon Sep 17 00:00:00 2001
From: Aaron Carlisle <carlisle.aaron00@gmail.com>
Date: Mon, 5 Oct 2020 09:17:52 -0400
Subject: [PATCH 056/305] Update make.bat_t

---
 sphinx/templates/quickstart/make.bat_t | 1 +
 1 file changed, 1 insertion(+)

diff --git a/sphinx/templates/quickstart/make.bat_t b/sphinx/templates/quickstart/make.bat_t
index 9ac1fef4f11..e5d93d1aedd 100644
--- a/sphinx/templates/quickstart/make.bat_t
+++ b/sphinx/templates/quickstart/make.bat_t
@@ -107,3 +107,4 @@ goto end
 
 :end
 popd
+

From 9e1ab793c6c2058406ed088a542ed0bf43940bb5 Mon Sep 17 00:00:00 2001
From: Aaron Carlisle <carlisle.aaron00@gmail.com>
Date: Mon, 5 Oct 2020 09:18:20 -0400
Subject: [PATCH 057/305] Update Makefile_t

---
 sphinx/templates/quickstart/Makefile_t | 1 +
 1 file changed, 1 insertion(+)

diff --git a/sphinx/templates/quickstart/Makefile_t b/sphinx/templates/quickstart/Makefile_t
index be1f44151f0..8a71a928aa6 100644
--- a/sphinx/templates/quickstart/Makefile_t
+++ b/sphinx/templates/quickstart/Makefile_t
@@ -95,3 +95,4 @@ gettext:
 .PHONY: Makefile
 %: Makefile
 	$(SPHINXBUILD) -b "$@" $(ALLSPHINXOPTS) "$(BUILDDIR)/$@"
+

From 18b2f2cdf224d2bc7ff1f6f647b31748702bbbcb Mon Sep 17 00:00:00 2001
From: Pradyun Gedam <3275593+pradyunsg@users.noreply.github.com>
Date: Wed, 21 Oct 2020 11:16:59 +0530
Subject: [PATCH 058/305] Reword section on Third Party Themes

- No longer attempt to be the location for listing themes -- only Sphinx-RTD-Theme was listed here.
- Mention the classifier used when searching on PyPI.
- Emphasize sphinx-themes.org as a gallery of themes.
---
 doc/usage/theming.rst | 39 ++++++++-------------------------------
 1 file changed, 8 insertions(+), 31 deletions(-)

diff --git a/doc/usage/theming.rst b/doc/usage/theming.rst
index fb06e87411c..fc135a09529 100644
--- a/doc/usage/theming.rst
+++ b/doc/usage/theming.rst
@@ -334,38 +334,15 @@ These themes are:
 Third Party Themes
 ~~~~~~~~~~~~~~~~~~
 
-.. cssclass:: longtable
-
-+--------------------+--------------------+
-| **Theme overview** |                    |
-+--------------------+--------------------+
-| |sphinx_rtd_theme| |                    |
-|                    |                    |
-| *sphinx_rtd_theme* |                    |
-+--------------------+--------------------+
-
-.. |sphinx_rtd_theme| image:: /_static/themes/sphinx_rtd_theme.png
-
-There are many third-party themes available. Some of these are general use,
-while others are specific to an individual project. A section of third-party
-themes is listed below. Many more can be found on PyPI__, GitHub__, GitLab__ and
-sphinx-themes.org__.
-
-.. cssclass:: clear
-
-**sphinx_rtd_theme**
-  `Read the Docs Sphinx Theme`_.
-  This is a mobile-friendly sphinx theme that was made for readthedocs.org.
-  View a working demo over on readthedocs.org. You can get install and options
-  information at `Read the Docs Sphinx Theme`_ page.
-
-  .. _Read the Docs Sphinx Theme: https://pypi.org/project/sphinx_rtd_theme/
-
-  .. versionchanged:: 1.4
-     **sphinx_rtd_theme** has become optional.
+There are many third-party themes available for Sphinx. Some of these are for
+general use, while others are specific to an individual project.
 
+sphinx-themes.org__ is a gallery that showcases various themes for Sphinx,
+with demo documentation rendered under each theme. Themes can also be found
+on PyPI__ (using the classifier ``Framework :: Sphinx :: Theme``), GitHub__
+and GitLab__.
 
+.. __: https://sphinx-themes.org/
 .. __: https://pypi.org/search/?q=&o=&c=Framework+%3A%3A+Sphinx+%3A%3A+Theme
-.. __: https://github.com/search?utf8=%E2%9C%93&q=sphinx+theme&type=
+.. __: https://github.com/search?utf8=%E2%9C%93&q=sphinx+theme
 .. __: https://gitlab.com/explore?name=sphinx+theme
-.. __: https://sphinx-themes.org/

From bfa12062a03db840322d389464d2319838da14d3 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 24 Oct 2020 18:18:08 +0900
Subject: [PATCH 059/305] Fix mypy violations

---
 sphinx/pycode/ast.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/sphinx/pycode/ast.py b/sphinx/pycode/ast.py
index 0ea6844ac50..e5b84600bad 100644
--- a/sphinx/pycode/ast.py
+++ b/sphinx/pycode/ast.py
@@ -157,12 +157,12 @@ def visit_Call(self, node: ast.Call) -> str:
                 ["%s=%s" % (k.arg, self.visit(k.value)) for k in node.keywords])
         return "%s(%s)" % (self.visit(node.func), ", ".join(args))
 
-    def visit_Constant(self, node: ast.Constant) -> str:
+    def visit_Constant(self, node: ast.Constant) -> str:  # type: ignore
         if node.value is Ellipsis:
             return "..."
         elif isinstance(node.value, (int, float, complex)):
             if self.code and sys.version_info > (3, 8):
-                return ast.get_source_segment(self.code, node)
+                return ast.get_source_segment(self.code, node)  # type: ignore
             else:
                 return repr(node.value)
         else:

From 9cd3e1a38925ee4db4b787ad81a2e3605aa5b15d Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 28 Oct 2020 01:44:18 +0900
Subject: [PATCH 060/305] Fix #8342: Emit a warning if a unknown domain is
 given for directive or role

Currently, Sphinx mention nothing if users use unknown domain in their
documents (ex. `.. unknown:directive::`, `:unknown:role` and so on).
This starts to warn them to be clear non acceptable mark-ups.

refs: #8342
---
 CHANGES                 | 3 +++
 sphinx/util/docutils.py | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/CHANGES b/CHANGES
index ee9fb422d1e..2701638331e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -41,6 +41,9 @@ Features added
 Bugs fixed
 ----------
 
+* #8342: Emit a warning if a unknown domain is given for directive or role (ex.
+  ``:unknown:doc:``)
+
 Testing
 --------
 
diff --git a/sphinx/util/docutils.py b/sphinx/util/docutils.py
index 161575cbd76..8ca38bac2e7 100644
--- a/sphinx/util/docutils.py
+++ b/sphinx/util/docutils.py
@@ -28,6 +28,7 @@
 from docutils.utils import Reporter, unescape
 
 from sphinx.errors import SphinxError
+from sphinx.locale import _
 from sphinx.util import logging
 from sphinx.util.typing import RoleFunction
 
@@ -208,6 +209,8 @@ def lookup_domain_element(self, type: str, name: str) -> Any:
                 element = getattr(domain, type)(name)
                 if element is not None:
                     return element, []
+            else:
+                logger.warning(_('unknown directive or role name: %s:%s'), domain_name, name)
         # else look in the default domain
         else:
             def_domain = self.env.temp_data.get('default_domain')

From a843fd3db8b588be93b576049a8a291bc4b3ec9d Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 4 Oct 2020 22:45:26 +0900
Subject: [PATCH 061/305] Close #7996: manpage: Make a section directory on
 build manpage by default

---
 CHANGES                     |  2 ++
 doc/usage/configuration.rst |  4 +++-
 sphinx/builders/manpage.py  |  2 +-
 tests/test_build_manpage.py | 12 ++++++------
 tests/test_smartquotes.py   |  4 ++--
 5 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/CHANGES b/CHANGES
index ee9fb422d1e..76468a8d744 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,8 @@ Incompatible changes
   MathJax configuration may have to set the old MathJax path or update their
   configuration for version 3. See :mod:`sphinx.ext.mathjax`.
 * #7784: i18n: The msgid for alt text of image is changed
+* #7996: manpage: Make a section directory on build manpage by default (see
+  :confval:`man_make_section_directory`)
 
 Deprecated
 ----------
diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index b4682dd21bd..075dbfe8ecf 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -2248,10 +2248,12 @@ These options influence manual page output.
 
 .. confval:: man_make_section_directory
 
-   If true, make a section directory on build man page.  Default is False.
+   If true, make a section directory on build man page.  Default is True.
 
    .. versionadded:: 3.3
+   .. versionchanged:: 4.0
 
+      The default is changed to ``False`` from ``True``.
 
 .. _texinfo-options:
 
diff --git a/sphinx/builders/manpage.py b/sphinx/builders/manpage.py
index 2a10ba62f63..442abb91586 100644
--- a/sphinx/builders/manpage.py
+++ b/sphinx/builders/manpage.py
@@ -120,7 +120,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
 
     app.add_config_value('man_pages', default_man_pages, None)
     app.add_config_value('man_show_urls', False, None)
-    app.add_config_value('man_make_section_directory', False, None)
+    app.add_config_value('man_make_section_directory', True, None)
 
     return {
         'version': 'builtin',
diff --git a/tests/test_build_manpage.py b/tests/test_build_manpage.py
index d4b1a320e84..0f026b19bec 100644
--- a/tests/test_build_manpage.py
+++ b/tests/test_build_manpage.py
@@ -17,9 +17,9 @@
 @pytest.mark.sphinx('man')
 def test_all(app, status, warning):
     app.builder.build_all()
-    assert (app.outdir / 'sphinxtests.1').exists()
+    assert (app.outdir / '1' / 'sphinxtests.1').exists()
 
-    content = (app.outdir / 'sphinxtests.1').read_text()
+    content = (app.outdir / '1' / 'sphinxtests.1').read_text()
     assert r'\fBprint \fP\fIi\fP\fB\en\fP' in content
     assert r'\fBmanpage\en\fP' in content
 
@@ -31,16 +31,16 @@ def test_all(app, status, warning):
 
 
 @pytest.mark.sphinx('man', testroot='basic',
-                    confoverrides={'man_make_section_directory': True})
+                    confoverrides={'man_make_section_directory': False})
 def test_man_make_section_directory(app, status, warning):
     app.build()
-    assert (app.outdir / '1' / 'python.1').exists()
+    assert (app.outdir / 'python.1').exists()
 
 
 @pytest.mark.sphinx('man', testroot='directive-code')
 def test_captioned_code_block(app, status, warning):
     app.builder.build_all()
-    content = (app.outdir / 'python.1').read_text()
+    content = (app.outdir / '1' / 'python.1').read_text()
 
     assert ('.sp\n'
             'caption \\fItest\\fP rb\n'
@@ -71,5 +71,5 @@ def test_default_man_pages():
 @pytest.mark.sphinx('man', testroot='markup-rubric')
 def test_rubric(app, status, warning):
     app.build()
-    content = (app.outdir / 'python.1').read_text()
+    content = (app.outdir / '1' / 'python.1').read_text()
     assert 'This is a rubric\n' in content
diff --git a/tests/test_smartquotes.py b/tests/test_smartquotes.py
index 697a7592c11..d4d31f4e847 100644
--- a/tests/test_smartquotes.py
+++ b/tests/test_smartquotes.py
@@ -31,7 +31,7 @@ def test_text_builder(app, status, warning):
 def test_man_builder(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'python.1').read_text()
+    content = (app.outdir / '1' / 'python.1').read_text()
     assert '\\-\\- "Sphinx" is a tool that makes it easy ...' in content
 
 
@@ -84,5 +84,5 @@ def test_smartquotes_excludes_language(app, status, warning):
 def test_smartquotes_excludes_builders(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'python.1').read_text()
+    content = (app.outdir / '1' / 'python.1').read_text()
     assert '– “Sphinx” is a tool that makes it easy …' in content

From 95f313eab718ec55da327179a8b25a52e080c97b Mon Sep 17 00:00:00 2001
From: Jon Dufresne <jon.dufresne@gmail.com>
Date: Sun, 1 Nov 2020 08:25:22 -0800
Subject: [PATCH 062/305] Test and document support for Python 3.9 release

---
 .travis.yml | 2 +-
 setup.py    | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 47f5bdb11ca..fdeec011268 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -21,7 +21,7 @@ jobs:
       env:
         - TOXENV=du16
         - PYTEST_ADDOPTS="--cov ./ --cov-append --cov-config setup.cfg"
-    - python: '3.9-dev'
+    - python: '3.9'
       env:
         - TOXENV=py39
 
diff --git a/setup.py b/setup.py
index bf3d7dc6ec0..a5f48afa607 100644
--- a/setup.py
+++ b/setup.py
@@ -202,6 +202,7 @@ def _run_domain_js(self, domain):
         'Programming Language :: Python :: 3.6',
         'Programming Language :: Python :: 3.7',
         'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
         'Programming Language :: Python :: Implementation :: CPython',
         'Programming Language :: Python :: Implementation :: PyPy',
         'Framework :: Setuptools Plugin',

From 6d5e43a0ffc99830c91e37c026d89a6d70fe52c8 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 6 Nov 2020 01:36:04 +0900
Subject: [PATCH 063/305] Drop code for supporting py35

---
 sphinx/domains/python.py               | 12 ++++-----
 sphinx/pycode/parser.py                |  9 ++-----
 tests/test_ext_autodoc.py              | 37 +++++++++-----------------
 tests/test_ext_autodoc_autofunction.py | 27 +++++++------------
 tests/test_pycode_parser.py            |  3 +--
 tests/test_util_inspect.py             |  5 +---
 6 files changed, 32 insertions(+), 61 deletions(-)

diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 03edce922c7..fb00b8dad2d 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -102,6 +102,11 @@ def _parse_annotation(annotation: str, env: BuildEnvironment = None) -> List[Nod
     def unparse(node: ast.AST) -> List[Node]:
         if isinstance(node, ast.Attribute):
             return [nodes.Text("%s.%s" % (unparse(node.value)[0], node.attr))]
+        elif isinstance(node, ast.Constant):  # type: ignore
+            if node.value is Ellipsis:
+                return [addnodes.desc_sig_punctuation('', "...")]
+            else:
+                return [nodes.Text(node.value)]
         elif isinstance(node, ast.Expr):
             return unparse(node.value)
         elif isinstance(node, ast.Index):
@@ -137,13 +142,6 @@ def unparse(node: ast.AST) -> List[Node]:
 
             return result
         else:
-            if sys.version_info >= (3, 6):
-                if isinstance(node, ast.Constant):  # type: ignore
-                    if node.value is Ellipsis:
-                        return [addnodes.desc_sig_punctuation('', "...")]
-                    else:
-                        return [nodes.Text(node.value)]
-
             if sys.version_info < (3, 8):
                 if isinstance(node, ast.Ellipsis):
                     return [addnodes.desc_sig_punctuation('', "...")]
diff --git a/sphinx/pycode/parser.py b/sphinx/pycode/parser.py
index a417b5a1b26..78715f7777f 100644
--- a/sphinx/pycode/parser.py
+++ b/sphinx/pycode/parser.py
@@ -27,12 +27,6 @@
 emptyline_re = re.compile('^\\s*(#.*)?$')
 
 
-if sys.version_info >= (3, 6):
-    ASSIGN_NODES = (ast.Assign, ast.AnnAssign)
-else:
-    ASSIGN_NODES = (ast.Assign)
-
-
 def filter_whitespace(code: str) -> str:
     return code.replace('\f', ' ')  # replace FF (form feed) with whitespace
 
@@ -408,7 +402,8 @@ def visit_AnnAssign(self, node: ast.AnnAssign) -> None:
 
     def visit_Expr(self, node: ast.Expr) -> None:
         """Handles Expr node and pick up a comment if string."""
-        if (isinstance(self.previous, ASSIGN_NODES) and isinstance(node.value, ast.Str)):
+        if (isinstance(self.previous, (ast.Assign, ast.AnnAssign)) and
+                isinstance(node.value, ast.Str)):
             try:
                 targets = get_assign_targets(self.previous)
                 varnames = get_lvar_names(targets[0], self.get_self())
diff --git a/tests/test_ext_autodoc.py b/tests/test_ext_autodoc.py
index 703cc13f6a8..bc3d07660dd 100644
--- a/tests/test_ext_autodoc.py
+++ b/tests/test_ext_autodoc.py
@@ -290,7 +290,6 @@ def foo3(self, d='\n'):
         '(b, c=42, *d, **e)'
 
 
-@pytest.mark.skipif(sys.version_info < (3, 5), reason='typing is available since python3.5.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodoc_process_signature_typing_generic(app):
     actual = do_autodoc(app, 'class', 'target.generic_class.A', {})
@@ -1559,7 +1558,6 @@ def test_partialmethod_undoc_members(app):
     assert list(actual) == expected
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='py36+ is available since python3.6.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodoc_typed_instance_variables(app):
     options = {"members": None,
@@ -1653,7 +1651,6 @@ def test_autodoc_typed_instance_variables(app):
     ]
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='py36+ is available since python3.6.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodoc_typed_inherited_instance_variables(app):
     options = {"members": None,
@@ -1783,7 +1780,6 @@ def test_autodoc_Annotated(app):
     ]
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='py36+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodoc_TYPE_CHECKING(app):
     options = {"members": None,
@@ -1832,26 +1828,19 @@ def test_autodoc_for_egged_code(app):
 def test_singledispatch(app):
     options = {"members": None}
     actual = do_autodoc(app, 'module', 'target.singledispatch', options)
-    if sys.version_info < (3, 6):
-        # check the result via "in" because the order of singledispatch signatures is
-        # usually changed (because dict is not OrderedDict yet!)
-        assert '.. py:function:: func(arg, kwarg=None)' in actual
-        assert '                 func(arg: int, kwarg=None)' in actual
-        assert '                 func(arg: str, kwarg=None)' in actual
-    else:
-        assert list(actual) == [
-            '',
-            '.. py:module:: target.singledispatch',
-            '',
-            '',
-            '.. py:function:: func(arg, kwarg=None)',
-            '                 func(arg: int, kwarg=None)',
-            '                 func(arg: str, kwarg=None)',
-            '   :module: target.singledispatch',
-            '',
-            '   A function for general use.',
-            '',
-        ]
+    assert list(actual) == [
+        '',
+        '.. py:module:: target.singledispatch',
+        '',
+        '',
+        '.. py:function:: func(arg, kwarg=None)',
+        '                 func(arg: int, kwarg=None)',
+        '                 func(arg: str, kwarg=None)',
+        '   :module: target.singledispatch',
+        '',
+        '   A function for general use.',
+        '',
+    ]
 
 
 @pytest.mark.skipif(sys.version_info < (3, 8),
diff --git a/tests/test_ext_autodoc_autofunction.py b/tests/test_ext_autodoc_autofunction.py
index 3c8165995c7..4d69442527a 100644
--- a/tests/test_ext_autodoc_autofunction.py
+++ b/tests/test_ext_autodoc_autofunction.py
@@ -118,23 +118,16 @@ def test_decorated(app):
 def test_singledispatch(app):
     options = {}
     actual = do_autodoc(app, 'function', 'target.singledispatch.func', options)
-    if sys.version_info < (3, 6):
-        # check the result via "in" because the order of singledispatch signatures is
-        # usually changed (because dict is not OrderedDict yet!)
-        assert '.. py:function:: func(arg, kwarg=None)' in actual
-        assert '                 func(arg: int, kwarg=None)' in actual
-        assert '                 func(arg: str, kwarg=None)' in actual
-    else:
-        assert list(actual) == [
-            '',
-            '.. py:function:: func(arg, kwarg=None)',
-            '                 func(arg: int, kwarg=None)',
-            '                 func(arg: str, kwarg=None)',
-            '   :module: target.singledispatch',
-            '',
-            '   A function for general use.',
-            '',
-        ]
+    assert list(actual) == [
+        '',
+        '.. py:function:: func(arg, kwarg=None)',
+        '                 func(arg: int, kwarg=None)',
+        '                 func(arg: str, kwarg=None)',
+        '   :module: target.singledispatch',
+        '',
+        '   A function for general use.',
+        '',
+    ]
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
diff --git a/tests/test_pycode_parser.py b/tests/test_pycode_parser.py
index 71847f04f57..2ef3c2311ed 100644
--- a/tests/test_pycode_parser.py
+++ b/tests/test_pycode_parser.py
@@ -95,8 +95,7 @@ def test_comment_picker_location():
                                ('Foo', 'attr3'): 'comment for attr3(3)'}
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='tests for py36+ syntax')
-def test_annotated_assignment_py36():
+def test_annotated_assignment():
     source = ('a: str = "Sphinx"  #: comment\n'
               'b: int = 1\n'
               '"""string on next line"""\n'
diff --git a/tests/test_util_inspect.py b/tests/test_util_inspect.py
index c21eaaa1671..58aa2198418 100644
--- a/tests/test_util_inspect.py
+++ b/tests/test_util_inspect.py
@@ -220,10 +220,7 @@ def test_signature_annotations():
 
     # type hints by string
     sig = inspect.signature(Node.children)
-    if (3, 5, 0) <= sys.version_info < (3, 5, 3):
-        assert stringify_signature(sig) == '(self) -> List[Node]'
-    else:
-        assert stringify_signature(sig) == '(self) -> List[typing_test_data.Node]'
+    assert stringify_signature(sig) == '(self) -> List[typing_test_data.Node]'
 
     sig = inspect.signature(Node.__init__)
     assert stringify_signature(sig) == '(self, parent: Optional[Node]) -> None'

From b1caecda3954d9128509fb9830a81ecb68be65b0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fran=C3=A7ois=20Freitag?= <mail@franek.fr>
Date: Sat, 7 Nov 2020 11:53:30 +0100
Subject: [PATCH 064/305] Remove additional mentions of Python 3.5

---
 setup.py               | 2 +-
 sphinx/util/inspect.py | 2 +-
 sphinx/util/typing.py  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup.py b/setup.py
index a5f48afa607..dcd79630d14 100644
--- a/setup.py
+++ b/setup.py
@@ -51,7 +51,7 @@
         'pytest',
         'pytest-cov',
         'html5lib',
-        'typed_ast',  # for py35-37
+        'typed_ast',  # for py36-37
         'cython',
     ],
 }
diff --git a/sphinx/util/inspect.py b/sphinx/util/inspect.py
index 75cc5c6007f..ca82186eee4 100644
--- a/sphinx/util/inspect.py
+++ b/sphinx/util/inspect.py
@@ -271,7 +271,7 @@ def is_singledispatch_method(obj: Any) -> bool:
     try:
         from functools import singledispatchmethod  # type: ignore
         return isinstance(obj, singledispatchmethod)
-    except ImportError:  # py35-37
+    except ImportError:  # py36-37
         return False
 
 
diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py
index c4a145818c2..f77c3300ba4 100644
--- a/sphinx/util/typing.py
+++ b/sphinx/util/typing.py
@@ -22,7 +22,7 @@
     from typing import _ForwardRef  # type: ignore
 
     class ForwardRef:
-        """A pseudo ForwardRef class for py35 and py36."""
+        """A pseudo ForwardRef class for py36."""
         def __init__(self, arg: Any, is_argument: bool = True) -> None:
             self.arg = arg
 

From 342c808af3195f03fa6f816e0cca7ea1f48b3705 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fran=C3=A7ois=20Freitag?= <mail@franek.fr>
Date: Sat, 7 Nov 2020 13:32:37 +0100
Subject: [PATCH 065/305] Fix flake8 issue

---
 sphinx/pycode/parser.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/sphinx/pycode/parser.py b/sphinx/pycode/parser.py
index 78715f7777f..2d454cc96a9 100644
--- a/sphinx/pycode/parser.py
+++ b/sphinx/pycode/parser.py
@@ -10,7 +10,6 @@
 import inspect
 import itertools
 import re
-import sys
 import tokenize
 from collections import OrderedDict
 from inspect import Signature

From 339cab76579ee2b9b0c6ed85cdf3f89afe589067 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 8 Nov 2020 17:15:00 +0900
Subject: [PATCH 066/305] Fix #8380: html search: search results are wrapped
 with <p> instead of <div>

---
 CHANGES                                   | 3 +++
 sphinx/themes/basic/static/basic.css_t    | 2 +-
 sphinx/themes/basic/static/searchtools.js | 2 +-
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 208bd271573..3b18e13ec6e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -18,6 +18,8 @@ Incompatible changes
 * #7784: i18n: The msgid for alt text of image is changed
 * #7996: manpage: Make a section directory on build manpage by default (see
   :confval:`man_make_section_directory`)
+* #8380: html search: search results are wrapped with ``<p>`` instead of
+  ``<div>``
 
 Deprecated
 ----------
@@ -43,6 +45,7 @@ Features added
 Bugs fixed
 ----------
 
+* #8380: html search: Paragraphs in search results are not identified as ``<p>``
 * #8342: Emit a warning if a unknown domain is given for directive or role (ex.
   ``:unknown:doc:``)
 
diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index 38b9fb5539a..64fb93fd895 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -130,7 +130,7 @@ ul.search li a {
     font-weight: bold;
 }
 
-ul.search li div.context {
+ul.search li p.context {
     color: #888;
     margin: 2px 0 0 30px;
     text-align: left;
diff --git a/sphinx/themes/basic/static/searchtools.js b/sphinx/themes/basic/static/searchtools.js
index 261ecaa9282..1a171e0c67b 100644
--- a/sphinx/themes/basic/static/searchtools.js
+++ b/sphinx/themes/basic/static/searchtools.js
@@ -501,7 +501,7 @@ var Search = {
     var excerpt = ((start > 0) ? '...' : '') +
       $.trim(text.substr(start, 240)) +
       ((start + 240 - text.length) ? '...' : '');
-    var rv = $('<div class="context"></div>').text(excerpt);
+    var rv = $('<p class="context"></div>').text(excerpt);
     $.each(hlwords, function() {
       rv = rv.highlightText(this, 'highlighted');
     });

From 4ccbd083c62e3fb82cf47b89272fd26377932f2c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 9 Nov 2020 02:51:59 +0900
Subject: [PATCH 067/305] Drop code for py35

---
 sphinx/util/typing.py | 63 +++++++------------------------------------
 1 file changed, 10 insertions(+), 53 deletions(-)

diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py
index 888c4dcd1eb..ab02f1f6b3a 100644
--- a/sphinx/util/typing.py
+++ b/sphinx/util/typing.py
@@ -151,7 +151,7 @@ def _restify_py36(cls: Optional["Type"]) -> str:
         qualname = repr(cls)
 
     if (isinstance(cls, typing.TupleMeta) and  # type: ignore
-            not hasattr(cls, '__tuple_params__')):  # for Python 3.6
+            not hasattr(cls, '__tuple_params__')):
         params = cls.__args__
         if params:
             param_str = ', '.join(restify(p) for p in params)
@@ -159,40 +159,22 @@ def _restify_py36(cls: Optional["Type"]) -> str:
         else:
             return ':class:`%s`' % qualname
     elif isinstance(cls, typing.GenericMeta):
-        params = None
-        if hasattr(cls, '__args__'):
-            # for Python 3.5.2+
-            if cls.__args__ is None or len(cls.__args__) <= 2:  # type: ignore  # NOQA
-                params = cls.__args__  # type: ignore
-            elif cls.__origin__ == Generator:  # type: ignore
-                params = cls.__args__  # type: ignore
-            else:  # typing.Callable
-                args = ', '.join(restify(arg) for arg in cls.__args__[:-1])  # type: ignore
-                result = restify(cls.__args__[-1])  # type: ignore
-                return ':class:`%s`\\ [[%s], %s]' % (qualname, args, result)
-        elif hasattr(cls, '__parameters__'):
-            # for Python 3.5.0 and 3.5.1
-            params = cls.__parameters__  # type: ignore
+        if cls.__args__ is None or len(cls.__args__) <= 2:  # type: ignore  # NOQA
+            params = cls.__args__  # type: ignore
+        elif cls.__origin__ == Generator:  # type: ignore
+            params = cls.__args__  # type: ignore
+        else:  # typing.Callable
+            args = ', '.join(restify(arg) for arg in cls.__args__[:-1])  # type: ignore
+            result = restify(cls.__args__[-1])  # type: ignore
+            return ':class:`%s`\\ [[%s], %s]' % (qualname, args, result)
 
         if params:
             param_str = ', '.join(restify(p) for p in params)
             return ':class:`%s`\\ [%s]' % (qualname, param_str)
         else:
             return ':class:`%s`' % qualname
-    elif (hasattr(typing, 'UnionMeta') and
-            isinstance(cls, typing.UnionMeta) and  # type: ignore
-            hasattr(cls, '__union_params__')):  # for Python 3.5
-        params = cls.__union_params__
-        if params is not None:
-            if len(params) == 2 and params[1] is NoneType:
-                return ':obj:`Optional`\\ [%s]' % restify(params[0])
-            else:
-                param_str = ', '.join(restify(p) for p in params)
-                return ':obj:`%s`\\ [%s]' % (qualname, param_str)
-        else:
-            return ':obj:`%s`' % qualname
     elif (hasattr(cls, '__origin__') and
-          cls.__origin__ is typing.Union):  # for Python 3.5.2+
+          cls.__origin__ is typing.Union):
         params = cls.__args__
         if params is not None:
             if len(params) > 1 and params[-1] is NoneType:
@@ -206,31 +188,6 @@ def _restify_py36(cls: Optional["Type"]) -> str:
                 return ':obj:`Union`\\ [%s]' % param_str
         else:
             return ':obj:`Union`'
-    elif (isinstance(cls, typing.CallableMeta) and  # type: ignore
-          getattr(cls, '__args__', None) is not None and
-          hasattr(cls, '__result__')):  # for Python 3.5
-        # Skipped in the case of plain typing.Callable
-        args = cls.__args__
-        if args is None:
-            return qualname
-        elif args is Ellipsis:
-            args_str = '...'
-        else:
-            formatted_args = (restify(a) for a in args)  # type: ignore
-            args_str = '[%s]' % ', '.join(formatted_args)
-
-        return ':class:`%s`\\ [%s, %s]' % (qualname, args_str, stringify(cls.__result__))
-    elif (isinstance(cls, typing.TupleMeta) and  # type: ignore
-          hasattr(cls, '__tuple_params__') and
-          hasattr(cls, '__tuple_use_ellipsis__')):  # for Python 3.5
-        params = cls.__tuple_params__
-        if params is not None:
-            param_strings = [restify(p) for p in params]
-            if cls.__tuple_use_ellipsis__:
-                param_strings.append('...')
-            return ':class:`%s`\\ [%s]' % (qualname, ', '.join(param_strings))
-        else:
-            return ':class:`%s`' % qualname
     elif hasattr(cls, '__qualname__'):
         if cls.__module__ == 'typing':
             return ':class:`%s`' % cls.__qualname__

From 5533724d74a09060ff8cc07078f82cedc8a947ac Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 10 Nov 2020 23:32:54 +0900
Subject: [PATCH 068/305] Do test with Ubuntu 18.04

Sphinx-4.0 will drop support for Ubuntu 16.04.  So CI Platform should be
also updated to Ubuntu 18.04.
---
 .github/workflows/main.yml | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 9e4dd2ade45..a63a76a7fab 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -4,12 +4,11 @@ on: [push, pull_request]
 
 jobs:
   ubuntu:
-    runs-on: ${{ matrix.os }}
+    runs-on: ubuntu-18.04
     strategy:
       fail-fast: false
       matrix:
-        name: [py36, py37, py38, py39]
-        os: [ubuntu-16.04]
+        name: [py36, py37, py38, py39, py310-dev]
         include:
         - name: py36
           python: 3.6
@@ -27,7 +26,6 @@ jobs:
         - name: py310-dev
           python: 3.10-dev
           docutils: du16
-          os: ubuntu-latest  # required
     env:
       PYTEST_ADDOPTS: ${{ matrix.coverage }}
 

From b718aef7d876ca6a9e08fc225f8f2031845083a4 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 12 Nov 2020 02:52:50 +0900
Subject: [PATCH 069/305] Do isort

---
 sphinx/__init__.py                        | 1 -
 sphinx/addnodes.py                        | 3 +--
 sphinx/builders/__init__.py               | 3 +--
 sphinx/builders/gettext.py                | 2 +-
 sphinx/builders/html/__init__.py          | 1 -
 sphinx/builders/xml.py                    | 1 -
 sphinx/directives/code.py                 | 3 +--
 sphinx/domains/index.py                   | 3 +--
 sphinx/domains/math.py                    | 3 +--
 sphinx/domains/python.py                  | 1 -
 sphinx/environment/collectors/__init__.py | 3 +--
 sphinx/environment/collectors/toctree.py  | 1 -
 sphinx/events.py                          | 3 +--
 sphinx/ext/autodoc/directive.py           | 1 -
 sphinx/ext/autosummary/__init__.py        | 1 -
 sphinx/ext/autosummary/generate.py        | 1 -
 sphinx/ext/doctest.py                     | 4 ++--
 sphinx/ext/napoleon/docstring.py          | 1 -
 sphinx/extension.py                       | 3 +--
 sphinx/io.py                              | 3 +--
 sphinx/jinja2glue.py                      | 3 +--
 sphinx/parsers.py                         | 3 +--
 sphinx/registry.py                        | 3 +--
 sphinx/roles.py                           | 3 +--
 sphinx/theming.py                         | 3 +--
 sphinx/transforms/__init__.py             | 3 +--
 sphinx/transforms/i18n.py                 | 3 +--
 sphinx/transforms/references.py           | 3 +--
 sphinx/util/__init__.py                   | 2 --
 sphinx/util/compat.py                     | 3 +--
 sphinx/util/fileutil.py                   | 3 +--
 sphinx/util/i18n.py                       | 3 +--
 sphinx/util/pycompat.py                   | 1 -
 sphinx/versioning.py                      | 3 +--
 34 files changed, 24 insertions(+), 57 deletions(-)

diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index 574ede34617..bb84d0d1799 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -19,7 +19,6 @@
 
 from .deprecation import RemovedInNextVersionWarning
 
-
 # by default, all DeprecationWarning under sphinx package will be emit.
 # Users can avoid this by using environment variable: PYTHONWARNINGS=
 if 'PYTHONWARNINGS' not in os.environ:
diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 5b3dc08c504..0ad07aa5f6a 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -8,8 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 
-from typing import Any, Dict, List, Sequence
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, List, Sequence
 
 from docutils import nodes
 from docutils.nodes import Element
diff --git a/sphinx/builders/__init__.py b/sphinx/builders/__init__.py
index f161dcf7168..2e7add5db81 100644
--- a/sphinx/builders/__init__.py
+++ b/sphinx/builders/__init__.py
@@ -11,8 +11,7 @@
 import pickle
 import time
 from os import path
-from typing import Any, Dict, Iterable, List, Sequence, Set, Tuple, Type, Union
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Sequence, Set, Tuple, Type, Union
 
 from docutils import nodes
 from docutils.nodes import Node
diff --git a/sphinx/builders/gettext.py b/sphinx/builders/gettext.py
index a5ba822dbc6..439c8512df8 100644
--- a/sphinx/builders/gettext.py
+++ b/sphinx/builders/gettext.py
@@ -13,7 +13,7 @@
 from datetime import datetime, timedelta, tzinfo
 from os import getenv, path, walk
 from time import time
-from typing import Any, DefaultDict, Dict, Iterable, Generator, List, Set, Tuple, Union
+from typing import Any, DefaultDict, Dict, Generator, Iterable, List, Set, Tuple, Union
 from uuid import uuid4
 
 from docutils import nodes
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index bea13045fb2..0af5dde286b 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -47,7 +47,6 @@
 from sphinx.util.tags import Tags
 from sphinx.writers.html import HTMLTranslator, HTMLWriter
 
-
 # HTML5 Writer is available or not
 if is_html5_writer_available():
     from sphinx.writers.html5 import HTML5Translator
diff --git a/sphinx/builders/xml.py b/sphinx/builders/xml.py
index 65d29b3ca8f..e6964f338e2 100644
--- a/sphinx/builders/xml.py
+++ b/sphinx/builders/xml.py
@@ -23,7 +23,6 @@
 from sphinx.util.osutil import ensuredir, os_path
 from sphinx.writers.xml import PseudoXMLWriter, XMLWriter
 
-
 logger = logging.getLogger(__name__)
 
 
diff --git a/sphinx/directives/code.py b/sphinx/directives/code.py
index 275ca1b2d16..116cc6c41b8 100644
--- a/sphinx/directives/code.py
+++ b/sphinx/directives/code.py
@@ -8,8 +8,7 @@
 
 import sys
 from difflib import unified_diff
-from typing import Any, Dict, List, Tuple
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, List, Tuple
 
 from docutils import nodes
 from docutils.nodes import Element, Node
diff --git a/sphinx/domains/index.py b/sphinx/domains/index.py
index 16963f2d1db..840b417c235 100644
--- a/sphinx/domains/index.py
+++ b/sphinx/domains/index.py
@@ -8,8 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 
-from typing import Any, Dict, Iterable, List, Tuple
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Tuple
 
 from docutils import nodes
 from docutils.nodes import Node, system_message
diff --git a/sphinx/domains/math.py b/sphinx/domains/math.py
index 5b6062ecbcf..30ba5b66d53 100644
--- a/sphinx/domains/math.py
+++ b/sphinx/domains/math.py
@@ -8,8 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 
-from typing import Any, Dict, Iterable, List, Tuple
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Tuple
 
 from docutils import nodes
 from docutils.nodes import Element, Node, make_id, system_message
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 0fc5e996114..d71a4891da1 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -40,7 +40,6 @@
 from sphinx.util.nodes import make_id, make_refnode
 from sphinx.util.typing import TextlikeNode
 
-
 logger = logging.getLogger(__name__)
 
 
diff --git a/sphinx/environment/collectors/__init__.py b/sphinx/environment/collectors/__init__.py
index 2dd33c767c4..20035db71c3 100644
--- a/sphinx/environment/collectors/__init__.py
+++ b/sphinx/environment/collectors/__init__.py
@@ -8,8 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 
-from typing import Dict, List, Set
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Dict, List, Set
 
 from docutils import nodes
 
diff --git a/sphinx/environment/collectors/toctree.py b/sphinx/environment/collectors/toctree.py
index 995685d75d0..13ab2498c31 100644
--- a/sphinx/environment/collectors/toctree.py
+++ b/sphinx/environment/collectors/toctree.py
@@ -22,7 +22,6 @@
 from sphinx.transforms import SphinxContentsFilter
 from sphinx.util import logging, url_re
 
-
 N = TypeVar('N')
 
 logger = logging.getLogger(__name__)
diff --git a/sphinx/events.py b/sphinx/events.py
index 59d38daf05c..1ffb11561cb 100644
--- a/sphinx/events.py
+++ b/sphinx/events.py
@@ -12,8 +12,7 @@
 
 from collections import defaultdict
 from operator import attrgetter
-from typing import Any, Callable, Dict, List, NamedTuple, Tuple, Type
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, NamedTuple, Tuple, Type
 
 from sphinx.errors import ExtensionError, SphinxError
 from sphinx.locale import __
diff --git a/sphinx/ext/autodoc/directive.py b/sphinx/ext/autodoc/directive.py
index 5543059cb7d..604a9d51d85 100644
--- a/sphinx/ext/autodoc/directive.py
+++ b/sphinx/ext/autodoc/directive.py
@@ -21,7 +21,6 @@
 from sphinx.util.docutils import SphinxDirective, switch_source_input
 from sphinx.util.nodes import nested_parse_with_titles
 
-
 logger = logging.getLogger(__name__)
 
 
diff --git a/sphinx/ext/autosummary/__init__.py b/sphinx/ext/autosummary/__init__.py
index 4983496d504..fce5439b26e 100644
--- a/sphinx/ext/autosummary/__init__.py
+++ b/sphinx/ext/autosummary/__init__.py
@@ -87,7 +87,6 @@
 from sphinx.util.matching import Matcher
 from sphinx.writers.html import HTMLTranslator
 
-
 logger = logging.getLogger(__name__)
 
 
diff --git a/sphinx/ext/autosummary/generate.py b/sphinx/ext/autosummary/generate.py
index 1769b837e1f..a098177a44b 100644
--- a/sphinx/ext/autosummary/generate.py
+++ b/sphinx/ext/autosummary/generate.py
@@ -49,7 +49,6 @@
 from sphinx.util.osutil import ensuredir
 from sphinx.util.template import SphinxTemplateLoader
 
-
 logger = logging.getLogger(__name__)
 
 
diff --git a/sphinx/ext/doctest.py b/sphinx/ext/doctest.py
index 2a82261960b..76da36bbefe 100644
--- a/sphinx/ext/doctest.py
+++ b/sphinx/ext/doctest.py
@@ -15,8 +15,8 @@
 import time
 from io import StringIO
 from os import path
-from typing import Any, Callable, Dict, Iterable, List, Sequence, Set, Tuple, Type
-from typing import TYPE_CHECKING
+from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Sequence, Set, Tuple,
+                    Type)
 
 from docutils import nodes
 from docutils.nodes import Element, Node, TextElement
diff --git a/sphinx/ext/napoleon/docstring.py b/sphinx/ext/napoleon/docstring.py
index ca50635a903..dd1a50ea944 100644
--- a/sphinx/ext/napoleon/docstring.py
+++ b/sphinx/ext/napoleon/docstring.py
@@ -22,7 +22,6 @@
 from sphinx.locale import _, __
 from sphinx.util import logging
 
-
 logger = logging.getLogger(__name__)
 
 _directive_regex = re.compile(r'\.\. \S+::')
diff --git a/sphinx/extension.py b/sphinx/extension.py
index 98efc48feed..6954842321e 100644
--- a/sphinx/extension.py
+++ b/sphinx/extension.py
@@ -8,8 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 
-from typing import Any, Dict
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict
 
 from sphinx.config import Config
 from sphinx.errors import VersionRequirementError
diff --git a/sphinx/io.py b/sphinx/io.py
index 6255dbc661b..df5aff58da4 100644
--- a/sphinx/io.py
+++ b/sphinx/io.py
@@ -8,8 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 import codecs
-from typing import Any, List, Type
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, List, Type
 
 from docutils import nodes
 from docutils.core import Publisher
diff --git a/sphinx/jinja2glue.py b/sphinx/jinja2glue.py
index ab9a7d79924..3b0dfba90e3 100644
--- a/sphinx/jinja2glue.py
+++ b/sphinx/jinja2glue.py
@@ -10,8 +10,7 @@
 
 from os import path
 from pprint import pformat
-from typing import Any, Callable, Dict, Iterator, List, Tuple, Union
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Tuple, Union
 
 from jinja2 import BaseLoader, FileSystemLoader, TemplateNotFound, contextfunction
 from jinja2.environment import Environment
diff --git a/sphinx/parsers.py b/sphinx/parsers.py
index fc400e5c7d3..47debcf492b 100644
--- a/sphinx/parsers.py
+++ b/sphinx/parsers.py
@@ -9,8 +9,7 @@
 """
 
 import warnings
-from typing import Any, Dict, List, Type, Union
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, List, Type, Union
 
 import docutils.parsers
 import docutils.parsers.rst
diff --git a/sphinx/registry.py b/sphinx/registry.py
index 541fef1b397..56b4595892c 100644
--- a/sphinx/registry.py
+++ b/sphinx/registry.py
@@ -11,8 +11,7 @@
 import traceback
 from importlib import import_module
 from types import MethodType
-from typing import Any, Callable, Dict, Iterator, List, Tuple, Type, Union
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Tuple, Type, Union
 
 from docutils import nodes
 from docutils.io import Input
diff --git a/sphinx/roles.py b/sphinx/roles.py
index 426a62e903f..2fe27a5a858 100644
--- a/sphinx/roles.py
+++ b/sphinx/roles.py
@@ -9,8 +9,7 @@
 """
 
 import re
-from typing import Any, Dict, List, Tuple, Type
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, List, Tuple, Type
 
 from docutils import nodes, utils
 from docutils.nodes import Element, Node, TextElement, system_message
diff --git a/sphinx/theming.py b/sphinx/theming.py
index c05d87407df..0ac3613cc7e 100644
--- a/sphinx/theming.py
+++ b/sphinx/theming.py
@@ -13,8 +13,7 @@
 import shutil
 import tempfile
 from os import path
-from typing import Any, Dict, List
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, List
 from zipfile import ZipFile
 
 import pkg_resources
diff --git a/sphinx/transforms/__init__.py b/sphinx/transforms/__init__.py
index 1dbdb94f7a7..ebc332da1dd 100644
--- a/sphinx/transforms/__init__.py
+++ b/sphinx/transforms/__init__.py
@@ -9,8 +9,7 @@
 """
 
 import re
-from typing import Any, Dict, Generator, List, Tuple
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, Generator, List, Tuple
 
 from docutils import nodes
 from docutils.nodes import Element, Node, Text
diff --git a/sphinx/transforms/i18n.py b/sphinx/transforms/i18n.py
index 8dc72f8da00..96b35ac6084 100644
--- a/sphinx/transforms/i18n.py
+++ b/sphinx/transforms/i18n.py
@@ -10,8 +10,7 @@
 
 from os import path
 from textwrap import indent
-from typing import Any, Dict, List, Tuple, Type, TypeVar
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, List, Tuple, Type, TypeVar
 
 from docutils import nodes
 from docutils.io import StringInput
diff --git a/sphinx/transforms/references.py b/sphinx/transforms/references.py
index 372d06470f4..e5ff91ee6cb 100644
--- a/sphinx/transforms/references.py
+++ b/sphinx/transforms/references.py
@@ -8,8 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 
-from typing import Any, Dict
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict
 
 from docutils.transforms.references import DanglingReferences
 
diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index 392fcdf5c4c..1e753654180 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -26,7 +26,6 @@
                     Set, Tuple, Type)
 from urllib.parse import parse_qsl, quote_plus, urlencode, urlsplit, urlunsplit
 
-
 from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.errors import ExtensionError, FiletypeNotFoundError, SphinxParallelError
 from sphinx.locale import __
@@ -42,7 +41,6 @@
                                 movefile, mtimes_of_files, os_path, relative_uri)
 from sphinx.util.typing import PathMatcher
 
-
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
diff --git a/sphinx/util/compat.py b/sphinx/util/compat.py
index 6893efaf9eb..26de3c8f2e1 100644
--- a/sphinx/util/compat.py
+++ b/sphinx/util/compat.py
@@ -9,8 +9,7 @@
 """
 
 import sys
-from typing import Any, Dict
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
diff --git a/sphinx/util/fileutil.py b/sphinx/util/fileutil.py
index 2f878a57862..8801eb91346 100644
--- a/sphinx/util/fileutil.py
+++ b/sphinx/util/fileutil.py
@@ -10,8 +10,7 @@
 
 import os
 import posixpath
-from typing import Callable, Dict
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Callable, Dict
 
 from docutils.utils import relative_path
 
diff --git a/sphinx/util/i18n.py b/sphinx/util/i18n.py
index e5d4f112e32..2930007cb93 100644
--- a/sphinx/util/i18n.py
+++ b/sphinx/util/i18n.py
@@ -12,8 +12,7 @@
 import re
 from datetime import datetime, timezone
 from os import path
-from typing import Callable, Generator, List, NamedTuple, Tuple, Union
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Callable, Generator, List, NamedTuple, Tuple, Union
 
 import babel.dates
 from babel.messages.mofile import write_mo
diff --git a/sphinx/util/pycompat.py b/sphinx/util/pycompat.py
index 0c0ac12d69f..b6eb32f69c0 100644
--- a/sphinx/util/pycompat.py
+++ b/sphinx/util/pycompat.py
@@ -13,7 +13,6 @@
 
 from sphinx.deprecation import RemovedInSphinx60Warning
 
-
 # ------------------------------------------------------------------------------
 # Python 2/3 compatibility
 
diff --git a/sphinx/versioning.py b/sphinx/versioning.py
index 4f925741c31..02f31801a28 100644
--- a/sphinx/versioning.py
+++ b/sphinx/versioning.py
@@ -12,8 +12,7 @@
 from itertools import product, zip_longest
 from operator import itemgetter
 from os import path
-from typing import Any, Dict, Iterator
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Dict, Iterator
 from uuid import uuid4
 
 from docutils.nodes import Node

From d7783b97ccabcc7b4d870d531f58f5c5bd060813 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 12 Nov 2020 02:55:23 +0900
Subject: [PATCH 070/305] Fix flake8 violation

---
 sphinx/util/pycompat.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/sphinx/util/pycompat.py b/sphinx/util/pycompat.py
index b6eb32f69c0..5ffebd715af 100644
--- a/sphinx/util/pycompat.py
+++ b/sphinx/util/pycompat.py
@@ -16,6 +16,7 @@
 # ------------------------------------------------------------------------------
 # Python 2/3 compatibility
 
+
 # convert_with_2to3():
 # support for running 2to3 over config files
 def convert_with_2to3(filepath: str) -> str:

From 7825b1188b3fcb494c4e407c1081e36e117bdcfa Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 15 Nov 2020 01:37:30 +0900
Subject: [PATCH 071/305] Remove config variable: source_parsers

It was already deprecated at 1.8.0 and removed at 3.0.0.  So the
definition is no longer used.

refs: dc45877d3cb9f67348d3e2857bc489e16b71f61a
---
 sphinx/config.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/sphinx/config.py b/sphinx/config.py
index 584d4c3c47e..005bc812f4a 100644
--- a/sphinx/config.py
+++ b/sphinx/config.py
@@ -106,7 +106,6 @@ class Config:
         'master_doc': ('index', 'env', []),
         'source_suffix': ({'.rst': 'restructuredtext'}, 'env', Any),
         'source_encoding': ('utf-8-sig', 'env', []),
-        'source_parsers': ({}, 'env', []),
         'exclude_patterns': ([], 'env', []),
         'default_role': (None, 'env', [str]),
         'add_function_parentheses': (True, 'env', []),

From a8881cae5fa94458a98bee9377d222321a61eeae Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 21 Nov 2020 01:07:27 +0900
Subject: [PATCH 072/305] Fix flake8 violations

---
 tests/test_ext_autodoc_autofunction.py | 2 --
 tests/test_pycode_parser.py            | 4 ----
 2 files changed, 6 deletions(-)

diff --git a/tests/test_ext_autodoc_autofunction.py b/tests/test_ext_autodoc_autofunction.py
index d5f690bada0..e355a552c8e 100644
--- a/tests/test_ext_autodoc_autofunction.py
+++ b/tests/test_ext_autodoc_autofunction.py
@@ -9,8 +9,6 @@
     :license: BSD, see LICENSE for details.
 """
 
-import sys
-
 import pytest
 from test_ext_autodoc import do_autodoc
 
diff --git a/tests/test_pycode_parser.py b/tests/test_pycode_parser.py
index 2ef3c2311ed..7b6ce37d983 100644
--- a/tests/test_pycode_parser.py
+++ b/tests/test_pycode_parser.py
@@ -8,10 +8,6 @@
     :license: BSD, see LICENSE for details.
 """
 
-import sys
-
-import pytest
-
 from sphinx.pycode.parser import Parser
 from sphinx.util.inspect import signature_from_str
 

From 59df68590c2b96a9d2cba72f1e978d62eb3ee023 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 21 Nov 2020 01:24:55 +0900
Subject: [PATCH 073/305] Remove code for python3.5

---
 sphinx/util/typing.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py
index 9daa4b28a36..c4b5b1d3181 100644
--- a/sphinx/util/typing.py
+++ b/sphinx/util/typing.py
@@ -75,9 +75,6 @@ def get_type_hints(obj: Any, globalns: Dict = None, localns: Dict = None) -> Dic
     except KeyError:
         # a broken class found (refs: https://github.com/sphinx-doc/sphinx/issues/8084)
         return {}
-    except AttributeError:
-        # AttributeError is raised on 3.5.2 (fixed by 3.5.3)
-        return {}
 
 
 def is_system_TypeVar(typ: Any) -> bool:

From 9b9e97b80b9d139c189bb029d0f6169558a7db71 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 22 Nov 2020 16:09:30 +0900
Subject: [PATCH 074/305] Fix importing error

---
 sphinx/util/inspect.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/util/inspect.py b/sphinx/util/inspect.py
index cfbb399da78..1f996bb6f8c 100644
--- a/sphinx/util/inspect.py
+++ b/sphinx/util/inspect.py
@@ -20,7 +20,7 @@
 from functools import partial, partialmethod
 from inspect import Parameter, isclass, ismethod, ismethoddescriptor, ismodule  # NOQA
 from io import StringIO
-from typing import Any, Callable, Dict, Optional, Sequence, cast
+from typing import Any, Callable, Dict, Mapping, Optional, Sequence, cast
 
 from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.pycode.ast import ast  # for py36-37

From 08752eb2eb9af4c89d990fb680288efe589c6738 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 25 Nov 2020 01:08:57 +0900
Subject: [PATCH 075/305] Fix flake8 warnings

---
 sphinx/ext/autodoc/importer.py | 8 +-------
 sphinx/pycode/__init__.py      | 1 +
 2 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/sphinx/ext/autodoc/importer.py b/sphinx/ext/autodoc/importer.py
index 427fae7d68d..8513255c1fa 100644
--- a/sphinx/ext/autodoc/importer.py
+++ b/sphinx/ext/autodoc/importer.py
@@ -11,7 +11,7 @@
 import importlib
 import traceback
 import warnings
-from typing import Any, Callable, Dict, List, Mapping, NamedTuple, Optional, Tuple
+from typing import Any, Callable, Dict, List, NamedTuple, Optional, Tuple
 
 from sphinx.pycode import ModuleAnalyzer
 from sphinx.util import logging
@@ -173,12 +173,6 @@ def _getmro(obj: Any) -> Tuple["Type", ...]:
         return tuple()
 
 
-def _getannotations(obj: Any) -> Mapping[str, Any]:
-    warnings.warn('sphinx.ext.autodoc.importer._getannotations() is deprecated.',
-                  RemovedInSphinx40Warning)
-    return getannotations(obj)
-
-
 def get_object_members(subject: Any, objpath: List[str], attrgetter: Callable,
                        analyzer: ModuleAnalyzer = None) -> Dict[str, Attribute]:
     """Get members and attributes of target object."""
diff --git a/sphinx/pycode/__init__.py b/sphinx/pycode/__init__.py
index 718380881f5..d69ab64bd81 100644
--- a/sphinx/pycode/__init__.py
+++ b/sphinx/pycode/__init__.py
@@ -10,6 +10,7 @@
 
 import re
 import tokenize
+import warnings
 from collections import OrderedDict
 from importlib import import_module
 from inspect import Signature

From a0661522cc18be82dd92880eab8341400371e7a9 Mon Sep 17 00:00:00 2001
From: Mardelor <remy.zirnheld@laposte.net>
Date: Sat, 28 Nov 2020 18:01:14 +0100
Subject: [PATCH 076/305] Change html_logo & favicon config value process to
 handle url as values

---
 sphinx/builders/html/__init__.py | 22 +++++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 6d263a9ed69..a21b0041917 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -15,7 +15,7 @@
 import warnings
 from os import path
 from typing import IO, Any, Dict, Iterable, Iterator, List, Set, Tuple
-from urllib.parse import quote
+from urllib.parse import quote, urlparse
 
 from docutils import nodes
 from docutils.core import publish_parts
@@ -444,8 +444,8 @@ def prepare_writing(self, docnames: Set[str]) -> None:
         else:
             self.last_updated = None
 
-        logo = path.basename(self.config.html_logo) if self.config.html_logo else ''
-        favicon = path.basename(self.config.html_favicon) if self.config.html_favicon else ''
+        logo = self.proc_resource_ref(self.config.html_logo)
+        favicon = self.proc_resource_ref(self.config.html_favicon)
 
         if not isinstance(self.config.html_use_opensearch, str):
             logger.warning(__('html_use_opensearch config value must now be a string'))
@@ -773,12 +773,12 @@ def onerror(filename: str, error: Exception) -> None:
                        excluded, context=context, renderer=self.templates, onerror=onerror)
 
     def copy_html_logo(self) -> None:
-        if self.config.html_logo:
+        if self.config.html_logo and not urlparse(self.config.html_logo).scheme:
             copy_asset(path.join(self.confdir, self.config.html_logo),
                        path.join(self.outdir, '_static'))
 
     def copy_html_favicon(self) -> None:
-        if self.config.html_favicon:
+        if self.config.html_favicon and not urlparse(self.config.html_favicon).scheme:
             copy_asset(path.join(self.confdir, self.config.html_favicon),
                        path.join(self.outdir, '_static'))
 
@@ -953,6 +953,18 @@ def has_wildcard(pattern: str) -> bool:
         ctx['sidebars'] = sidebars
         ctx['customsidebar'] = customsidebar
 
+    def proc_resource_ref(self, uri: str) -> str:
+        """Parse uri of a resource file and return its reference. If its a local file,
+        return the name of the file.
+        """
+        parse_result = urlparse(uri)
+        ref = ''
+        if parse_result.scheme:
+            ref = uri
+        elif parse_result.path:
+            ref = path.basename(parse_result.path)
+        return ref
+
     # --------- these are overwritten by the serialization builder
 
     def get_target_uri(self, docname: str, typ: str = None) -> str:

From 1d9eeedde306cfb013850b4621c32cdd47e46bff Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 29 Nov 2020 14:49:44 +0900
Subject: [PATCH 077/305] Fix #8508: LaTeX: uplatex becomes a default setting
 of latex_engine for Japanese

Since v2.3, Sphinx supports uplatex as an alternative of latex_engine for Japanese
docs (refs: #4186, #6841). uplatex is able to build a document without conversion
character encoding internally. It allows using unicode characters in documents.
Additionally, uplatex is compatible with platex (current default latex_engine for
Japanese docs).

This changes the default latex_engine for Japanese document to uplatex.
---
 CHANGES                           | 2 ++
 doc/usage/configuration.rst       | 8 ++++++--
 sphinx/builders/latex/__init__.py | 2 +-
 tests/test_build_latex.py         | 4 ++--
 4 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/CHANGES b/CHANGES
index 1386ff49057..1cee5375d3c 100644
--- a/CHANGES
+++ b/CHANGES
@@ -20,6 +20,8 @@ Incompatible changes
   :confval:`man_make_section_directory`)
 * #8380: html search: search results are wrapped with ``<p>`` instead of
   ``<div>``
+* #8508: LaTeX: uplatex becomes a default setting of latex_engine for Japanese
+  documents
 
 Deprecated
 ----------
diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index 13dd6623ca8..f69aa529bc6 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -1903,8 +1903,8 @@ These options influence LaTeX output.
    * ``'pdflatex'`` -- PDFLaTeX (default)
    * ``'xelatex'`` -- XeLaTeX
    * ``'lualatex'`` -- LuaLaTeX
-   * ``'platex'`` -- pLaTeX (default if :confval:`language` is ``'ja'``)
-   * ``'uplatex'`` -- upLaTeX (experimental)
+   * ``'platex'`` -- pLaTeX
+   * ``'uplatex'`` -- upLaTeX (default if :confval:`language` is ``'ja'``)
 
    ``'pdflatex'``\ 's support for Unicode characters is limited.
 
@@ -1934,6 +1934,10 @@ These options influence LaTeX output.
 
       Add ``uplatex`` support.
 
+   .. versionchanged:: 4.0
+
+      ``uplatex`` becomes the default setting of Japanese documents.
+
    Contrarily to :ref:`MathJaX math rendering in HTML output <math-support>`,
    LaTeX requires some extra configuration to support Unicode literals in
    :rst:dir:`math`: the only comprehensive solution (as far as we know) is to
diff --git a/sphinx/builders/latex/__init__.py b/sphinx/builders/latex/__init__.py
index f034e552b7b..5d19d5e7bf2 100644
--- a/sphinx/builders/latex/__init__.py
+++ b/sphinx/builders/latex/__init__.py
@@ -482,7 +482,7 @@ def install_packages_for_ja(app: Sphinx) -> None:
 def default_latex_engine(config: Config) -> str:
     """ Better default latex_engine settings for specific languages. """
     if config.language == 'ja':
-        return 'platex'
+        return 'uplatex'
     elif (config.language or '').startswith('zh'):
         return 'xelatex'
     elif config.language == 'el':
diff --git a/tests/test_build_latex.py b/tests/test_build_latex.py
index 5dfc3b7a85a..6c753d6c1c1 100644
--- a/tests/test_build_latex.py
+++ b/tests/test_build_latex.py
@@ -197,7 +197,7 @@ def test_latex_basic_manual_ja(app, status, warning):
     app.builder.build_all()
     result = (app.outdir / 'test.tex').read_text(encoding='utf8')
     print(result)
-    assert r'\def\sphinxdocclass{jsbook}' in result
+    assert r'\def\sphinxdocclass{ujbook}' in result
     assert r'\documentclass[letterpaper,10pt,dvipdfmx]{sphinxmanual}' in result
 
 
@@ -210,7 +210,7 @@ def test_latex_basic_howto_ja(app, status, warning):
     app.builder.build_all()
     result = (app.outdir / 'test.tex').read_text(encoding='utf8')
     print(result)
-    assert r'\def\sphinxdocclass{jreport}' in result
+    assert r'\def\sphinxdocclass{ujreport}' in result
     assert r'\documentclass[letterpaper,10pt,dvipdfmx]{sphinxhowto}' in result
 
 

From 1a0ae002e369a870622bff38ee2dd0360b738443 Mon Sep 17 00:00:00 2001
From: Mardelor <remy.zirnheld@laposte.net>
Date: Mon, 30 Nov 2020 12:12:24 +0100
Subject: [PATCH 078/305] Fix basic layout and html_logo & favicon config value
 process to support url as values

---
 sphinx/builders/html/__init__.py | 6 +++---
 sphinx/themes/basic/layout.html  | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index a21b0041917..955e38e6179 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -962,7 +962,7 @@ def proc_resource_ref(self, uri: str) -> str:
         if parse_result.scheme:
             ref = uri
         elif parse_result.path:
-            ref = path.basename(parse_result.path)
+            ref = path.join('_static', path.basename(parse_result.path))
         return ref
 
     # --------- these are overwritten by the serialization builder
@@ -1188,14 +1188,14 @@ def validate_html_static_path(app: Sphinx, config: Config) -> None:
 
 def validate_html_logo(app: Sphinx, config: Config) -> None:
     """Check html_logo setting."""
-    if config.html_logo and not path.isfile(path.join(app.confdir, config.html_logo)):
+    if config.html_logo and not path.isfile(path.join(app.confdir, config.html_logo)) and not urlparse(config.html_logo).scheme:
         logger.warning(__('logo file %r does not exist'), config.html_logo)
         config.html_logo = None  # type: ignore
 
 
 def validate_html_favicon(app: Sphinx, config: Config) -> None:
     """Check html_favicon setting."""
-    if config.html_favicon and not path.isfile(path.join(app.confdir, config.html_favicon)):
+    if config.html_favicon and not path.isfile(path.join(app.confdir, config.html_favicon)) and not urlparse(config.html_favicon).scheme:
         logger.warning(__('favicon file %r does not exist'), config.html_favicon)
         config.html_favicon = None  # type: ignore
 
diff --git a/sphinx/themes/basic/layout.html b/sphinx/themes/basic/layout.html
index 131d2c533cf..347ac2cc689 100644
--- a/sphinx/themes/basic/layout.html
+++ b/sphinx/themes/basic/layout.html
@@ -55,7 +55,7 @@ <h3>{{ _('Navigation') }}</h3>
           {%- block sidebarlogo %}
           {%- if logo %}
             <p class="logo"><a href="{{ pathto(master_doc)|e }}">
-              <img class="logo" src="{{ pathto('_static/' + logo, 1)|e }}" alt="Logo"/>
+              <img class="logo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
             </a></p>
           {%- endif %}
           {%- endblock %}
@@ -141,7 +141,7 @@ <h3>{{ _('Navigation') }}</h3>
           href="{{ pathto('_static/opensearch.xml', 1) }}"/>
     {%- endif %}
     {%- if favicon %}
-    <link rel="shortcut icon" href="{{ pathto('_static/' + favicon, 1)|e }}"/>
+    <link rel="shortcut icon" href="{{ pathto(favicon, 1)|e }}"/>
     {%- endif %}
     {%- endif %}
 {%- block linktags %}

From 6c41b3f3a3d5d075de0a715978b5079417125420 Mon Sep 17 00:00:00 2001
From: Mardelor <remy.zirnheld@laposte.net>
Date: Mon, 30 Nov 2020 12:37:16 +0100
Subject: [PATCH 079/305] Update layouts to reference logo & favicon without
 static

---
 sphinx/themes/agogo/layout.html    | 2 +-
 sphinx/themes/basic/opensearch.xml | 2 +-
 sphinx/themes/haiku/layout.html    | 4 ++--
 sphinx/themes/pyramid/layout.html  | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/sphinx/themes/agogo/layout.html b/sphinx/themes/agogo/layout.html
index 26c37b10ea5..cd9ff8d205b 100644
--- a/sphinx/themes/agogo/layout.html
+++ b/sphinx/themes/agogo/layout.html
@@ -15,7 +15,7 @@
       <div class="header">
         {%- if logo %}
           <p class="logo"><a href="{{ pathto(master_doc)|e }}">
-            <img class="logo" src="{{ pathto('_static/' + logo, 1)|e }}" alt="Logo"/>
+            <img class="logo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
           </a></p>
         {%- endif %}
         {%- block headertitle %}
diff --git a/sphinx/themes/basic/opensearch.xml b/sphinx/themes/basic/opensearch.xml
index 0cad2967ca7..ad6273e44b1 100644
--- a/sphinx/themes/basic/opensearch.xml
+++ b/sphinx/themes/basic/opensearch.xml
@@ -7,7 +7,7 @@
        template="{{ use_opensearch }}/{{ pathto('search') }}?q={searchTerms}"/>
   <LongName>{{ docstitle|e }}</LongName>
 {%- if favicon %}
-  <Image height="16" width="16" type="image/x-icon">{{ use_opensearch }}/{{ pathto('_static/' + favicon, 1)|e }}</Image>
+  <Image height="16" width="16" type="image/x-icon">{{ use_opensearch }}/{{ pathto(favicon, 1)|e }}</Image>
 {%- endif %}
 {% block extra %} {# Put e.g. an <Image> element here. #} {% endblock %}
 </OpenSearchDescription>
diff --git a/sphinx/themes/haiku/layout.html b/sphinx/themes/haiku/layout.html
index c47b8eccc1c..07f801007df 100644
--- a/sphinx/themes/haiku/layout.html
+++ b/sphinx/themes/haiku/layout.html
@@ -36,11 +36,11 @@
         {%- block haikuheader %}
         {%- if theme_full_logo != "false" %}
         <a href="{{ pathto('index') }}">
-          <img class="logo" src="{{ pathto('_static/' + logo, 1)|e }}" alt="Logo"/>
+          <img class="logo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
         </a>
         {%- else %}
         {%- if logo -%}
-          <img class="rightlogo" src="{{ pathto('_static/' + logo, 1)|e }}" alt="Logo"/>
+          <img class="rightlogo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
         {%- endif -%}
         <h1 class="heading"><a href="{{ pathto('index') }}">
           <span>{{ shorttitle|e }}</span></a></h1>
diff --git a/sphinx/themes/pyramid/layout.html b/sphinx/themes/pyramid/layout.html
index 02eec1cfb14..097e974075e 100644
--- a/sphinx/themes/pyramid/layout.html
+++ b/sphinx/themes/pyramid/layout.html
@@ -13,7 +13,7 @@
 <div class="header" role="banner">
   <div class="logo">
     <a href="{{ pathto(master_doc)|e }}">
-      <img class="logo" src="{{ pathto('_static/' + logo, 1)|e }}" alt="Logo"/>
+      <img class="logo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
     </a>
   </div>
 </div>

From 929a78c5d0bbcae064f122f9eec2b4536a4a4be4 Mon Sep 17 00:00:00 2001
From: Mardelor <remy.zirnheld@laposte.net>
Date: Mon, 30 Nov 2020 19:06:35 +0100
Subject: [PATCH 080/305] Fix style check errors

---
 sphinx/builders/html/__init__.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 955e38e6179..83a4cccd541 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1188,14 +1188,16 @@ def validate_html_static_path(app: Sphinx, config: Config) -> None:
 
 def validate_html_logo(app: Sphinx, config: Config) -> None:
     """Check html_logo setting."""
-    if config.html_logo and not path.isfile(path.join(app.confdir, config.html_logo)) and not urlparse(config.html_logo).scheme:
+    if config.html_logo and not path.isfile(path.join(app.confdir, config.html_logo)) \
+            and not urlparse(config.html_logo).scheme:
         logger.warning(__('logo file %r does not exist'), config.html_logo)
         config.html_logo = None  # type: ignore
 
 
 def validate_html_favicon(app: Sphinx, config: Config) -> None:
     """Check html_favicon setting."""
-    if config.html_favicon and not path.isfile(path.join(app.confdir, config.html_favicon)) and not urlparse(config.html_favicon).scheme:
+    if config.html_favicon and not path.isfile(path.join(app.confdir, config.html_favicon)) \
+            and not urlparse(config.html_favicon).scheme:
         logger.warning(__('favicon file %r does not exist'), config.html_favicon)
         config.html_favicon = None  # type: ignore
 

From d87202798c84448abb3df9b9e92056373187ae97 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Toni=20Ru=C5=BEa?= <toni.ruza@gmail.com>
Date: Wed, 10 Jul 2019 14:38:06 +0200
Subject: [PATCH 081/305] =?UTF-8?q?Prevent=20page=20brake=20in=20the=20mid?=
 =?UTF-8?q?dle=20of=20a=20`seealso`=C2=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 sphinx/writers/latex.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py
index 6a96a9ac7b4..8a1803c5f78 100644
--- a/sphinx/writers/latex.py
+++ b/sphinx/writers/latex.py
@@ -813,7 +813,7 @@ def depart_desc_content(self, node: Element) -> None:
         pass
 
     def visit_seealso(self, node: Element) -> None:
-        self.body.append('\n\n\\sphinxstrong{%s:}\n\n' % admonitionlabels['seealso'])
+        self.body.append('\n\n\\sphinxstrong{%s:}\n\\nopagebreak\n\n' % admonitionlabels['seealso'])
 
     def depart_seealso(self, node: Element) -> None:
         self.body.append("\n\n")

From b9e798a390dc47a1a88dec34182c3974ec2f24cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Toni=20Ru=C5=BEa?= <toni.ruza@gmail.com>
Date: Tue, 8 Dec 2020 17:41:34 +0100
Subject: [PATCH 082/305] Fold long line

---
 sphinx/writers/latex.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py
index 8a1803c5f78..2445723de8a 100644
--- a/sphinx/writers/latex.py
+++ b/sphinx/writers/latex.py
@@ -813,7 +813,8 @@ def depart_desc_content(self, node: Element) -> None:
         pass
 
     def visit_seealso(self, node: Element) -> None:
-        self.body.append('\n\n\\sphinxstrong{%s:}\n\\nopagebreak\n\n' % admonitionlabels['seealso'])
+        self.body.append('\n\n\\sphinxstrong{%s:}\n\\nopagebreak\n\n'
+                         % admonitionlabels['seealso'])
 
     def depart_seealso(self, node: Element) -> None:
         self.body.append("\n\n")

From 1bd0e02b184719fed36ac9fde326cfe436574a26 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 20 Dec 2020 22:21:52 +0900
Subject: [PATCH 083/305] Fix a flake8 violation

---
 sphinx/util/osutil.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/sphinx/util/osutil.py b/sphinx/util/osutil.py
index 4672d5f0401..e15182df3a7 100644
--- a/sphinx/util/osutil.py
+++ b/sphinx/util/osutil.py
@@ -14,6 +14,7 @@
 import re
 import shutil
 import sys
+import warnings
 from io import StringIO
 from os import path
 from typing import Any, Generator, Iterator, List, Optional, Type

From eb07939c4434f2b213811f28fad7ca4f3c6f75d6 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 20 Dec 2020 22:25:32 +0900
Subject: [PATCH 084/305] Remove deprecated function:
 sphinx.ext.autodoc.importer:_getmro()

---
 sphinx/ext/autodoc/importer.py | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/sphinx/ext/autodoc/importer.py b/sphinx/ext/autodoc/importer.py
index b7f2d558b2d..25097e2890e 100644
--- a/sphinx/ext/autodoc/importer.py
+++ b/sphinx/ext/autodoc/importer.py
@@ -165,12 +165,6 @@ class Attribute(NamedTuple):
     value: Any
 
 
-def _getmro(obj: Any) -> Tuple["Type", ...]:
-    warnings.warn('sphinx.ext.autodoc.importer._getmro() is deprecated.',
-                  RemovedInSphinx40Warning)
-    return getmro(obj)
-
-
 def get_object_members(subject: Any, objpath: List[str], attrgetter: Callable,
                        analyzer: ModuleAnalyzer = None) -> Dict[str, Attribute]:
     """Get members and attributes of target object."""

From 24566623e170274599157b4351178bfc955797f1 Mon Sep 17 00:00:00 2001
From: Faris A Chugthai <20028782+farisachugthai@users.noreply.github.com>
Date: Mon, 21 Dec 2020 22:45:35 -0500
Subject: [PATCH 085/305] Update the sphinx core events in appappi.rst

I'm very happy to see that the events in Sphinx have been laid out in order as they have been in this doc.

With that being said the notation I noticed was a bit odd. Some of the items in the list refer to events and as a result,
parenthesis are used to indicate the beginning and end of the parameters that the event takes.

In other items in the list, parenthesis are used for additional context for an event. The combination of some particularly very long lines,
the intermixing of comments, pseudo-code, indentation of items following a `for` or an `if` made this very difficult to read on a mobile device.

As a result, I've added whitespace, fixed a typo, reduced the length of some lines by moving them to a new line, and removed all `()` that were not
present to indicate parameters fed to a function.
---
 doc/extdev/appapi.rst | 23 +++++++++++++++--------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/doc/extdev/appapi.rst b/doc/extdev/appapi.rst
index 9f2c10676d4..5c9106bbdf2 100644
--- a/doc/extdev/appapi.rst
+++ b/doc/extdev/appapi.rst
@@ -167,26 +167,33 @@ type for that event::
    4. event.env-before-read-docs(app, env, docnames)
 
    for docname in docnames:
-      5.  event.env-purge-doc(app, env, docname)
+      5. event.env-purge-doc(app, env, docname)
+      
       if doc changed and not removed:
          6. source-read(app, docname, source)
-         7. run source parsers: text -> docutils.document (parsers can be added with the app.add_source_parser() API)
-         8. apply transforms (by priority): docutils.document -> docutils.document
-            - event.doctree-read(app, doctree) is called in the middly of transforms,
+         7. run source parsers: text -> docutils.document
+            - parsers can be added with the app.add_source_parser() API
+         8. apply transforms based on priority: docutils.document -> docutils.document
+            - event.doctree-read(app, doctree) is called in the middle of transforms,
               transforms come before/after this event depending on their priority.
-   9. (if running in parallel mode, for each process) event.env-merged-info(app, env, docnames, other)
+   
+   9. event.env-merged-info(app, env, docnames, other)
+      - if running in parallel mode, this event will be emitted for each process
+   
    10. event.env-updated(app, env)
    11. event.env-get-updated(app, env)
    12. event.env-check-consistency(app, env)
 
    # The updated-docs list can be builder dependent, but generally includes all new/changed documents,
    # plus any output from `env-get-updated`, and then all "parent" documents in the ToC tree
-   # For builders that output a single page, they are first joined into a single doctree before post-transforms/doctree-resolved
+   # For builders that output a single page, they are first joined into a single doctree before post-transforms
+   # or the doctree-resolved event is emitted
    for docname in updated-docs:
       13. apply post-transforms (by priority): docutils.document -> docutils.document
       14. event.doctree-resolved(app, doctree, docname)
-          - (for any reference node that fails to resolve) event.missing-reference(env, node, contnode)
-          - (for any reference node that fails to resolve) event.warn-missing-reference(domain, node)
+          - In the event that any reference nodes fail to resolve, the following may emit:
+          - event.missing-reference(env, node, contnode)
+          - event.warn-missing-reference(domain, node)
 
    15. Generate output files
    16. event.build-finished(app, exception)

From 4eab5e89509520673529000f4fc316dbcbf09c1c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 29 Dec 2020 18:58:58 +0900
Subject: [PATCH 086/305] Fix mypy violations

---
 sphinx/ext/autodoc/__init__.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 183b846ac6e..ca36b4eabca 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -1945,13 +1945,13 @@ def get_module_comment(self, attrname: str) -> Optional[List[str]]:
 
         return None
 
-    def get_doc(self, encoding: str = None, ignore: int = None) -> List[List[str]]:
+    def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]:
         # Check the variable has a docstring-comment
         comment = self.get_module_comment(self.objpath[-1])
         if comment:
             return [comment]
         else:
-            return super().get_doc(encoding, ignore)
+            return super().get_doc(ignore)
 
     def add_content(self, more_content: Optional[StringList], no_docstring: bool = False
                     ) -> None:

From 9cac2001f789a095101b8834ce09fcbb02e741e2 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 1 Jan 2021 18:14:43 +0900
Subject: [PATCH 087/305] test: py domain: Add a testcase for :var: field

---
 tests/test_domain_py.py | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/tests/test_domain_py.py b/tests/test_domain_py.py
index e0c690518f6..14e9334486f 100644
--- a/tests/test_domain_py.py
+++ b/tests/test_domain_py.py
@@ -838,6 +838,32 @@ def test_info_field_list(app):
                 **{"py:module": "example", "py:class": "Class"})
 
 
+def test_info_field_list_var(app):
+    text = (".. py:class:: Class\n"
+            "\n"
+            "   :var int attr: blah blah\n")
+    doctree = restructuredtext.parse(app, text)
+
+    assert_node(doctree, (addnodes.index,
+                          [desc, (desc_signature,
+                                  [desc_content, nodes.field_list, nodes.field])]))
+    assert_node(doctree[1][1][0][0], ([nodes.field_name, "Variables"],
+                                      [nodes.field_body, nodes.paragraph]))
+
+    # :var int attr:
+    assert_node(doctree[1][1][0][0][1][0],
+                ([pending_xref, addnodes.literal_strong, "attr"],
+                 " (",
+                 [pending_xref, addnodes.literal_emphasis, "int"],
+                 ")",
+                 " -- ",
+                 "blah blah"))
+    assert_node(doctree[1][1][0][0][1][0][0], pending_xref,
+                refdomain="py", reftype="obj", reftarget="attr", **{"py:class": "Class"})
+    assert_node(doctree[1][1][0][0][1][0][2], pending_xref,
+                refdomain="py", reftype="class", reftarget="int", **{"py:class": "Class"})
+
+
 @pytest.mark.sphinx(freshenv=True)
 def test_module_index(app):
     text = (".. py:module:: docutils\n"

From 918086b5590763663c1627578085e528f1358384 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 1 Jan 2021 19:51:59 +0900
Subject: [PATCH 088/305] Close #5977: :var: field do not create a
 cross-reference

Since its beginning, `:var:` field has created a cross-reference to the
attribute having the same name.  It is meaningful only if the attribute
is documented by `py:attribute` directive.  It means the `:var:` field
and `:attr:` role are almost the same and conflicted.  Additionally,
the cross-reference points incorrect variable if the target is not
documented.

Thus, the cross-reference feature of `:var:` field is disabled.
---
 CHANGES                  | 2 ++
 sphinx/domains/python.py | 2 +-
 tests/test_domain_py.py  | 4 +---
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/CHANGES b/CHANGES
index 9c889420fd6..d8a0675836e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -22,6 +22,8 @@ Incompatible changes
   ``<div>``
 * #8508: LaTeX: uplatex becomes a default setting of latex_engine for Japanese
   documents
+* #5977: py domain: ``:var:``, ``:cvar:`` and ``:ivar:`` fields do not create
+  cross-references
 
 Deprecated
 ----------
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 000e2e8d34f..5afe2993a4f 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -354,7 +354,7 @@ class PyObject(ObjectDescription):
                             'keyword', 'kwarg', 'kwparam'),
                      typerolename='class', typenames=('paramtype', 'type'),
                      can_collapse=True),
-        PyTypedField('variable', label=_('Variables'), rolename='obj',
+        PyTypedField('variable', label=_('Variables'),
                      names=('var', 'ivar', 'cvar'),
                      typerolename='class', typenames=('vartype',),
                      can_collapse=True),
diff --git a/tests/test_domain_py.py b/tests/test_domain_py.py
index 14e9334486f..537bae15bb6 100644
--- a/tests/test_domain_py.py
+++ b/tests/test_domain_py.py
@@ -852,14 +852,12 @@ def test_info_field_list_var(app):
 
     # :var int attr:
     assert_node(doctree[1][1][0][0][1][0],
-                ([pending_xref, addnodes.literal_strong, "attr"],
+                ([addnodes.literal_strong, "attr"],
                  " (",
                  [pending_xref, addnodes.literal_emphasis, "int"],
                  ")",
                  " -- ",
                  "blah blah"))
-    assert_node(doctree[1][1][0][0][1][0][0], pending_xref,
-                refdomain="py", reftype="obj", reftarget="attr", **{"py:class": "Class"})
     assert_node(doctree[1][1][0][0][1][0][2], pending_xref,
                 refdomain="py", reftype="class", reftarget="int", **{"py:class": "Class"})
 

From 5b392e39514eefe9ff2dea5d0b084f00c0f740cd Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 3 Jan 2021 02:04:36 +0900
Subject: [PATCH 089/305] refactor: Move CSS tags in basic/layout.html to
 ``css_files`` variable

To make CSS customizable, all CSS files in basic/layout.html has their
priority: 200.  Therefore, extensions and users can insert their own
custom CSS files before or just after them.

As a side effect, the CSS tags in basic/layout.html are removed.  These
CSS files will be rendered via `css_files` template variable.

refs: #8634, c5f03980107e123210fb602f4c31f5ae950e2af4
---
 CHANGES                          |  1 +
 sphinx/application.py            |  2 ++
 sphinx/builders/html/__init__.py | 20 ++++++++++++--------
 sphinx/themes/basic/layout.html  |  2 --
 tests/test_build_html.py         |  6 +++---
 tests/test_theming.py            |  2 +-
 6 files changed, 19 insertions(+), 14 deletions(-)

diff --git a/CHANGES b/CHANGES
index 9e88f28d521..c4a9b07bddb 100644
--- a/CHANGES
+++ b/CHANGES
@@ -20,6 +20,7 @@ Incompatible changes
   :confval:`man_make_section_directory`)
 * #8380: html search: search results are wrapped with ``<p>`` instead of
   ``<div>``
+* html theme: Move CSS tags in basic/layout.html to ``css_files`` variable
 * #8508: LaTeX: uplatex becomes a default setting of latex_engine for Japanese
   documents
 
diff --git a/sphinx/application.py b/sphinx/application.py
index 4b4ebe64e7e..40098e92d9d 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -983,6 +983,8 @@ def add_css_file(self, filename: str, priority: int = 500, **kwargs: Any) -> Non
 
            * - Priority
              - Main purpose in Sphinx
+           * - 200
+             - default priority for built-in CSS files
            * - 500
              - default priority for extensions
            * - 800
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 32b6a20cff1..fe8a5773fcb 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -250,6 +250,14 @@ def _get_translations_js(self) -> str:
                 return jsfile
         return None
 
+    def _get_style_filename(self) -> str:
+        if self.config.html_style is not None:
+            return self.config.html_style
+        elif self.theme:
+            return self.theme.get_config('theme', 'stylesheet')
+        else:
+            return 'default.css'
+
     def get_theme_config(self) -> Tuple[str, Dict]:
         return self.config.html_theme, self.config.html_theme_options
 
@@ -285,6 +293,9 @@ def init_highlighter(self) -> None:
             self.dark_highlighter = None
 
     def init_css_files(self) -> None:
+        self.add_css_file('pygments.css', priority=200)
+        self.add_css_file(self._get_style_filename(), priority=200)
+
         for filename, attrs in self.app.registry.css_files:
             self.add_css_file(filename, **attrs)
 
@@ -470,13 +481,6 @@ def prepare_writing(self, docnames: Set[str]) -> None:
                 rellinks.append((indexname, indexcls.localname,
                                  '', indexcls.shortname))
 
-        if self.config.html_style is not None:
-            stylename = self.config.html_style
-        elif self.theme:
-            stylename = self.theme.get_config('theme', 'stylesheet')
-        else:
-            stylename = 'default.css'
-
         self.globalcontext = {
             'embedded': self.embedded,
             'project': self.config.project,
@@ -499,7 +503,7 @@ def prepare_writing(self, docnames: Set[str]) -> None:
             'language': self.config.language,
             'css_files': self.css_files,
             'sphinx_version': __display_version__,
-            'style': stylename,
+            'style': self._get_style_filename(),
             'rellinks': rellinks,
             'builder': self.name,
             'parents': [],
diff --git a/sphinx/themes/basic/layout.html b/sphinx/themes/basic/layout.html
index bd56681c006..bae8ddd6845 100644
--- a/sphinx/themes/basic/layout.html
+++ b/sphinx/themes/basic/layout.html
@@ -95,8 +95,6 @@ <h3>{{ _('Navigation') }}</h3>
 {%- endmacro %}
 
 {%- macro css() %}
-    <link rel="stylesheet" href="{{ pathto('_static/pygments.css', 1) }}" type="text/css" />
-    <link rel="stylesheet" href="{{ pathto('_static/' + style, 1)|e }}" type="text/css" />
     {%- for css in css_files %}
       {%- if css|attr("filename") %}
     {{ css_tag(css) }}
diff --git a/tests/test_build_html.py b/tests/test_build_html.py
index f074ac9ef67..b2d2125496a 100644
--- a/tests/test_build_html.py
+++ b/tests/test_build_html.py
@@ -1219,7 +1219,7 @@ def test_assets_order(app):
     content = (app.outdir / 'index.html').read_text()
 
     # css_files
-    expected = ['_static/pygments.css', '_static/alabaster.css', '_static/early.css',
+    expected = ['_static/early.css', '_static/pygments.css', '_static/alabaster.css',
                 '_static/normal.css', '_static/late.css', '_static/css/style.css',
                 'https://example.com/custom.css', '_static/lazy.css']
     pattern = '.*'.join('href="%s"' % f for f in expected)
@@ -1357,8 +1357,8 @@ def test_alternate_stylesheets(app, cached_etree_parse, fname, expect):
 def test_html_style(app, status, warning):
     app.build()
     result = (app.outdir / 'index.html').read_text()
-    assert '<link rel="stylesheet" href="_static/default.css" type="text/css" />' in result
-    assert ('<link rel="stylesheet" href="_static/alabaster.css" type="text/css" />'
+    assert '<link rel="stylesheet" type="text/css" href="_static/default.css" />' in result
+    assert ('<link rel="stylesheet" type="text/css" href="_static/alabaster.css" />'
             not in result)
 
 
diff --git a/tests/test_theming.py b/tests/test_theming.py
index 9d447537ccf..3b5d59ec683 100644
--- a/tests/test_theming.py
+++ b/tests/test_theming.py
@@ -127,7 +127,7 @@ def test_dark_style(app, status, warning):
     assert (app.outdir / '_static' / 'pygments_dark.css').exists()
 
     result = (app.outdir / 'index.html').read_text()
-    assert '<link rel="stylesheet" href="_static/pygments.css" type="text/css" />' in result
+    assert '<link rel="stylesheet" type="text/css" href="_static/pygments.css" />' in result
     assert ('<link id="pygments_dark_css" media="(prefers-color-scheme: dark)" '
             'rel="stylesheet" type="text/css" '
             'href="_static/pygments_dark.css" />') in result

From 946f53590ceac8efdafecf4ceb453ab9badfd200 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 3 Jan 2021 02:45:46 +0900
Subject: [PATCH 090/305] refactor: Do not import sphinx.util.smartypants
 because of deprecated

---
 sphinx/util/__init__.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index abf4fe7b2ae..3f1f2a95d04 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -29,7 +29,6 @@
 from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.errors import ExtensionError, FiletypeNotFoundError, SphinxParallelError
 from sphinx.locale import __
-from sphinx.util import smartypants  # noqa
 from sphinx.util import logging
 from sphinx.util.console import bold, colorize, strip_colors, term_width_line  # type: ignore
 from sphinx.util.matching import patfilter  # noqa

From 3248bef3cc45c3b44fd9075142742005f3e4550a Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 16 Jan 2021 19:36:25 +0900
Subject: [PATCH 091/305] Fix #4550: The align attribute of figure nodes
 becomes None by default

To keep compatibility with the standard doctree model of docutils,
this stops to use 'default' value as a default value of the align
attribute for figure and table nodes.
---
 CHANGES                       |  3 +++
 doc/extdev/deprecated.rst     |  5 +++++
 sphinx/transforms/__init__.py |  8 +++++++-
 sphinx/writers/html.py        | 11 +++++++++++
 sphinx/writers/html5.py       | 13 +++++++++++--
 sphinx/writers/latex.py       |  3 +--
 6 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/CHANGES b/CHANGES
index 16920e78a61..af4467b81e0 100644
--- a/CHANGES
+++ b/CHANGES
@@ -25,6 +25,8 @@ Incompatible changes
   documents
 * #5977: py domain: ``:var:``, ``:cvar:`` and ``:ivar:`` fields do not create
   cross-references
+* #4550: The ``align`` attribute of ``figure`` and ``table`` nodes becomes
+  ``None`` by default instead of ``'default'``
 
 Deprecated
 ----------
@@ -32,6 +34,7 @@ Deprecated
 * ``sphinx.directives.patches.CSVTable``
 * ``sphinx.directives.patches.ListTable``
 * ``sphinx.directives.patches.RSTTable``
+* ``sphinx.transforms.FigureAligner``
 * ``sphinx.util.pycompat.convert_with_2to3()``
 * ``sphinx.util.pycompat.execfile_()``
 * ``sphinx.util.smartypants``
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index 47b0f68e733..31697e69600 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -41,6 +41,11 @@ The following is a list of deprecated interfaces.
      - 6.0
      - ``docutils.parsers.rst.diretives.tables.RSTTable``
 
+   * - ``sphinx.transforms.FigureAligner``
+     - 4.0
+     - 6.0
+     - N/A
+
    * - ``sphinx.util.pycompat.convert_with_2to3()``
      - 4.0
      - 6.0
diff --git a/sphinx/transforms/__init__.py b/sphinx/transforms/__init__.py
index 8f8c5d0af7c..7788c8436d7 100644
--- a/sphinx/transforms/__init__.py
+++ b/sphinx/transforms/__init__.py
@@ -9,6 +9,7 @@
 """
 
 import re
+import warnings
 from typing import TYPE_CHECKING, Any, Dict, Generator, List, Tuple
 
 from docutils import nodes
@@ -21,6 +22,7 @@
 
 from sphinx import addnodes
 from sphinx.config import Config
+from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.locale import _, __
 from sphinx.util import docutils, logging
 from sphinx.util.docutils import new_document
@@ -284,6 +286,11 @@ class FigureAligner(SphinxTransform):
     """
     default_priority = 700
 
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        warnings.warn('FigureAilgner is deprecated.',
+                      RemovedInSphinx60Warning)
+        super().__init__(*args, **kwargs)
+
     def apply(self, **kwargs: Any) -> None:
         matcher = NodeMatcher(nodes.table, nodes.figure)
         for node in self.document.traverse(matcher):  # type: Element
@@ -406,7 +413,6 @@ def setup(app: "Sphinx") -> Dict[str, Any]:
     app.add_transform(HandleCodeBlocks)
     app.add_transform(SortIds)
     app.add_transform(DoctestTransform)
-    app.add_transform(FigureAligner)
     app.add_transform(AutoNumbering)
     app.add_transform(AutoIndexUpgrader)
     app.add_transform(FilterSystemMessages)
diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py
index 63c15dd9670..8aaef964b68 100644
--- a/sphinx/writers/html.py
+++ b/sphinx/writers/html.py
@@ -573,6 +573,13 @@ def visit_download_reference(self, node: Element) -> None:
     def depart_download_reference(self, node: Element) -> None:
         self.body.append(self.context.pop())
 
+    # overwritten
+    def visit_figure(self, node: Element) -> None:
+        # set align=default if align not specified to give a default style
+        node.setdefault('align', 'default')
+
+        return super().visit_figure(node)
+
     # overwritten
     def visit_image(self, node: Element) -> None:
         olduri = node['uri']
@@ -774,6 +781,10 @@ def depart_manpage(self, node: Element) -> None:
 
     def visit_table(self, node: Element) -> None:
         self._table_row_index = 0
+
+        # set align=default if align not specified to give a default style
+        node.setdefault('align', 'default')
+
         return super().visit_table(node)
 
     def visit_row(self, node: Element) -> None:
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index 5e0be1a416c..664a6882ab1 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -515,6 +515,13 @@ def visit_download_reference(self, node: Element) -> None:
     def depart_download_reference(self, node: Element) -> None:
         self.body.append(self.context.pop())
 
+    # overwritten
+    def visit_figure(self, node: Element) -> None:
+        # set align=default if align not specified to give a default style
+        node.setdefault('align', 'default')
+
+        return super().visit_figure(node)
+
     # overwritten
     def visit_image(self, node: Element) -> None:
         olduri = node['uri']
@@ -716,8 +723,10 @@ def visit_table(self, node: Element) -> None:
         atts = {}
         classes = [cls.strip(' \t\n') for cls in self.settings.table_style.split(',')]
         classes.insert(0, "docutils")  # compat
-        if 'align' in node:
-            classes.append('align-%s' % node['align'])
+
+        # set align-default if align not specified to give a default style
+        classes.append('align-%s' % node.get('align', 'default'))
+
         if 'width' in node:
             atts['style'] = 'width: %s' % node['width']
         tag = self.starttag(node, 'table', CLASS=' '.join(classes), **atts)
diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py
index 52432c120ce..31f523bd4ed 100644
--- a/sphinx/writers/latex.py
+++ b/sphinx/writers/latex.py
@@ -106,7 +106,7 @@ class Table:
     def __init__(self, node: Element) -> None:
         self.header = []                        # type: List[str]
         self.body = []                          # type: List[str]
-        self.align = node.get('align')
+        self.align = node.get('align', 'default')
         self.colcount = 0
         self.colspec = None                     # type: str
         self.colwidths = []                     # type: List[int]
@@ -1240,7 +1240,6 @@ def visit_image(self, node: Element) -> None:
                 (1, 'middle'): ('\\raisebox{-0.5\\height}{', '}'),
                 (1, 'bottom'): ('\\raisebox{-\\height}{', '}'),
                 (0, 'center'): ('{\\hspace*{\\fill}', '\\hspace*{\\fill}}'),
-                (0, 'default'): ('{\\hspace*{\\fill}', '\\hspace*{\\fill}}'),
                 # These 2 don't exactly do the right thing.  The image should
                 # be floated alongside the paragraph.  See
                 # https://www.w3.org/TR/html4/struct/objects.html#adef-align-IMG

From 9ced1e355ad6baecd4e755a598a54877dc0aad44 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 17 Jan 2021 18:38:14 +0900
Subject: [PATCH 092/305] refactor: test: Do not use deprecated function:
 execfile_()

---
 tests/test_quickstart.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/tests/test_quickstart.py b/tests/test_quickstart.py
index 11086f5f65c..02aafe335f5 100644
--- a/tests/test_quickstart.py
+++ b/tests/test_quickstart.py
@@ -16,7 +16,6 @@
 from sphinx import application
 from sphinx.cmd import quickstart as qs
 from sphinx.util.console import coloron, nocolor
-from sphinx.util.pycompat import execfile_
 
 warnfile = StringIO()
 
@@ -108,7 +107,7 @@ def test_quickstart_defaults(tempdir):
     conffile = tempdir / 'conf.py'
     assert conffile.isfile()
     ns = {}
-    execfile_(conffile, ns)
+    exec(conffile.read_text(), ns)
     assert ns['extensions'] == []
     assert ns['templates_path'] == ['_templates']
     assert ns['project'] == 'Sphinx Test'
@@ -158,7 +157,7 @@ def test_quickstart_all_answers(tempdir):
     conffile = tempdir / 'source' / 'conf.py'
     assert conffile.isfile()
     ns = {}
-    execfile_(conffile, ns)
+    exec(conffile.read_text(), ns)
     assert ns['extensions'] == [
         'sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.todo'
     ]
@@ -239,7 +238,7 @@ def test_default_filename(tempdir):
     conffile = tempdir / 'conf.py'
     assert conffile.isfile()
     ns = {}
-    execfile_(conffile, ns)
+    exec(conffile.read_text(), ns)
 
 
 def test_extensions(tempdir):
@@ -249,5 +248,5 @@ def test_extensions(tempdir):
     conffile = tempdir / 'conf.py'
     assert conffile.isfile()
     ns = {}
-    execfile_(conffile, ns)
+    exec(conffile.read_text(), ns)
     assert ns['extensions'] == ['foo', 'bar', 'baz']

From 73db152cf65d090ef433db9acd49107ffd21aba3 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 20 Jan 2021 23:21:11 +0900
Subject: [PATCH 093/305] Close #5560: napoleon_use_param also affect "other
 parameters" section

---
 CHANGES                              | 2 ++
 sphinx/ext/napoleon/docstring.py     | 8 +++++++-
 tests/test_ext_napoleon_docstring.py | 9 +++++++++
 3 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index d55f3dc8cd6..f9844e53b6f 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,8 @@ Incompatible changes
   MathJax configuration may have to set the old MathJax path or update their
   configuration for version 3. See :mod:`sphinx.ext.mathjax`.
 * #7784: i18n: The msgid for alt text of image is changed
+* #5560: napoleon: :confval:`napoleon_use_param` also affect "other parameters"
+  section
 * #7996: manpage: Make a section directory on build manpage by default (see
   :confval:`man_make_section_directory`)
 * #8380: html search: search results are wrapped with ``<p>`` instead of
diff --git a/sphinx/ext/napoleon/docstring.py b/sphinx/ext/napoleon/docstring.py
index 755088ca576..a5a986e4980 100644
--- a/sphinx/ext/napoleon/docstring.py
+++ b/sphinx/ext/napoleon/docstring.py
@@ -682,7 +682,13 @@ def _parse_notes_section(self, section: str) -> List[str]:
         return self._parse_generic_section(_('Notes'), use_admonition)
 
     def _parse_other_parameters_section(self, section: str) -> List[str]:
-        return self._format_fields(_('Other Parameters'), self._consume_fields())
+        if self._config.napoleon_use_param:
+            # Allow to declare multiple parameters at once (ex: x, y: int)
+            fields = self._consume_fields(multiple=True)
+            return self._format_docutils_params(fields)
+        else:
+            fields = self._consume_fields()
+            return self._format_fields(_('Other Parameters'), fields)
 
     def _parse_parameters_section(self, section: str) -> List[str]:
         if self._config.napoleon_use_param:
diff --git a/tests/test_ext_napoleon_docstring.py b/tests/test_ext_napoleon_docstring.py
index ec5f90ac201..4ee66aaa5df 100644
--- a/tests/test_ext_napoleon_docstring.py
+++ b/tests/test_ext_napoleon_docstring.py
@@ -1441,12 +1441,18 @@ def test_parameters_with_class_reference(self):
 ----------
 param1 : :class:`MyClass <name.space.MyClass>` instance
 
+Other Parameters
+----------------
+param2 : :class:`MyClass <name.space.MyClass>` instance
+
 """
 
         config = Config(napoleon_use_param=False)
         actual = str(NumpyDocstring(docstring, config))
         expected = """\
 :Parameters: **param1** (:class:`MyClass <name.space.MyClass>` instance)
+
+:Other Parameters: **param2** (:class:`MyClass <name.space.MyClass>` instance)
 """
         self.assertEqual(expected, actual)
 
@@ -1455,6 +1461,9 @@ def test_parameters_with_class_reference(self):
         expected = """\
 :param param1:
 :type param1: :class:`MyClass <name.space.MyClass>` instance
+
+:param param2:
+:type param2: :class:`MyClass <name.space.MyClass>` instance
 """
         self.assertEqual(expected, actual)
 

From 99a8b7f37fdc706ebc084b89ef3ab2fe31bc528c Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 20 Jan 2021 16:48:35 +0100
Subject: [PATCH 094/305] LaTeX: update default font configuration

This replaces times package with tgtermes and tgheros (clones of Times and
Helvetica with better LaTeX support) and the monospace font from txfonts
package (txtt). This font is better matched with Times-like fonts than
Courier clones.

The changes applies to pdflatex/platex/uplatex.

Fixes: #8711
---
 CHANGES                            |   3 +
 bindep.txt                         |   2 +
 doc/conf.py                        |  12 ---
 doc/latex.rst                      | 166 +++++++++++++----------------
 doc/usage/builders/index.rst       |  23 ++--
 sphinx/builders/latex/__init__.py  |   2 +
 sphinx/builders/latex/constants.py |  20 +++-
 sphinx/templates/latex/latex.tex_t |   1 +
 tests/test_build_latex.py          |  16 +--
 9 files changed, 116 insertions(+), 129 deletions(-)

diff --git a/CHANGES b/CHANGES
index d55f3dc8cd6..0555ac059d1 100644
--- a/CHANGES
+++ b/CHANGES
@@ -6,6 +6,7 @@ Dependencies
 
 * Drop python 3.5 support
 * Drop docutils 0.12 and 0.13 support
+* LaTeX: add ``tex-gyre`` font dependency
 
 Incompatible changes
 --------------------
@@ -56,6 +57,8 @@ Bugs fixed
 * #8380: html search: Paragraphs in search results are not identified as ``<p>``
 * #8342: Emit a warning if a unknown domain is given for directive or role (ex.
   ``:unknown:doc:``)
+* #8711: LaTeX: backticks in code-blocks trigger latexpdf build warning (and font
+  change) with late TeXLive 2019
 
 Testing
 --------
diff --git a/bindep.txt b/bindep.txt
index dfee52c2815..0c599b9f2bb 100644
--- a/bindep.txt
+++ b/bindep.txt
@@ -12,10 +12,12 @@ texlive-luatex85 [platform:rpm]
 texlive-anyfontsize [platform:rpm]
 texlive-ctablestack [platform:rpm]
 texlive-gnu-freefont [platform:rpm]
+texlive-tex-gyre [platform:rpm]
 latexmk [platform:rpm]
 
 texlive-latex-recommended [platform:dpkg]
 texlive-fonts-recommended [platform:dpkg]
+tex-gyre [platform:dpkg]
 texlive-latex-extra [platform:dpkg]
 texlive-luatex [platform:dpkg]
 latexmk [platform:dpkg]
diff --git a/doc/conf.py b/doc/conf.py
index 9f018bc7b47..deccc2e9a49 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -58,20 +58,8 @@
 latex_logo = '_static/sphinx.png'
 latex_elements = {
     'fontenc': r'\usepackage[LGR,X2,T1]{fontenc}',
-    'fontpkg': r'''
-\usepackage[sc]{mathpazo}
-\usepackage[scaled]{helvet}
-\usepackage{courier}
-\substitutefont{LGR}{\rmdefault}{cmr}
-\substitutefont{LGR}{\sfdefault}{cmss}
-\substitutefont{LGR}{\ttdefault}{cmtt}
-\substitutefont{X2}{\rmdefault}{cmr}
-\substitutefont{X2}{\sfdefault}{cmss}
-\substitutefont{X2}{\ttdefault}{cmtt}
-''',
     'passoptionstopackages': '\\PassOptionsToPackage{svgnames}{xcolor}',
     'preamble': '\\DeclareUnicodeCharacter{229E}{\\ensuremath{\\boxplus}}',
-    'fvset': '\\fvset{fontsize=auto}',
     # fix missing index entry due to RTD doing only once pdflatex after makeindex
     'printindex': r'''
 \IfFileExists{\jobname.ind}
diff --git a/doc/latex.rst b/doc/latex.rst
index 53fe9301a84..3ad7d239bdc 100644
--- a/doc/latex.rst
+++ b/doc/latex.rst
@@ -133,57 +133,33 @@ Keys that you may want to override include:
       ``babel``, not ``polyglossia``.
 
 ``'fontpkg'``
-   Font package inclusion. The default of ``'\\usepackage{times}'`` uses Times
-   for text, Helvetica for sans serif and Courier for monospace.
-
-   In order to support occasional Cyrillic (физика частиц) or Greek
-   letters (Σωματιδιακή φυσική) in a document whose language is
-   English or a Latin European one, the default set-up is enhanced (only for
-   ``'pdflatex'`` engine) to do:
-
-   .. code-block:: latex
-
-      \substitutefont{LGR}{\rmdefault}{cmr}
-      \substitutefont{LGR}{\sfdefault}{cmss}
-      \substitutefont{LGR}{\ttdefault}{cmtt}
-      \substitutefont{X2}{\rmdefault}{cmr}
-      \substitutefont{X2}{\sfdefault}{cmss}
-      \substitutefont{X2}{\ttdefault}{cmtt}
-
-   This is activated only under the condition that the ``'fontenc'`` key is
-   configured to load the ``LGR`` (Greek) and/or ``X2`` (Cyrillic)
-   pdflatex-font encodings (if the :confval:`language` is set to a Cyrillic
-   language, this ``'fontpkg'`` key must be used as "times" package has no
-   direct support for it; then keep only ``LGR`` lines from the above, if
-   support is needed for Greek in the text).
-
-   The ``\substitutefont`` command is from the eponymous LaTeX package, which
-   is loaded by Sphinx if needed (on Ubuntu Xenial it is part of
-   ``texlive-latex-extra`` which is a Sphinx requirement).
-
-   Only if the document actually does contain Unicode Greek letters (in text)
-   or Cyrillic letters, will the above default set-up cause additional
-   requirements for the PDF build. On Ubuntu Xenial, these are the
-   ``texlive-lang-greek``, ``texlive-lang-cyrillic``, and (with the above
-   choice of fonts) the ``cm-super`` (or ``cm-super-minimal``) packages.
-
-   For ``'xelatex'`` and ``'lualatex'``, the default is to use the FreeFont
-   family: this OpenType font family supports both Cyrillic and Greek scripts
-   and is available as separate Ubuntu Xenial package ``fonts-freefont-otf``.
-   It is not necessary to install the much larger ``texlive-fonts-extra``
-   package.
-
-   ``'platex'`` (Japanese documents) engine supports individual Cyrillic and
-   Greek letters with no need of extra user set-up.
-
-   Default: ``'\\usepackage{times}'`` (or ``''`` when using a Cyrillic script)
+   Font package inclusion. The default is::
+
+      r"""\usepackage{tgtermes}
+      \usepackage{tgheros}
+      \renewcommand\ttdefault{txtt}
+      """
+
+   For ``'xelatex'`` and ``'lualatex'`` however the default is to use
+   the GNU FreeFont.
 
    .. versionchanged:: 1.2
       Defaults to ``''`` when the :confval:`language` uses the Cyrillic
       script.
 
    .. versionchanged:: 2.0
-      Added support for individual Greek and Cyrillic letters:
+      Incorporates some font substitution commands to help support occasional
+      Greek or Cyrillic in a document using ``'pdflatex'`` engine.
+
+   .. versionchanged:: 4.0.0
+      - The font substitution commands added at ``2.0`` have been moved
+        to the ``'fontsubstitution'`` key, as their presence here made
+        it complicated for user to customize the value of ``'fontpkg'``.
+      - The default font setting has changed: it still uses Times and
+        Helvetica clones for serif and sans serif, but via better, more
+        complete TeX fonts and associated LaTeX packages.  The
+        monospace font has been changed to better match the Times clone.
+        
 
 ``'fncychap'``
    Inclusion of the "fncychap" package (which makes fancy chapter titles),
@@ -314,37 +290,28 @@ Keys that don't need to be overridden unless in special cases are:
    .. versionadded:: 1.2
 
 ``'fontenc'``
-   "fontenc" package inclusion.
+   Customize this from its default ``'\\usepackage[T1]{fontenc}'`` to:
 
-   If ``'pdflatex'`` is the :confval:`latex_engine`, one can add ``LGR``
-   for support of Greek letters in the document, and also ``X2`` (or
-   ``T2A``) for Cyrillic letters, like this:
+   - ``'\\usepackage[X2,T1]{fontenc}'`` if you need occasional
+     Cyrillic letters (физика частиц),
 
-   .. code-block:: latex
+   - ``'\\usepackage[LGR,T1]{fontenc}'`` if you need occasional
+     Greek letters (Σωματιδιακή φυσική).
 
-      r'\usepackage[LGR,X2,T1]{fontenc}'
+   Use ``[LGR,X2,T1]`` rather if both are needed.
 
    .. attention::
 
-      If Greek is main language, do not use this key.  Since Sphinx 2.2.1,
-      ``xelatex`` will be used automatically as :confval:`latex_engine`.
-      Formerly, Sphinx did not support producing PDF via LaTeX with Greek as
-      main language.
-
-      Prior to 2.0, Unicode Greek letters were escaped to use LaTeX math
-      mark-up.  This is not the case anymore, and the above must be used
-      (only in case of ``'pdflatex'`` engine) if the source contains such
-      Unicode Greek.
+      - Do not use this key for a :confval:`latex_engine` other than 
+        ``'pdflatex'``.
 
-      On Ubuntu xenial, packages ``texlive-lang-greek`` and ``cm-super``
-      (for the latter, only if the ``'fontpkg'`` setting is left to its
-      default) are needed for ``LGR`` to work.  In place of ``cm-super``
-      one can install smaller ``cm-super-minimal``, but it requires the
-      LaTeX document to execute ``\usepackage[10pt]{type1ec}`` before
-      loading ``fontenc``.  Thus, use this key with this extra at its
-      start if needed.
+      - If Greek is main language, do not use this key.  Since Sphinx 2.2.1,
+        ``xelatex`` will be used automatically as :confval:`latex_engine`.
 
-   Default: ``'\\usepackage[T1]{fontenc}'``
+      - The TeX installation may need some extra packages. For example,
+        on Ubuntu xenial, packages ``texlive-lang-greek`` and ``cm-super``
+        are needed for ``LGR`` to work. And ``texlive-lang-cyrillic`` and
+        ``cm-super`` are needed for support of Cyrillic.
 
    .. versionchanged:: 1.5
       Defaults to ``'\\usepackage{fontspec}'`` when
@@ -361,35 +328,40 @@ Keys that don't need to be overridden unless in special cases are:
 
    .. versionchanged:: 2.0
       Detection of ``LGR``, ``T2A``, ``X2`` to trigger support of
-      occasional Greek or Cyrillic (``'pdflatex'`` only, as this support
-      is provided natively by ``'platex'`` and only requires suitable
-      font with ``'xelatex'/'lualatex'``).
+      occasional Greek or Cyrillic letters (``'pdflatex'``).
 
    .. versionchanged:: 2.3.0
-      ``'xelatex'`` also executes
+      ``'xelatex'`` executes
       ``\defaultfontfeatures[\rmfamily,\sffamily]{}`` in order to avoid
       contractions of ``--`` into en-dash or transforms of straight quotes
       into curly ones in PDF (in non-literal text paragraphs) despite
       :confval:`smartquotes` being set to ``False``.
 
-``'textgreek'``
-   This is needed for ``pdflatex`` to support Unicode input of Greek
-   letters such as φύσις.  Expert users may want to load the ``textalpha``
-   package with its option ``normalize-symbols``.
+``'fontsubstitution'``
+   Ignored if ``'fontenc'`` was not configured to use ``LGR`` or ``X2`` (or
+   ``T2A``).  In case ``'fontpkg'`` key is configured for usage with some
+   TeX fonts known to be available in the ``LGR`` or ``X2`` encodings, set
+   this one to be the empty string.  Else leave to its default.
 
-   .. hint::
+   Ignored with :confval:`latex_engine` other than ``'pdflatex'``.
 
-      Unicode Greek (but no further Unicode symbols) in :rst:dir:`math`
-      can be supported by ``'pdflatex'`` from setting this key to
-      ``r'\usepackage{textalpha,alphabeta}'``.  Then ``:math:`α``` (U+03B1)
-      will render as :math:`\alpha`.  For wider Unicode support in math
-      input, see the discussion of :confval:`latex_engine`.
+   .. versionadded:: 4.0.0
 
-   With ``'platex'`` (Japanese),  ``'xelatex'`` or ``'lualatex'``, this
-   key is ignored.
+``'textgreek'``
+   For the support of occasional Greek letters.
+
+   It is ignored with ``'platex'``, ``'xelatex'`` or ``'lualatex'`` as
+   :confval:`latex_engine` and defaults to either the empty string or
+   to ``'\\usepackage{textalpha}'`` for ``'pdflatex'`` depending on
+   whether the ``'fontenc'`` key was used with ``LGR`` or not.  Only
+   expert LaTeX users may want to customize this key.
+
+   It can also be used as ``r'\usepackage{textalpha,alphabeta}'`` to let
+   ``'pdflatex'`` support Greek Unicode input in :rst:dir:`math` context.
+   For example ``:math:`α``` (U+03B1) will render as :math:`\alpha`.
 
-   Default: ``'\\usepackage{textalpha}'`` or ``''`` if ``fontenc`` does not
-       include the ``LGR`` option.
+   For wider Unicode support in math input, see the discussion of
+   :confval:`latex_engine`.
 
    .. versionadded:: 2.0
 
@@ -500,19 +472,25 @@ Keys that don't need to be overridden unless in special cases are:
    Default: ``'\\printindex'``
 
 ``'fvset'``
-   Customization of ``fancyvrb`` LaTeX package. The default value of
-   ``'\\fvset{fontsize=\\small}'`` is used to adjust for the large character
-   width of the monospace font, used in code-blocks.  You may need to modify
-   this if you use custom fonts.
+   Customization of ``fancyvrb`` LaTeX package.
 
-   Default: ``'\\fvset{fontsize=\\small}'``
+   The default value is ``'\\fvset{fontsize=auto}'`` which means that the
+   font size will adjust correctly if a code-block ends up in a footnote.
+   You may need to modify this if you use custom fonts:
+   ``'\\fvset{fontsize=\\small}'`` if the monospace font is Courier-like.
+
+   Default: ``'\\fvset{fontsize=auto}'``
 
    .. versionadded:: 1.8
 
    .. versionchanged:: 2.0
-      Due to new default font choice for ``'xelatex'`` and ``'lualatex'``
-      (FreeFont), Sphinx does ``\\fvset{fontsize=\\small}`` also with these
-      engines (and not ``\\fvset{fontsize=auto}``).
+      For ``'xelatex'`` and ``'lualatex'`` defaults to
+      ``'\\fvset{fontsize=\\small}'`` as this
+      is adapted to the relative widths of the FreeFont family.
+
+   .. versionchanged:: 4.0.0
+      Changed default for ``'pdflatex'``. Previously it was using 
+      ``'\\fvset{fontsize=\\small}'``.
 
 Keys that are set by other options and therefore should not be overridden are:
 
diff --git a/doc/usage/builders/index.rst b/doc/usage/builders/index.rst
index c45a8062fbb..74853fee971 100644
--- a/doc/usage/builders/index.rst
+++ b/doc/usage/builders/index.rst
@@ -179,6 +179,7 @@ The builder's "name" must be given to the **-b** command-line option of
 
    * ``texlive-latex-recommended``
    * ``texlive-fonts-recommended``
+   * ``tex-gyre`` (if :confval:`latex_engine` is ``'pdflatex'``)
    * ``texlive-latex-extra``
    * ``latexmk`` (this is a Sphinx requirement on GNU/Linux and MacOS X
      for functioning of ``make latexpdf``)
@@ -186,17 +187,14 @@ The builder's "name" must be given to the **-b** command-line option of
    Additional packages are needed in some circumstances (see the discussion of
    the ``'fontpkg'`` key of :confval:`latex_elements` for more information):
 
-   * to support occasional Cyrillic letters or words, and a fortiori if
-     :confval:`language` is set to a Cyrillic language, the package
-     ``texlive-lang-cyrillic`` is required, and, with unmodified ``'fontpkg'``,
-     also ``cm-super`` or ``cm-super-minimal``,
-   * to support occasional Greek letters or words (in text, not in
-     :rst:dir:`math` directive contents), ``texlive-lang-greek`` is required,
-     and, with unmodified ``'fontpkg'``, also ``cm-super`` or
-     ``cm-super-minimal``,
-   * for ``'xelatex'`` or ``'lualatex'`` (see :confval:`latex_engine`),
-     ``texlive-xetex`` resp. ``texlive-luatex``, and, if leaving unchanged
-     ``'fontpkg'``, ``fonts-freefont-otf``.
+   * ``texlive-lang-cyrillic`` for Cyrillic (even individual letters), and,
+     ``cm-super`` or ``cm-super-minimal`` (if default fonts),
+   * ``texlive-lang-greek`` for Greek (even individual letters), and,
+     ``cm-super`` or ``cm-super-minimal`` (if default fonts),
+   * ``texlive-xetex`` if :confval:`latex_engine` is ``'xelatex'``,
+   * ``texlive-luatex`` if :confval:`latex_engine` is ``'lualatex'``,
+   * ``fonts-freefont-otf`` if :confval:`latex_engine` is ``'xelatex'``
+     or ``'lualatex'``.
 
    The testing of Sphinx LaTeX is done on Ubuntu xenial whose TeX distribution
    is based on a TeXLive 2015 snapshot dated March 2016.
@@ -207,6 +205,9 @@ The builder's "name" must be given to the **-b** command-line option of
    .. versionchanged:: 2.0
       Formerly, testing had been done on Ubuntu trusty (TeXLive 2013).
 
+   .. versionchanged:: 4.0.0
+      TeX Gyre fonts dependency for the default LaTeX font configuration.
+
    .. note::
 
       Since 1.6, ``make latexpdf`` uses ``latexmk`` (not on Windows).  This
diff --git a/sphinx/builders/latex/__init__.py b/sphinx/builders/latex/__init__.py
index dc5b6651810..efe922fa58e 100644
--- a/sphinx/builders/latex/__init__.py
+++ b/sphinx/builders/latex/__init__.py
@@ -224,6 +224,8 @@ def init_multilingual(self) -> None:
                 self.context['substitutefont'] = '\\usepackage{substitutefont}'
             else:
                 self.context['textgreek'] = ''
+            if self.context['substitutefont'] == '':
+                self.context['fontsubstitution'] = ''
 
         # 'babel' key is public and user setting must be obeyed
         if self.context['babel']:
diff --git a/sphinx/builders/latex/constants.py b/sphinx/builders/latex/constants.py
index 0b20c7cef75..e929736a75f 100644
--- a/sphinx/builders/latex/constants.py
+++ b/sphinx/builders/latex/constants.py
@@ -11,7 +11,12 @@
 from typing import Any, Dict
 
 PDFLATEX_DEFAULT_FONTPKG = r'''
-\usepackage{times}
+\usepackage{tgtermes}
+\usepackage{tgheros}
+\renewcommand{\ttdefault}{txtt}
+'''
+
+PDFLATEX_DEFAULT_FONTSUBSTITUTION = r'''
 \expandafter\ifx\csname T@LGR\endcsname\relax
 \else
 % LGR was declared as font encoding
@@ -76,7 +81,7 @@
     'maxlistdepth':    '',
     'sphinxpkgoptions':     '',
     'sphinxsetup':     '',
-    'fvset':           '\\fvset{fontsize=\\small}',
+    'fvset':           '\\fvset{fontsize=auto}',
     'passoptionstopackages': '',
     'geometry':        '\\usepackage{geometry}',
     'inputenc':        '',
@@ -88,6 +93,7 @@
     'babel':           '\\usepackage{babel}',
     'polyglossia':     '',
     'fontpkg':         PDFLATEX_DEFAULT_FONTPKG,
+    'fontsubstitution': PDFLATEX_DEFAULT_FONTSUBSTITUTION,
     'substitutefont':  '',
     'textcyrillic':    '',
     'textgreek':       '\\usepackage{textalpha}',
@@ -142,6 +148,8 @@
         'fontenc':     ('\\usepackage{fontspec}\n'
                         '\\defaultfontfeatures[\\rmfamily,\\sffamily,\\ttfamily]{}'),
         'fontpkg':      XELATEX_DEFAULT_FONTPKG,
+        'fvset':        '\\fvset{fontsize=\\small}',
+        'fontsubstitution': '',
         'textgreek':    '',
         'utf8extra':   ('\\catcode`^^^^00a0\\active\\protected\\def^^^^00a0'
                         '{\\leavevmode\\nobreak\\ }'),
@@ -153,6 +161,8 @@
         'fontenc':     ('\\usepackage{fontspec}\n'
                         '\\defaultfontfeatures[\\rmfamily,\\sffamily,\\ttfamily]{}'),
         'fontpkg':      LUALATEX_DEFAULT_FONTPKG,
+        'fvset':        '\\fvset{fontsize=\\small}',
+        'fontsubstitution': '',
         'textgreek':    '',
         'utf8extra':   ('\\catcode`^^^^00a0\\active\\protected\\def^^^^00a0'
                         '{\\leavevmode\\nobreak\\ }'),
@@ -161,7 +171,8 @@
         'latex_engine': 'platex',
         'babel':        '',
         'classoptions': ',dvipdfmx',
-        'fontpkg':      '\\usepackage{times}',
+        'fontpkg':      PDFLATEX_DEFAULT_FONTPKG,
+        'fontsubstitution': '',
         'textgreek':    '',
         'fncychap':     '',
         'geometry':     '\\usepackage[dvipdfm]{geometry}',
@@ -170,7 +181,8 @@
         'latex_engine': 'uplatex',
         'babel':        '',
         'classoptions': ',dvipdfmx',
-        'fontpkg':      '\\usepackage{times}',
+        'fontpkg':      PDFLATEX_DEFAULT_FONTPKG,
+        'fontsubstitution': '',
         'textgreek':    '',
         'fncychap':     '',
         'geometry':     '\\usepackage[dvipdfm]{geometry}',
diff --git a/sphinx/templates/latex/latex.tex_t b/sphinx/templates/latex/latex.tex_t
index 5082254e7e8..88efab8f0a2 100644
--- a/sphinx/templates/latex/latex.tex_t
+++ b/sphinx/templates/latex/latex.tex_t
@@ -29,6 +29,7 @@
 <%= substitutefont %>
 <%= textcyrillic %>
 <%= fontpkg %>
+<%= fontsubstitution %>
 <%= textgreek %>
 <%= fncychap %>
 \usepackage<%= sphinxpkgoptions %>{sphinx}
diff --git a/tests/test_build_latex.py b/tests/test_build_latex.py
index 58b9bc419e9..c4584a15ed9 100644
--- a/tests/test_build_latex.py
+++ b/tests/test_build_latex.py
@@ -524,7 +524,7 @@ def test_babel_with_no_language_settings(app, status, warning):
     print(warning.getvalue())
     assert '\\documentclass[letterpaper,10pt,english]{sphinxmanual}' in result
     assert '\\usepackage{babel}' in result
-    assert '\\usepackage{times}' in result
+    assert '\\usepackage{tgtermes}' in result
     assert '\\usepackage[Bjarne]{fncychap}' in result
     assert ('\\addto\\captionsenglish{\\renewcommand{\\contentsname}{Table of content}}\n'
             in result)
@@ -549,7 +549,7 @@ def test_babel_with_language_de(app, status, warning):
     print(warning.getvalue())
     assert '\\documentclass[letterpaper,10pt,ngerman]{sphinxmanual}' in result
     assert '\\usepackage{babel}' in result
-    assert '\\usepackage{times}' in result
+    assert '\\usepackage{tgtermes}' in result
     assert '\\usepackage[Sonny]{fncychap}' in result
     assert ('\\addto\\captionsngerman{\\renewcommand{\\contentsname}{Table of content}}\n'
             in result)
@@ -574,7 +574,7 @@ def test_babel_with_language_ru(app, status, warning):
     print(warning.getvalue())
     assert '\\documentclass[letterpaper,10pt,russian]{sphinxmanual}' in result
     assert '\\usepackage{babel}' in result
-    assert '\\usepackage{times}' not in result
+    assert '\\usepackage{tgtermes}' not in result
     assert '\\usepackage[Sonny]{fncychap}' in result
     assert ('\\addto\\captionsrussian{\\renewcommand{\\contentsname}{Table of content}}\n'
             in result)
@@ -599,7 +599,7 @@ def test_babel_with_language_tr(app, status, warning):
     print(warning.getvalue())
     assert '\\documentclass[letterpaper,10pt,turkish]{sphinxmanual}' in result
     assert '\\usepackage{babel}' in result
-    assert '\\usepackage{times}' in result
+    assert '\\usepackage{tgtermes}' in result
     assert '\\usepackage[Sonny]{fncychap}' in result
     assert ('\\addto\\captionsturkish{\\renewcommand{\\contentsname}{Table of content}}\n'
             in result)
@@ -624,7 +624,7 @@ def test_babel_with_language_ja(app, status, warning):
     print(warning.getvalue())
     assert '\\documentclass[letterpaper,10pt,dvipdfmx]{sphinxmanual}' in result
     assert '\\usepackage{babel}' not in result
-    assert '\\usepackage{times}' in result
+    assert '\\usepackage{tgtermes}' in result
     assert '\\usepackage[Sonny]{fncychap}' not in result
     assert '\\renewcommand{\\contentsname}{Table of content}\n' in result
     assert '\\shorthandoff' not in result
@@ -648,7 +648,7 @@ def test_babel_with_unknown_language(app, status, warning):
     print(warning.getvalue())
     assert '\\documentclass[letterpaper,10pt,english]{sphinxmanual}' in result
     assert '\\usepackage{babel}' in result
-    assert '\\usepackage{times}' in result
+    assert '\\usepackage{tgtermes}' in result
     assert '\\usepackage[Sonny]{fncychap}' in result
     assert ('\\addto\\captionsenglish{\\renewcommand{\\contentsname}{Table of content}}\n'
             in result)
@@ -676,7 +676,7 @@ def test_polyglossia_with_language_de(app, status, warning):
     assert '\\documentclass[letterpaper,10pt,german]{sphinxmanual}' in result
     assert '\\usepackage{polyglossia}' in result
     assert '\\setmainlanguage[spelling=new]{german}' in result
-    assert '\\usepackage{times}' not in result
+    assert '\\usepackage{tgtermes}' not in result
     assert '\\usepackage[Sonny]{fncychap}' in result
     assert ('\\addto\\captionsgerman{\\renewcommand{\\contentsname}{Table of content}}\n'
             in result)
@@ -702,7 +702,7 @@ def test_polyglossia_with_language_de_1901(app, status, warning):
     assert '\\documentclass[letterpaper,10pt,german]{sphinxmanual}' in result
     assert '\\usepackage{polyglossia}' in result
     assert '\\setmainlanguage[spelling=old]{german}' in result
-    assert '\\usepackage{times}' not in result
+    assert '\\usepackage{tgtermes}' not in result
     assert '\\usepackage[Sonny]{fncychap}' in result
     assert ('\\addto\\captionsgerman{\\renewcommand{\\contentsname}{Table of content}}\n'
             in result)

From 3919d7313c7380c53af2604f095a0c0ad6d98f58 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Thu, 21 Jan 2021 10:10:48 +0100
Subject: [PATCH 095/305] pour tester token

	new file:   dummy
---
 dummy | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 dummy

diff --git a/dummy b/dummy
new file mode 100644
index 00000000000..e69de29bb2d

From 43ed4897534e2c3bc893d9698688525fbc44a31b Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Thu, 21 Jan 2021 10:11:44 +0100
Subject: [PATCH 096/305] test

---
 dummy | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dummy b/dummy
index e69de29bb2d..0e46b3147d0 100644
--- a/dummy
+++ b/dummy
@@ -0,0 +1 @@
+baba

From 753f5404b9af39c7d29aa0e9ecd12d4bcbea92d1 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Thu, 21 Jan 2021 10:13:56 +0100
Subject: [PATCH 097/305] test

---
 dummy | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dummy b/dummy
index 0e46b3147d0..293c09e23ca 100644
--- a/dummy
+++ b/dummy
@@ -1 +1,2 @@
 baba
+uuu

From a23781a2e540ff84ee4b40990833aa69f639ac8b Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Thu, 21 Jan 2021 10:22:14 +0100
Subject: [PATCH 098/305] Cleaning up accidental mess

My apologies.  I was testing authentication token, pushing master to my
forked repo.  But I ended up accidentally pushing to sphinx-doc/sphinx,
and force pushing afterwards to clean up then was rejected.

	deleted:    dummy
---
 dummy | 2 --
 1 file changed, 2 deletions(-)
 delete mode 100644 dummy

diff --git a/dummy b/dummy
deleted file mode 100644
index 293c09e23ca..00000000000
--- a/dummy
+++ /dev/null
@@ -1,2 +0,0 @@
-baba
-uuu

From a957d6f7108f2ada9f5c9314d2077f6ccba1fe57 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 23 Jan 2021 15:31:24 +0900
Subject: [PATCH 099/305] refactor: html theme: Insert documentation_options.js
 via script_files

---
 CHANGES                          | 2 ++
 sphinx/builders/html/__init__.py | 4 ++++
 sphinx/themes/basic/layout.html  | 3 ---
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 35cea7ce45e..29f34fb82e7 100644
--- a/CHANGES
+++ b/CHANGES
@@ -22,6 +22,8 @@ Incompatible changes
   :confval:`man_make_section_directory`)
 * #8380: html search: search results are wrapped with ``<p>`` instead of
   ``<div>``
+* html theme: Move a script tag for documentation_options.js in
+  basic/layout.html to ``script_files`` variable
 * html theme: Move CSS tags in basic/layout.html to ``css_files`` variable
 * #8508: LaTeX: uplatex becomes a default setting of latex_engine for Japanese
   documents
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index a5dfe4104aa..4e8d6a007dd 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -310,6 +310,8 @@ def add_css_file(self, filename: str, **kwargs: Any) -> None:
         self.css_files.append(Stylesheet(filename, **kwargs))  # type: ignore
 
     def init_js_files(self) -> None:
+        self.add_js_file('documentation_options.js', id="documentation_options",
+                         data_url_root='', priority=200)
         self.add_js_file('jquery.js', priority=200)
         self.add_js_file('underscore.js', priority=200)
         self.add_js_file('doctools.js', priority=200)
@@ -1139,6 +1141,8 @@ def js_tag(js: JavaScript) -> str:
                 if value is not None:
                     if key == 'body':
                         body = value
+                    elif key == 'data_url_root':
+                        attrs.append('data-url_root="%s"' % pathto('', resource=True))
                     else:
                         attrs.append('%s="%s"' % (key, html.escape(value, True)))
             if js.filename:
diff --git a/sphinx/themes/basic/layout.html b/sphinx/themes/basic/layout.html
index bae8ddd6845..8d1e4f60855 100644
--- a/sphinx/themes/basic/layout.html
+++ b/sphinx/themes/basic/layout.html
@@ -17,9 +17,7 @@
 {%- set reldelim2 = reldelim2 is not defined and ' |' or reldelim2 %}
 {%- set render_sidebar = (not embedded) and (not theme_nosidebar|tobool) and
                          (sidebars != []) %}
-{%- set url_root = pathto('', 1) %}
 {# URL root should never be #, then all links are fragments #}
-{%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
 {%- if not embedded and docstitle %}
   {%- set titlesuffix = " &#8212; "|safe + docstitle|e %}
 {%- else %}
@@ -88,7 +86,6 @@ <h3>{{ _('Navigation') }}</h3>
 {%- endmacro %}
 
 {%- macro script() %}
-    <script id="documentation_options" data-url_root="{{ url_root }}" src="{{ pathto('_static/documentation_options.js', 1) }}"></script>
     {%- for js in script_files %}
     {{ js_tag(js) }}
     {%- endfor %}

From 05eb3c6054fbf8777abf07f711fb82da9b35be4e Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 3 Jan 2021 23:23:01 +0900
Subject: [PATCH 100/305] refactor: Index class becomes subclasses of abc.ABC

The `Index` class becomes subclasses of `abc.ABC` to indicate
methods that must be overrided in the concrete classes.
---
 CHANGES                    | 2 ++
 sphinx/domains/__init__.py | 4 +++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 35cea7ce45e..641779ddc91 100644
--- a/CHANGES
+++ b/CHANGES
@@ -10,6 +10,8 @@ Dependencies
 Incompatible changes
 --------------------
 
+* domain: The ``Index`` class becomes subclasses of ``abc.ABC`` to indicate
+  methods that must be overrided in the concrete classes
 * #4826: py domain: The structure of python objects is changed.  A boolean value
   is added to indicate that the python object is canonical one
 * #7425: MathJax: The MathJax was changed from 2 to 3. Users using a custom
diff --git a/sphinx/domains/__init__.py b/sphinx/domains/__init__.py
index 3439ea93c77..d241b1523b7 100644
--- a/sphinx/domains/__init__.py
+++ b/sphinx/domains/__init__.py
@@ -10,6 +10,7 @@
 """
 
 import copy
+from abc import ABC, abstractmethod
 from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterable, List, NamedTuple, Tuple,
                     Type, Union, cast)
 
@@ -64,7 +65,7 @@ class IndexEntry(NamedTuple):
     descr: str
 
 
-class Index:
+class Index(ABC):
     """
     An Index is the description for a domain-specific index.  To add an index to
     a domain, subclass Index, overriding the three name attributes:
@@ -97,6 +98,7 @@ def __init__(self, domain: "Domain") -> None:
                               % self.__class__.__name__)
         self.domain = domain
 
+    @abstractmethod
     def generate(self, docnames: Iterable[str] = None
                  ) -> Tuple[List[Tuple[str, List[IndexEntry]]], bool]:
         """Get entries for the index.

From bd63ae99506ca89346953a0052fdf1ad691e9265 Mon Sep 17 00:00:00 2001
From: Steve Piercy <web@stevepiercy.com>
Date: Sat, 23 Jan 2021 00:08:57 -0800
Subject: [PATCH 101/305] Update the link to the new sphinx-contrib
 organization

This should be backported to at least 3.x, too.
---
 doc/usage/extensions/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/extensions/index.rst b/doc/usage/extensions/index.rst
index 6aab8adb2cf..3b99701731e 100644
--- a/doc/usage/extensions/index.rst
+++ b/doc/usage/extensions/index.rst
@@ -56,7 +56,7 @@ If you write an extension that you think others will find useful or you think
 should be included as a part of Sphinx, please write to the project mailing
 list (`join here <https://groups.google.com/forum/#!forum/sphinx-dev>`_).
 
-.. _Sphinx Contrib: https://bitbucket.org/birkenfeld/sphinx-contrib
+.. _Sphinx Contrib: https://github.com/sphinx-contrib
 
 Where to put your own extensions?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 3f5fc6278c6aef3dbb967d721c92b7618f5bd126 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 23 Jan 2021 18:39:27 +0900
Subject: [PATCH 102/305] refactor: Add sphinx.util:isurl()

---
 sphinx/builders/html/__init__.py | 25 +++++++++++++------------
 sphinx/util/__init__.py          |  8 ++++++++
 2 files changed, 21 insertions(+), 12 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 83a4cccd541..9db889c27fc 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -15,7 +15,7 @@
 import warnings
 from os import path
 from typing import IO, Any, Dict, Iterable, Iterator, List, Set, Tuple
-from urllib.parse import quote, urlparse
+from urllib.parse import quote
 
 from docutils import nodes
 from docutils.core import publish_parts
@@ -38,7 +38,7 @@
 from sphinx.locale import _, __
 from sphinx.search import js_index
 from sphinx.theming import HTMLThemeFactory
-from sphinx.util import logging, md5, progress_message, status_iterator
+from sphinx.util import isurl, logging, md5, progress_message, status_iterator
 from sphinx.util.docutils import is_html5_writer_available, new_document
 from sphinx.util.fileutil import copy_asset
 from sphinx.util.i18n import format_date
@@ -773,12 +773,12 @@ def onerror(filename: str, error: Exception) -> None:
                        excluded, context=context, renderer=self.templates, onerror=onerror)
 
     def copy_html_logo(self) -> None:
-        if self.config.html_logo and not urlparse(self.config.html_logo).scheme:
+        if self.config.html_logo and not isurl(self.config.html_logo):
             copy_asset(path.join(self.confdir, self.config.html_logo),
                        path.join(self.outdir, '_static'))
 
     def copy_html_favicon(self) -> None:
-        if self.config.html_favicon and not urlparse(self.config.html_favicon).scheme:
+        if self.config.html_favicon and not isurl(self.config.html_favicon):
             copy_asset(path.join(self.confdir, self.config.html_favicon),
                        path.join(self.outdir, '_static'))
 
@@ -957,12 +957,11 @@ def proc_resource_ref(self, uri: str) -> str:
         """Parse uri of a resource file and return its reference. If its a local file,
         return the name of the file.
         """
-        parse_result = urlparse(uri)
         ref = ''
-        if parse_result.scheme:
+        if isurl(uri):
             ref = uri
-        elif parse_result.path:
-            ref = path.join('_static', path.basename(parse_result.path))
+        elif uri:
+            ref = path.join('_static', path.basename(uri))
         return ref
 
     # --------- these are overwritten by the serialization builder
@@ -1188,16 +1187,18 @@ def validate_html_static_path(app: Sphinx, config: Config) -> None:
 
 def validate_html_logo(app: Sphinx, config: Config) -> None:
     """Check html_logo setting."""
-    if config.html_logo and not path.isfile(path.join(app.confdir, config.html_logo)) \
-            and not urlparse(config.html_logo).scheme:
+    if (config.html_logo and
+            not path.isfile(path.join(app.confdir, config.html_logo)) and
+            not isurl(config.html_logo)):
         logger.warning(__('logo file %r does not exist'), config.html_logo)
         config.html_logo = None  # type: ignore
 
 
 def validate_html_favicon(app: Sphinx, config: Config) -> None:
     """Check html_favicon setting."""
-    if config.html_favicon and not path.isfile(path.join(app.confdir, config.html_favicon)) \
-            and not urlparse(config.html_favicon).scheme:
+    if (config.html_favicon and
+            not path.isfile(path.join(app.confdir, config.html_favicon)) and
+            not isurl(config.html_favicon)):
         logger.warning(__('favicon file %r does not exist'), config.html_favicon)
         config.html_favicon = None  # type: ignore
 
diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index 9349ed0e498..c289f5cf8f6 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -638,6 +638,14 @@ def encode_uri(uri: str) -> str:
     return urlunsplit(split)
 
 
+def isurl(url: str) -> bool:
+    """Check *url* is URL or not."""
+    if url and '://' in url:
+        return True
+    else:
+        return False
+
+
 def display_chunk(chunk: Any) -> str:
     if isinstance(chunk, (list, tuple)):
         if len(chunk) == 1:

From 65a69965a1dba7e8f61caf53d3d8a9251eab4e19 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 23 Jan 2021 20:39:09 +0900
Subject: [PATCH 103/305] html theme: Add `favicon_url` and `logo_url`

To embed the external favicon and logo image, this adds new template
variable `favicon_url` and `logo_url` that point the external URL or
relative path for the favicon/logo file from current file.  It helps to
use it on template files.
---
 CHANGES                            |  1 +
 doc/extdev/deprecated.rst          | 10 ++++++++++
 doc/templating.rst                 | 28 ++++++++++++++++++++++++++--
 sphinx/builders/html/__init__.py   | 25 +++++++++++++++++++++++--
 sphinx/themes/agogo/layout.html    |  4 ++--
 sphinx/themes/basic/layout.html    |  8 ++++----
 sphinx/themes/basic/opensearch.xml |  4 ++--
 sphinx/themes/haiku/layout.html    |  4 ++--
 8 files changed, 70 insertions(+), 14 deletions(-)

diff --git a/CHANGES b/CHANGES
index 2aea319674a..8ffe557d501 100644
--- a/CHANGES
+++ b/CHANGES
@@ -13,6 +13,7 @@ Incompatible changes
 Deprecated
 ----------
 
+* ``favicon`` and ``logo`` variable in HTML templates
 * The ``follow_wrapped`` argument of ``sphinx.util.inspect.signature()``
 * ``sphinx.ext.autodoc.Documenter.get_object_members()``
 * ``sphinx.ext.autodoc.DataDeclarationDocumenter``
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index bbd9d283e52..0101798bbb6 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -26,6 +26,16 @@ The following is a list of deprecated interfaces.
      - (will be) Removed
      - Alternatives
 
+   * - ``favicon`` variable in HTML templates
+     - 3.4
+     - TBD
+     - ``favicon_url``
+
+   * - ``logo`` variable in HTML templates
+     - 3.4
+     - TBD
+     - ``logo_url``
+
    * - The ``follow_wrapped`` argument of ``sphinx.util.inspect.signature()``
      - 3.4
      - 5.0
diff --git a/doc/templating.rst b/doc/templating.rst
index 548f8b8d93e..97596e6a923 100644
--- a/doc/templating.rst
+++ b/doc/templating.rst
@@ -274,7 +274,19 @@ in the future.
 
 .. data:: favicon
 
-   The path to the HTML favicon in the static path, or ``''``.
+   The path to the HTML favicon in the static path, or URL to the favicon, or
+   ``''``.
+
+   .. deprecated:: 4.0
+
+      Recommend to use ``favicon_url`` instead.
+
+.. data:: favicon_url
+
+   The relative path to the HTML favicon image from the current document, or
+   URL to the favicon, or ``''``.
+
+   .. versionadded:: 4.0
 
 .. data:: file_suffix
 
@@ -297,7 +309,19 @@ in the future.
 
 .. data:: logo
 
-   The path to the HTML logo image in the static path, or ``''``.
+   The path to the HTML logo image in the static path, or URL to the logo, or
+   ``''``.
+
+   .. deprecated:: 4.0
+
+      Recommend to use ``logo_url`` instead.
+
+.. data:: logo_url
+
+   The relative path to the HTML logo image from the current document, or URL
+   to the logo, or ``''``.
+
+   .. versionadded:: 4.0
 
 .. data:: master_doc
 
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 9db889c27fc..08f2e578521 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -444,8 +444,8 @@ def prepare_writing(self, docnames: Set[str]) -> None:
         else:
             self.last_updated = None
 
-        logo = self.proc_resource_ref(self.config.html_logo)
-        favicon = self.proc_resource_ref(self.config.html_favicon)
+        logo = path.basename(self.config.html_logo) if self.config.html_logo else ''
+        favicon = path.basename(self.config.html_favicon) if self.config.html_favicon else ''
 
         if not isinstance(self.config.html_use_opensearch, str):
             logger.warning(__('html_use_opensearch config value must now be a string'))
@@ -1147,6 +1147,26 @@ def js_tag(js: JavaScript) -> str:
     context['js_tag'] = js_tag
 
 
+def setup_resource_paths(app: Sphinx, pagename: str, templatename: str,
+                         context: Dict, doctree: Node) -> None:
+    """Set up relative resource paths."""
+    pathto = context.get('pathto')
+
+    # favicon_url
+    favicon = context.get('favicon')
+    if not isurl(favicon):
+        context['favicon_url'] = pathto('_static/' + favicon, resource=True)
+    else:
+        context['favicon_url'] = favicon
+
+    # logo_url
+    logo = context.get('logo')
+    if not isurl(logo):
+        context['logo_url'] = pathto('_static/' + logo, resource=True)
+    else:
+        context['logo_url'] = logo
+
+
 def validate_math_renderer(app: Sphinx) -> None:
     if app.builder.format != 'html':
         return
@@ -1267,6 +1287,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.connect('config-inited', validate_html_favicon, priority=800)
     app.connect('builder-inited', validate_math_renderer)
     app.connect('html-page-context', setup_js_tag_helper)
+    app.connect('html-page-context', setup_resource_paths)
 
     # load default math renderer
     app.setup_extension('sphinx.ext.mathjax')
diff --git a/sphinx/themes/agogo/layout.html b/sphinx/themes/agogo/layout.html
index cd9ff8d205b..2e472cd9c05 100644
--- a/sphinx/themes/agogo/layout.html
+++ b/sphinx/themes/agogo/layout.html
@@ -13,9 +13,9 @@
 {% block header %}
     <div class="header-wrapper" role="banner">
       <div class="header">
-        {%- if logo %}
+        {%- if logo_url %}
           <p class="logo"><a href="{{ pathto(master_doc)|e }}">
-            <img class="logo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
+            <img class="logo" src="{{ logo_url|e }}" alt="Logo"/>
           </a></p>
         {%- endif %}
         {%- block headertitle %}
diff --git a/sphinx/themes/basic/layout.html b/sphinx/themes/basic/layout.html
index 347ac2cc689..fd217b143ec 100644
--- a/sphinx/themes/basic/layout.html
+++ b/sphinx/themes/basic/layout.html
@@ -53,9 +53,9 @@ <h3>{{ _('Navigation') }}</h3>
       <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
         <div class="sphinxsidebarwrapper">
           {%- block sidebarlogo %}
-          {%- if logo %}
+          {%- if logo_url %}
             <p class="logo"><a href="{{ pathto(master_doc)|e }}">
-              <img class="logo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
+              <img class="logo" src="{{ logo_url|e }}" alt="Logo"/>
             </a></p>
           {%- endif %}
           {%- endblock %}
@@ -140,8 +140,8 @@ <h3>{{ _('Navigation') }}</h3>
           title="{% trans docstitle=docstitle|e %}Search within {{ docstitle }}{% endtrans %}"
           href="{{ pathto('_static/opensearch.xml', 1) }}"/>
     {%- endif %}
-    {%- if favicon %}
-    <link rel="shortcut icon" href="{{ pathto(favicon, 1)|e }}"/>
+    {%- if favicon_url %}
+    <link rel="shortcut icon" href="{{ favicon_url|e }}"/>
     {%- endif %}
     {%- endif %}
 {%- block linktags %}
diff --git a/sphinx/themes/basic/opensearch.xml b/sphinx/themes/basic/opensearch.xml
index ad6273e44b1..ca7bb59666b 100644
--- a/sphinx/themes/basic/opensearch.xml
+++ b/sphinx/themes/basic/opensearch.xml
@@ -6,8 +6,8 @@
   <Url type="text/html" method="get"
        template="{{ use_opensearch }}/{{ pathto('search') }}?q={searchTerms}"/>
   <LongName>{{ docstitle|e }}</LongName>
-{%- if favicon %}
-  <Image height="16" width="16" type="image/x-icon">{{ use_opensearch }}/{{ pathto(favicon, 1)|e }}</Image>
+{%- if favicon_url %}
+  <Image height="16" width="16" type="image/x-icon">{{ use_opensearch }}/{{ favicon_url|e }}</Image>
 {%- endif %}
 {% block extra %} {# Put e.g. an <Image> element here. #} {% endblock %}
 </OpenSearchDescription>
diff --git a/sphinx/themes/haiku/layout.html b/sphinx/themes/haiku/layout.html
index 07f801007df..06930504ddd 100644
--- a/sphinx/themes/haiku/layout.html
+++ b/sphinx/themes/haiku/layout.html
@@ -36,11 +36,11 @@
         {%- block haikuheader %}
         {%- if theme_full_logo != "false" %}
         <a href="{{ pathto('index') }}">
-          <img class="logo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
+          <img class="logo" src="{{ logo_url|e }}" alt="Logo"/>
         </a>
         {%- else %}
         {%- if logo -%}
-          <img class="rightlogo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
+          <img class="rightlogo" src="{{ logo_url|e }}" alt="Logo"/>
         {%- endif -%}
         <h1 class="heading"><a href="{{ pathto('index') }}">
           <span>{{ shorttitle|e }}</span></a></h1>

From 76d0a0be82ea1935d82fdd5672519c0870b6261a Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 23 Jan 2021 20:45:03 +0900
Subject: [PATCH 104/305] Update CHANGES

---
 CHANGES                   | 2 +-
 doc/extdev/deprecated.rst | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 8627b6763d6..8f1cb8375dc 100644
--- a/CHANGES
+++ b/CHANGES
@@ -36,6 +36,7 @@ Incompatible changes
 Deprecated
 ----------
 
+* ``favicon`` and ``logo`` variable in HTML templates
 * ``sphinx.directives.patches.CSVTable``
 * ``sphinx.directives.patches.ListTable``
 * ``sphinx.directives.patches.RSTTable``
@@ -226,7 +227,6 @@ Incompatible changes
 Deprecated
 ----------
 
-* ``favicon`` and ``logo`` variable in HTML templates
 * The ``follow_wrapped`` argument of ``sphinx.util.inspect.signature()``
 * The ``no_docstring`` argument of
   ``sphinx.ext.autodoc.Documenter.add_content()``
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index c7c18b8035c..4cf48cba135 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -27,12 +27,12 @@ The following is a list of deprecated interfaces.
      - Alternatives
 
    * - ``favicon`` variable in HTML templates
-     - 3.4
+     - 4.0
      - TBD
      - ``favicon_url``
 
    * - ``logo`` variable in HTML templates
-     - 3.4
+     - 4.0
      - TBD
      - ``logo_url``
 

From 7cfcd81b768730d931664b64a1aedbe29fb7b413 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 23 Jan 2021 20:49:15 +0900
Subject: [PATCH 105/305] doc: html_favicon and html_logo accept URL now

---
 doc/usage/configuration.rst | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index ba5c15bb3b7..a0ff6b99916 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -987,26 +987,32 @@ that use Sphinx's HTMLWriter class.
 .. confval:: html_logo
 
    If given, this must be the name of an image file (path relative to the
-   :term:`configuration directory`) that is the logo of the docs.  It is placed
-   at the top of the sidebar; its width should therefore not exceed 200 pixels.
-   Default: ``None``.
+   :term:`configuration directory`) that is the logo of the docs, or URL that
+   points an image file for the logo.  It is placed at the top of the sidebar;
+   its width should therefore not exceed 200 pixels.  Default: ``None``.
 
    .. versionadded:: 0.4.1
       The image file will be copied to the ``_static`` directory of the output
       HTML, but only if the file does not already exist there.
 
+   .. versionchanged:: 4.0
+      Also accepts the URL for the logo file.
+
 .. confval:: html_favicon
 
    If given, this must be the name of an image file (path relative to the
-   :term:`configuration directory`) that is the favicon of the docs.  Modern
-   browsers use this as the icon for tabs, windows and bookmarks.  It should
-   be a Windows-style icon file (``.ico``), which is 16x16 or 32x32
-   pixels large.  Default: ``None``.
+   :term:`configuration directory`) that is the favicon of the docs, or URL that
+   points an image file for the favicon.  Modern browsers use this as the icon
+   for tabs, windows and bookmarks.  It should be a Windows-style icon file
+   (``.ico``), which is 16x16 or 32x32 pixels large.  Default: ``None``.
 
    .. versionadded:: 0.4
       The image file will be copied to the ``_static`` directory of the output
       HTML, but only if the file does not already exist there.
 
+   .. versionchanged:: 4.0
+      Also accepts the URL for the favicon.
+
 .. confval:: html_css_files
 
    A list of CSS files.  The entry must be a *filename* string or a tuple

From 9d975b65bd7e0b94940ae9aae8deb4aa2074b716 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 23 Jan 2021 20:50:21 +0900
Subject: [PATCH 106/305] Update CHANGES for PR #8510

---
 CHANGES | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGES b/CHANGES
index 8f1cb8375dc..16ef7a6e9a6 100644
--- a/CHANGES
+++ b/CHANGES
@@ -52,6 +52,8 @@ Features added
   the location where the object is defined
 * #7784: i18n: The alt text for image is translated by default (without
   :confval:`gettext_additional_targets` setting)
+* #2018: html: :confval:`html_favicon` and :confval:`html_logo` now accept URL
+  for the image
 * #8070: html search: Support searching for 2characters word
 * #7830: Add debug logs for change detection of sources and templates
 * #8201: Emit a warning if toctree contains duplicated entries

From c50ce99c9d8a68eac9db9ec1501efe3f9d79b95e Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 23 Jan 2021 20:51:02 +0900
Subject: [PATCH 107/305] refactor: Remove unused method

---
 sphinx/builders/html/__init__.py | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 8c2e169ae6b..ccdd4c4e911 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -960,17 +960,6 @@ def has_wildcard(pattern: str) -> bool:
         ctx['sidebars'] = sidebars
         ctx['customsidebar'] = customsidebar
 
-    def proc_resource_ref(self, uri: str) -> str:
-        """Parse uri of a resource file and return its reference. If its a local file,
-        return the name of the file.
-        """
-        ref = ''
-        if isurl(uri):
-            ref = uri
-        elif uri:
-            ref = path.join('_static', path.basename(uri))
-        return ref
-
     # --------- these are overwritten by the serialization builder
 
     def get_target_uri(self, docname: str, typ: str = None) -> str:

From 90ced6c4b7ce05a41557c178938e94fab7129c99 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 24 Jan 2021 14:34:29 +0900
Subject: [PATCH 108/305] Fix #6550: Emit a deprecation warning for
 html_add_permalinks

Let's start to emit a deprecation warning for html_add_permalinks since
the major release v4.0.
---
 sphinx/builders/html/__init__.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 332c7c9898e..83186bfa45f 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1210,6 +1210,9 @@ def validate_html_favicon(app: Sphinx, config: Config) -> None:
 def migrate_html_add_permalinks(app: Sphinx, config: Config) -> None:
     """Migrate html_add_permalinks to html_permalinks*."""
     if config.html_add_permalinks:
+        # RemovedInSphinx60Warning
+        logger.warning(__('html_add_permalinks has been deprecated since v3.5.0. '
+                          'Please use html_permalinks and html_permalinks_icon instead.'))
         if (isinstance(config.html_add_permalinks, bool) and
                 config.html_add_permalinks is False):
             config.html_permalinks = False  # type: ignore

From 03629b1832bad58cf2ec0d48ba577f77ea7b2c23 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 24 Jan 2021 15:36:52 +0900
Subject: [PATCH 109/305] Fix #8737: html: broken img tag is appeared when
 html_logo not set

---
 sphinx/builders/html/__init__.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 6d5f24638d8..f57a05ee778 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1162,14 +1162,14 @@ def setup_resource_paths(app: Sphinx, pagename: str, templatename: str,
 
     # favicon_url
     favicon = context.get('favicon')
-    if not isurl(favicon):
+    if favicon and not isurl(favicon):
         context['favicon_url'] = pathto('_static/' + favicon, resource=True)
     else:
         context['favicon_url'] = favicon
 
     # logo_url
     logo = context.get('logo')
-    if not isurl(logo):
+    if logo and not isurl(logo):
         context['logo_url'] = pathto('_static/' + logo, resource=True)
     else:
         context['logo_url'] = logo

From a786f73d7f679fcbe758f76c05e71fcf846bf281 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Sun, 24 Jan 2021 23:26:06 +0100
Subject: [PATCH 110/305] LaTeX: sync pdftex engine default imageresolution
 with pxunit

Closes: #8253

The 'pxunit' key from latex_elements instructs how to handle image
dimensions specified in px units.

But pdftex has \pdfimageresolution which is used when an image file does
not provide readable or legit values for the x and/or y resolution.

This commit syncs them: from 'pxunit' the default image resolution in
pixels per inch (an integer) is computed.

This way an image will behave the same if:

- it is loaded with no explicit size set, _and_ no readable image
  resolution data is readable from the file (or that data matches the
  'pxunit' setting)

- or a size is set in figure directive using px units and equal to the
  natural pixel size of the image,

This also with 'lualatex' but is ignored by with 'xelatex' and
'uplatex'.
---
 CHANGES                            | 2 ++
 sphinx/templates/latex/latex.tex_t | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/CHANGES b/CHANGES
index 79226b31000..3a7ebf4294e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -68,6 +68,8 @@ Bugs fixed
   ``:unknown:doc:``)
 * #8711: LaTeX: backticks in code-blocks trigger latexpdf build warning (and font
   change) with late TeXLive 2019
+* #8253: LaTeX: Figures with no size defined get overscaled (compared to images
+  with size explicitly set in pixels) (fixed for ``'pdflatex'/'lualatex'`` only)
 
 Testing
 --------
diff --git a/sphinx/templates/latex/latex.tex_t b/sphinx/templates/latex/latex.tex_t
index 88efab8f0a2..9bfb3c3ff71 100644
--- a/sphinx/templates/latex/latex.tex_t
+++ b/sphinx/templates/latex/latex.tex_t
@@ -13,6 +13,9 @@
 \ifdefined\pdfpxdimen
    \let\sphinxpxdimen\pdfpxdimen\else\newdimen\sphinxpxdimen
 \fi \sphinxpxdimen=<%= pxunit %>\relax
+\ifdefined\pdfimageresolution
+    \pdfimageresolution= \numexpr \dimexpr1in\relax/\sphinxpxdimen\relax
+\fi
 <% if use_xindy -%>
 %% turn off hyperref patch of \index as sphinx.xdy xindy module takes care of
 %% suitable \hyperpage mark-up, working around hyperref-xindy incompatibility

From 84dc65ad51ee91e1073ff9b99b207753843f387c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 11 Jul 2020 22:30:37 +0900
Subject: [PATCH 111/305] html: html_codeblock_linenos_style defaults to
 'inline' (refs: #7849)

As discussed in #7879, the default style of line numbers for code
blocks in HTML output becames 'inline' by default.  And 'table' style
is now deprecated and will be removed in Sphinx-6.0.
---
 CHANGES                          |  3 +
 doc/usage/configuration.rst      |  9 ++-
 sphinx/builders/html/__init__.py |  2 +-
 tests/test_directive_code.py     | 94 +++++++-------------------------
 4 files changed, 30 insertions(+), 78 deletions(-)

diff --git a/CHANGES b/CHANGES
index 3a7ebf4294e..c3be86a31bc 100644
--- a/CHANGES
+++ b/CHANGES
@@ -23,6 +23,8 @@ Incompatible changes
   section
 * #7996: manpage: Make a section directory on build manpage by default (see
   :confval:`man_make_section_directory`)
+* #7849: html: Change the default setting of
+  :confval:`html_codeblock_linenos_style` to ``'inline'``
 * #8380: html search: search results are wrapped with ``<p>`` instead of
   ``<div>``
 * html theme: Move a script tag for documentation_options.js in
@@ -38,6 +40,7 @@ Incompatible changes
 Deprecated
 ----------
 
+* :confval:`html_codeblock_linenos_style`
 * ``favicon`` and ``logo`` variable in HTML templates
 * ``sphinx.directives.patches.CSVTable``
 * ``sphinx.directives.patches.ListTable``
diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index cc12e1eb148..0283fcb7c2f 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -971,10 +971,15 @@ that use Sphinx's HTMLWriter class.
 
    The style of line numbers for code-blocks.
 
-   * ``'table'`` -- display line numbers using ``<table>`` tag (default)
-   * ``'inline'`` -- display line numbers using ``<span>`` tag
+   * ``'table'`` -- display line numbers using ``<table>`` tag
+   * ``'inline'`` -- display line numbers using ``<span>`` tag (default)
 
    .. versionadded:: 3.2
+   .. versionchanged:: 4.0
+
+      It defaults to ``'inline'``.
+
+   .. deprecated:: 4.0
 
 .. confval:: html_context
 
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 9e790bc4899..105d90235db 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1296,7 +1296,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_config_value('html_search_scorer', '', None)
     app.add_config_value('html_scaled_image_link', True, 'html')
     app.add_config_value('html_baseurl', '', 'html')
-    app.add_config_value('html_codeblock_linenos_style', 'table', 'html',
+    app.add_config_value('html_codeblock_linenos_style', 'inline', 'html',  # RemovedInSphinx60Warning  # NOQA
                          ENUM('table', 'inline'))
     app.add_config_value('html_math_renderer', None, 'env')
     app.add_config_value('html4_writer', False, 'html')
diff --git a/tests/test_directive_code.py b/tests/test_directive_code.py
index 0ae11baf328..a011a31e8ff 100644
--- a/tests/test_directive_code.py
+++ b/tests/test_directive_code.py
@@ -423,44 +423,16 @@ def test_literal_include_linenos(app, status, warning):
     html = (app.outdir / 'linenos.html').read_text()
 
     # :linenos:
-    assert ('<td class="linenos"><div class="linenodiv"><pre>'
-            ' 1\n'
-            ' 2\n'
-            ' 3\n'
-            ' 4\n'
-            ' 5\n'
-            ' 6\n'
-            ' 7\n'
-            ' 8\n'
-            ' 9\n'
-            '10\n'
-            '11\n'
-            '12\n'
-            '13</pre></div></td>' in html)
+    assert ('<span class="linenos"> 1</span><span class="c1">'
+            '# Literally included file using Python highlighting</span>' in html)
 
     # :lineno-start:
-    assert ('<td class="linenos"><div class="linenodiv"><pre>'
-            '200\n'
-            '201\n'
-            '202\n'
-            '203\n'
-            '204\n'
-            '205\n'
-            '206\n'
-            '207\n'
-            '208\n'
-            '209\n'
-            '210\n'
-            '211\n'
-            '212</pre></div></td>' in html)
-
-    # :lineno-match:
-    assert ('<td class="linenos"><div class="linenodiv"><pre>'
-            '5\n'
-            '6\n'
-            '7\n'
-            '8\n'
-            '9</pre></div></td>' in html)
+    assert ('<span class="linenos">200</span><span class="c1">'
+            '# Literally included file using Python highlighting</span>' in html)
+
+    # :lines: 5-9
+    assert ('<span class="linenos">5</span><span class="k">class</span> '
+            '<span class="nc">Foo</span><span class="p">:</span>' in html)
 
 
 @pytest.mark.sphinx('latex', testroot='directive-code')
@@ -594,45 +566,17 @@ def test_linenothreshold(app, status, warning):
     app.builder.build(['linenothreshold'])
     html = (app.outdir / 'linenothreshold.html').read_text()
 
-    lineos_head = '<td class="linenos"><div class="linenodiv"><pre>'
-    lineos_tail = '</pre></div></td>'
-
     # code-block using linenothreshold
-    _, matched, html = html.partition(lineos_head +
-                                      '1\n'
-                                      '2\n'
-                                      '3\n'
-                                      '4\n'
-                                      '5\n'
-                                      '6' + lineos_tail)
-    assert matched
-
-    # code-block not using linenothreshold
-    html, matched, _ = html.partition(lineos_head +
-                                      '1\n'
-                                      '2' + lineos_tail)
-    assert not matched
+    assert ('<span class="linenos">1</span><span class="k">class</span> '
+            '<span class="nc">Foo</span><span class="p">:</span>' in html)
+
+    # code-block not using linenothreshold (no line numbers)
+    assert '<span></span><span class="c1"># comment</span>' in html
 
     # literal include using linenothreshold
-    _, matched, html = html.partition(lineos_head +
-                                      ' 1\n'
-                                      ' 2\n'
-                                      ' 3\n'
-                                      ' 4\n'
-                                      ' 5\n'
-                                      ' 6\n'
-                                      ' 7\n'
-                                      ' 8\n'
-                                      ' 9\n'
-                                      '10\n'
-                                      '11\n'
-                                      '12\n'
-                                      '13' + lineos_tail)
-    assert matched
-
-    # literal include not using linenothreshold
-    html, matched, _ = html.partition(lineos_head +
-                                      '1\n'
-                                      '2\n'
-                                      '3' + lineos_tail)
-    assert not matched
+    assert ('<span class="linenos"> 1</span><span class="c1">'
+            '# Literally included file using Python highlighting</span>' in html)
+
+    # literal include not using linenothreshold (no line numbers)
+    assert ('<span></span><span class="c1"># Very small literal include '
+            '(linenothreshold check)</span>' in html)

From 6e80d27841bbd9f9eda1f655e4f7d9e3c93b8ec0 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 27 Jan 2021 14:08:28 +0100
Subject: [PATCH 112/305] Refactor LaTeX [1/2]: split sphinx.sty into separate
 components

The latex macros from sphinx.sty were already partitioned into
successive sections.  The file sphinx.sty is split into multiple
files in concordance with this pre-existing sectioning.

The files are loaded via \input. File extension is .sty not .tex
to not confuse the Makefile.
---
 doc/latex.rst                                 |   33 +-
 sphinx/texinputs/sphinx.sty                   | 1863 +----------------
 .../texinputs/sphinxlatexenvadmonitions.sty   |  122 ++
 sphinx/texinputs/sphinxlatexenvdocs.sty       |  164 ++
 sphinx/texinputs/sphinxlatexenvindbibtoc.sty  |   47 +
 sphinx/texinputs/sphinxlatexenvliteral.sty    |  480 +++++
 sphinx/texinputs/sphinxlatexenvshadowbox.sty  |   86 +
 sphinx/texinputs/sphinxlatexgraphics.sty      |  112 +
 sphinx/texinputs/sphinxlatexmiscfixme.sty     |   18 +
 sphinx/texinputs/sphinxlatexmisclists.sty     |   92 +
 sphinx/texinputs/sphinxlatexmiscnumbering.sty |  115 +
 .../texinputs/sphinxlatexoptionhandling.sty   |  134 ++
 .../texinputs/sphinxlatexrequirepackages.sty  |  239 +++
 sphinx/texinputs/sphinxlatexstyleheadings.sty |   50 +
 sphinx/texinputs/sphinxlatexstylepage.sty     |  120 ++
 sphinx/texinputs/sphinxlatexstyletext.sty     |  166 ++
 16 files changed, 1996 insertions(+), 1845 deletions(-)
 create mode 100644 sphinx/texinputs/sphinxlatexenvadmonitions.sty
 create mode 100644 sphinx/texinputs/sphinxlatexenvdocs.sty
 create mode 100644 sphinx/texinputs/sphinxlatexenvindbibtoc.sty
 create mode 100644 sphinx/texinputs/sphinxlatexenvliteral.sty
 create mode 100644 sphinx/texinputs/sphinxlatexenvshadowbox.sty
 create mode 100644 sphinx/texinputs/sphinxlatexgraphics.sty
 create mode 100644 sphinx/texinputs/sphinxlatexmiscfixme.sty
 create mode 100644 sphinx/texinputs/sphinxlatexmisclists.sty
 create mode 100644 sphinx/texinputs/sphinxlatexmiscnumbering.sty
 create mode 100644 sphinx/texinputs/sphinxlatexoptionhandling.sty
 create mode 100644 sphinx/texinputs/sphinxlatexrequirepackages.sty
 create mode 100644 sphinx/texinputs/sphinxlatexstyleheadings.sty
 create mode 100644 sphinx/texinputs/sphinxlatexstylepage.sty
 create mode 100644 sphinx/texinputs/sphinxlatexstyletext.sty

diff --git a/doc/latex.rst b/doc/latex.rst
index d18dad65ad6..f3a99932f79 100644
--- a/doc/latex.rst
+++ b/doc/latex.rst
@@ -830,9 +830,36 @@ macros may be significant.
 LaTeX macros and environments
 -----------------------------
 
-Here are some macros from the package file :file:`sphinx.sty` and class files
-:file:`sphinxhowto.cls`, :file:`sphinxmanual.cls`, which have public names
-thus allowing redefinitions. Check the respective files for the defaults.
+The "LaTeX package" file :file:`sphinx.sty` loads various components
+providing support macros (aka commands), and environments, which are used in
+the mark-up produced on output from the ``latex`` builder, before conversion
+to ``pdf`` via the LaTeX toolchain.  Also the "LaTeX class" files
+:file:`sphinxhowto.cls` and :file:`sphinxmanual.cls` define or customize some
+environments.  All of these files can be found in the latex build repertory.
+
+Some of these provide facilities not available from pre-existing LaTeX
+packages and work around LaTeX limitations with lists, table cells, verbatim
+rendering, footnotes, etc...
+
+Others simply define macros with public names to make overwriting their
+defaults easy via user-added contents to the preamble.  We will survey most of
+those public names here, but defaults have to be looked at in their respective
+definition files.
+
+.. hint::
+
+   Sphinx LaTeX support code is split across multiple smaller-sized files.
+   Rather than adding code to the preamble via
+   `latex_elements <latex_elements_confval_>`_\ [``'preamble'``] it is
+   also possible to replace entirely one of the component files of Sphinx
+   LaTeX code with a custom version, simply by including a modified copy in
+   the project source and adding the filename to the
+   :confval:`latex_additional_files` list.  Check the LaTeX build repertory
+   for the filenames and contents.
+
+.. versionchanged:: 4.0.0
+   split of :file:`sphinx.sty` into multiple smaller units, to facilitate
+   customization of many aspects simultaneously.
 
 .. _latex-macros:
 
diff --git a/sphinx/texinputs/sphinx.sty b/sphinx/texinputs/sphinx.sty
index 343924753d8..00722a52afe 100644
--- a/sphinx/texinputs/sphinx.sty
+++ b/sphinx/texinputs/sphinx.sty
@@ -6,7 +6,7 @@
 %
 
 \NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{sphinx}[2021/01/23 v3.5.0 LaTeX package (Sphinx markup)]
+\ProvidesPackage{sphinx}[2021/01/27 v4.0.0 LaTeX package (Sphinx markup)]
 
 % provides \ltx@ifundefined
 % (many packages load ltxcmds: graphicx does for pdftex and lualatex but
@@ -35,239 +35,10 @@
 %
 % we delay handling of options to after having loaded packages, because
 % of the need to use \definecolor.
-\RequirePackage{graphicx}
-\@ifclassloaded{memoir}{}{\RequirePackage{fancyhdr}}
-% for \text macro and \iffirstchoice@ conditional even if amsmath not loaded
-\RequirePackage{amstext}
-\RequirePackage{textcomp}% "warn" option issued from template
-\RequirePackage[nobottomtitles*]{titlesec}
-\@ifpackagelater{titlesec}{2016/03/15}%
- {\@ifpackagelater{titlesec}{2016/03/21}%
-  {}%
-  {\newif\ifsphinx@ttlpatch@ok
-   \IfFileExists{etoolbox.sty}{%
-     \RequirePackage{etoolbox}%
-     \patchcmd{\ttlh@hang}{\parindent\z@}{\parindent\z@\leavevmode}%
-                                {\sphinx@ttlpatch@oktrue}{}%
-     \ifsphinx@ttlpatch@ok
-     \patchcmd{\ttlh@hang}{\noindent}{}{}{\sphinx@ttlpatch@okfalse}%
-     \fi
-   }{}%
-   \ifsphinx@ttlpatch@ok
-     \typeout{^^J Package Sphinx Info: ^^J
-              **** titlesec 2.10.1 successfully patched for bugfix ****^^J}%
-   \else
-     \AtEndDocument{\PackageWarningNoLine{sphinx}{^^J%
-******** titlesec 2.10.1 has a bug, (section numbers disappear) ......|^^J%
-******** and Sphinx could not patch it, perhaps because your local ...|^^J%
-******** copy is already fixed without a changed release date. .......|^^J%
-******** If not, you must update titlesec! ...........................|}}%
-   \fi
-  }%
- }{}
-\RequirePackage{tabulary}
-% tabulary has a bug with its re-definition of \multicolumn in its first pass
-% which is not \long. But now Sphinx does not use LaTeX's \multicolumn but its
-% own macro. Hence we don't even need to patch tabulary. See sphinxmulticell.sty
-% X or S (Sphinx) may have meanings if some table package is loaded hence
-% \X was chosen to avoid possibility of conflict
-\newcolumntype{\X}[2]{p{\dimexpr
-      (\linewidth-\arrayrulewidth)*#1/#2-\tw@\tabcolsep-\arrayrulewidth\relax}}
-\newcolumntype{\Y}[1]{p{\dimexpr
-      #1\dimexpr\linewidth-\arrayrulewidth\relax-\tw@\tabcolsep-\arrayrulewidth\relax}}
-% using here T (for Tabulary) feels less of a problem than the X could be
-\newcolumntype{T}{J}%
-% For tables allowing pagebreaks
-\RequirePackage{longtable}
-% User interface to set-up whitespace before and after tables:
-\newcommand*\sphinxtablepre {0pt}%
-\newcommand*\sphinxtablepost{\medskipamount}%
-% Space from caption baseline to top of table or frame of literal-block
-\newcommand*\sphinxbelowcaptionspace{.5\sphinxbaselineskip}%
-% as one can not use \baselineskip from inside longtable (it is zero there)
-% we need \sphinxbaselineskip, which defaults to \baselineskip
-\def\sphinxbaselineskip{\baselineskip}%
-% The following is to ensure that, whether tabular(y) or longtable:
-% - if a caption is on top of table:
-%   a) the space between its last baseline and the top rule of table is
-%      exactly \sphinxbelowcaptionspace
-%   b) the space from last baseline of previous text to first baseline of
-%      caption is exactly \parskip+\baselineskip+ height of a strut.
-%   c) the caption text will wrap at width \LTcapwidth (4in)
-% - make sure this works also if "caption" package is loaded by user
-%   (with its width or margin option taking place of \LTcapwidth role)
-% TODO: obtain same for caption of literal block: a) & c) DONE, b) TO BE DONE
-%
-% To modify space below such top caption, adjust \sphinxbelowcaptionspace
-% To add or remove space above such top caption, adjust \sphinxtablepre:
-%   notice that \abovecaptionskip, \belowcaptionskip, \LTpre are **ignored**
-% A. Table with longtable
-\def\sphinxatlongtablestart
-   {\par
-    \vskip\parskip
-    \vskip\dimexpr\sphinxtablepre\relax % adjust vertical position
-    \vbox{}% get correct baseline from above
-    \LTpre\z@skip\LTpost\z@skip % set to zero longtable's own skips
-    \edef\sphinxbaselineskip{\dimexpr\the\dimexpr\baselineskip\relax\relax}%
-   }%
-% Compatibility with caption package
-\def\sphinxthelongtablecaptionisattop{%
-    \spx@ifcaptionpackage{\noalign{\vskip-\belowcaptionskip}}{}%
-}%
-% Achieves exactly \sphinxbelowcaptionspace below longtable caption
-\def\sphinxlongtablecapskipadjust
-   {\dimexpr-\dp\strutbox
-            -\spx@ifcaptionpackage{\abovecaptionskip}{\sphinxbaselineskip}%
-            +\sphinxbelowcaptionspace\relax}%
-\def\sphinxatlongtableend{\@nobreakfalse % latex3/latex2e#173
-    \prevdepth\z@\vskip\sphinxtablepost\relax}%
-% B. Table with tabular or tabulary
-\def\sphinxattablestart{\par\vskip\dimexpr\sphinxtablepre\relax}%
-\let\sphinxattableend\sphinxatlongtableend
-% This is used by tabular and tabulary templates
-\newcommand*\sphinxcapstartof[1]{%
-   \vskip\parskip
-   \vbox{}% force baselineskip for good positioning by capstart of hyperanchor
-   % hyperref puts the anchor 6pt above this baseline; in case of caption
-   % this baseline will be \ht\strutbox above first baseline of caption
-   \def\@captype{#1}%
-   \capstart
-% move back vertically, as tabular (or its caption) will compensate
-   \vskip-\baselineskip\vskip-\parskip
-}%
-\def\sphinxthecaptionisattop{% locate it after \sphinxcapstartof
-    \spx@ifcaptionpackage
-      {\caption@setposition{t}%
-       \vskip\baselineskip\vskip\parskip % undo those from \sphinxcapstartof
-       \vskip-\belowcaptionskip          % anticipate caption package skip
-       % caption package uses a \vbox, not a \vtop, so "single line" case
-       % gives different result from "multi-line" without this:
-       \nointerlineskip
-      }%
-      {}%
-}%
-\def\sphinxthecaptionisatbottom{% (not finalized; for template usage)
-    \spx@ifcaptionpackage{\caption@setposition{b}}{}%
-}%
-% The aim of \sphinxcaption is to apply to tabular(y) the maximal width
-% of caption as done by longtable
-\def\sphinxtablecapwidth{\LTcapwidth}%
-\newcommand\sphinxcaption{\@dblarg\spx@caption}%
-\long\def\spx@caption[#1]#2{%
-   \noindent\hb@xt@\linewidth{\hss
-      \vtop{\@tempdima\dimexpr\sphinxtablecapwidth\relax
-% don't exceed linewidth for the caption width
-            \ifdim\@tempdima>\linewidth\hsize\linewidth\else\hsize\@tempdima\fi
-% longtable ignores \abovecaptionskip/\belowcaptionskip, so do the same here
-            \abovecaptionskip\sphinxabovecaptionskip % \z@skip
-            \belowcaptionskip\sphinxbelowcaptionskip % \z@skip
-            \caption[{#1}]%
-               {\strut\ignorespaces#2\ifhmode\unskip\@finalstrut\strutbox\fi}%
-           }\hss}%
-   \par\prevdepth\dp\strutbox
-}%
-\def\sphinxabovecaptionskip{\z@skip}% Do not use! Flagged for removal
-\def\sphinxbelowcaptionskip{\z@skip}% Do not use! Flagged for removal
-% This wrapper of \abovecaptionskip is used in sphinxVerbatim for top
-% caption, and with another value in sphinxVerbatimintable
-% TODO: To unify space above caption of a code-block with the one above
-%       caption of a table/longtable, \abovecaptionskip must not be used
-%       This auxiliary will get renamed and receive a different meaning
-%       in future.
-\def\spx@abovecaptionskip{\abovecaptionskip}%
-% Achieve \sphinxbelowcaptionspace below a caption located above a tabular
-% or a tabulary
-\newcommand\sphinxaftertopcaption
-{%
-   \spx@ifcaptionpackage
-     {\par\prevdepth\dp\strutbox\nobreak\vskip-\abovecaptionskip}{\nobreak}%
-   \vskip\dimexpr\sphinxbelowcaptionspace\relax
-   \vskip-\baselineskip\vskip-\parskip
-}%
-% varwidth is crucial for our handling of general contents in merged cells
-\RequirePackage{varwidth}
-% but addition of a compatibility patch with hyperref is needed
-% (tested with varwidth v 0.92  Mar 2009)
-\AtBeginDocument {%
-    \let\@@vwid@Hy@raisedlink\Hy@raisedlink
-    \long\def\@vwid@Hy@raisedlink#1{\@vwid@wrap{\@@vwid@Hy@raisedlink{#1}}}%
-    \edef\@vwid@setup{%
-      \let\noexpand\Hy@raisedlink\noexpand\@vwid@Hy@raisedlink % HYPERREF !
-      \unexpanded\expandafter{\@vwid@setup}}%
-}%
-% Homemade package to handle merged cells
-\RequirePackage{sphinxmulticell}
-\RequirePackage{makeidx}
-% For framing code-blocks and warning type notices, and shadowing topics
-\RequirePackage{framed}
-% The xcolor package draws better fcolorboxes around verbatim code
-\IfFileExists{xcolor.sty}{
-    \RequirePackage{xcolor}
-}{
-    \RequirePackage{color}
-}
-% For highlighted code.
-\RequirePackage{fancyvrb}
-\define@key{FV}{hllines}{\def\sphinx@verbatim@checkifhl##1{\in@{, ##1,}{#1}}}
-% sphinxVerbatim must be usable by third party without requiring hllines set-up
-\def\sphinxresetverbatimhllines{\def\sphinx@verbatim@checkifhl##1{\in@false}}
-\sphinxresetverbatimhllines
-% For hyperlinked footnotes in tables; also for gathering footnotes from
-% topic and warning blocks. Also to allow code-blocks in footnotes.
-\RequirePackage{footnotehyper-sphinx}
-% For the H specifier. Do not \restylefloat{figure}, it breaks Sphinx code
-% for allowing figures in tables.
-\RequirePackage{float}
-% For floating figures in the text. Better to load after float.
-\RequirePackage{wrapfig}
-% Separate paragraphs by space by default.
-\IfFileExists{parskip-2001-04-09.sty}% since September 2018 TeXLive update
-% new parskip.sty, but let it rollback to old one.
-% hopefully TeX installation not broken and LaTeX kernel not too old
-   {\RequirePackage{parskip}[=v1]}
-% standard one from 1989. Admittedly \section of article/book gives possibly
-% anomalous spacing, but we can't require September 2018 release for some time.
-   {\RequirePackage{parskip}}
-% For parsed-literal blocks.
-\RequirePackage{alltt}
-% Display "real" single quotes in literal blocks.
-\RequirePackage{upquote}
-% control caption around literal-block
-\RequirePackage{capt-of}
-\RequirePackage{needspace}
-% LaTeX 2018-04-01 and later provides \@removefromreset
-\ltx@ifundefined{@removefromreset}
-    {\RequirePackage{remreset}}
-    {}% avoid warning
-% to make pdf with correct encoded bookmarks in Japanese
-% this should precede the hyperref package
-\ifx\kanjiskip\@undefined
-% for non-Japanese: make sure bookmarks are ok also with lualatex
-  \PassOptionsToPackage{pdfencoding=unicode}{hyperref}
-\else
-  \RequirePackage{atbegshi}
-  \ifx\ucs\@undefined
-    \ifnum 42146=\euc"A4A2
-      \AtBeginShipoutFirst{\special{pdf:tounicode EUC-UCS2}}
-    \else
-      \AtBeginShipoutFirst{\special{pdf:tounicode 90ms-RKSJ-UCS2}}
-    \fi
-  \else
-    \AtBeginShipoutFirst{\special{pdf:tounicode UTF8-UCS2}}
-  \fi
-\fi
-
-\ifx\@jsc@uplatextrue\@undefined\else
-  \PassOptionsToPackage{setpagesize=false}{hyperref}
-\fi
+\input{sphinxlatexrequirepackages.sty}
 
-% These options can be overriden inside  'hyperref' key
-% or by later use of \hypersetup.
-\PassOptionsToPackage{colorlinks,breaklinks,%
- linkcolor=InnerLinkColor,filecolor=OuterLinkColor,%
- menucolor=OuterLinkColor,urlcolor=OuterLinkColor,%
- citecolor=InnerLinkColor}{hyperref}
 
+%% PYGMENTS
 % stylesheet for highlighting with pygments
 \RequirePackage{sphinxhighlight}
 % fix baseline increase from Pygments latex formatter in case of error tokens
@@ -283,558 +54,46 @@
 }%
 
 
-%% OPTIONS
+%% OPTION HANDLING
 %
-% Handle options via "kvoptions" (later loaded by hyperref anyhow)
-\RequirePackage{kvoptions}
-\SetupKeyvalOptions{prefix=spx@opt@} % use \spx@opt@ prefix
-
-% Sphinx legacy text layout: 1in margins on all four sides
-\ifx\@jsc@uplatextrue\@undefined
-\DeclareStringOption[1in]{hmargin}
-\DeclareStringOption[1in]{vmargin}
-\DeclareStringOption[.5in]{marginpar}
-\else
-% Japanese standard document classes handle \mag in a special way
-\DeclareStringOption[\inv@mag in]{hmargin}
-\DeclareStringOption[\inv@mag in]{vmargin}
-\DeclareStringOption[.5\dimexpr\inv@mag in\relax]{marginpar}
-\fi
-
-\DeclareStringOption[0]{maxlistdepth}% \newcommand*\spx@opt@maxlistdepth{0}
-\DeclareStringOption[-1]{numfigreset}
-\DeclareBoolOption[false]{nonumfigreset}
-\DeclareBoolOption[false]{mathnumfig}
-% \DeclareBoolOption[false]{usespart}% not used
-% dimensions, we declare the \dimen registers here.
-\newdimen\sphinxverbatimsep
-\newdimen\sphinxverbatimborder
-\newdimen\sphinxshadowsep
-\newdimen\sphinxshadowsize
-\newdimen\sphinxshadowrule
-% \DeclareStringOption is not convenient for the handling of these dimensions
-% because we want to assign the values to the corresponding registers. Even if
-% we added the code to the key handler it would be too late for the initial
-% set-up and we would need to do initial assignments explicitely. We end up
-% using \define@key directly.
-% verbatim
-\sphinxverbatimsep=\fboxsep
-  \define@key{sphinx}{verbatimsep}{\sphinxverbatimsep\dimexpr #1\relax}
-\sphinxverbatimborder=\fboxrule
-  \define@key{sphinx}{verbatimborder}{\sphinxverbatimborder\dimexpr #1\relax}
-% topic boxes
-\sphinxshadowsep =5pt
-  \define@key{sphinx}{shadowsep}{\sphinxshadowsep\dimexpr #1\relax}
-\sphinxshadowsize=4pt
-  \define@key{sphinx}{shadowsize}{\sphinxshadowsize\dimexpr #1\relax}
-\sphinxshadowrule=\fboxrule
-  \define@key{sphinx}{shadowrule}{\sphinxshadowrule\dimexpr #1\relax}
-% verbatim
-\DeclareBoolOption[true]{verbatimwithframe}
-\DeclareBoolOption[true]{verbatimwrapslines}
-\DeclareBoolOption[true]{verbatimhintsturnover}
-\DeclareBoolOption[true]{inlineliteralwraps}
-\DeclareStringOption[t]{literalblockcappos}
-\DeclareStringOption[r]{verbatimcontinuedalign}
-\DeclareStringOption[r]{verbatimcontinuesalign}
-% parsed literal
-\DeclareBoolOption[true]{parsedliteralwraps}
-% \textvisiblespace for compatibility with fontspec+XeTeX/LuaTeX
-\DeclareStringOption[\textcolor{red}{\textvisiblespace}]{verbatimvisiblespace}
-\DeclareStringOption % must use braces to hide the brackets
-  [{\makebox[2\fontcharwd\font`\x][r]{\textcolor{red}{\tiny$\m@th\hookrightarrow$}}}]%
-  {verbatimcontinued}
-% notices/admonitions
-% the dimensions for notices/admonitions are kept as macros and assigned to
-% \spx@notice@border at time of use, hence \DeclareStringOption is ok for this
-\newdimen\spx@notice@border
-\DeclareStringOption[0.5pt]{noteborder}
-\DeclareStringOption[0.5pt]{hintborder}
-\DeclareStringOption[0.5pt]{importantborder}
-\DeclareStringOption[0.5pt]{tipborder}
-\DeclareStringOption[1pt]{warningborder}
-\DeclareStringOption[1pt]{cautionborder}
-\DeclareStringOption[1pt]{attentionborder}
-\DeclareStringOption[1pt]{dangerborder}
-\DeclareStringOption[1pt]{errorborder}
-% footnotes
-\DeclareStringOption[\mbox{ }]{AtStartFootnote}
-% we need a public macro name for direct use in latex file
-\newcommand*{\sphinxAtStartFootnote}{\spx@opt@AtStartFootnote}
-% no such need for this one, as it is used inside other macros
-\DeclareStringOption[\leavevmode\unskip]{BeforeFootnote}
-% some font styling.
-\DeclareStringOption[\sffamily\bfseries]{HeaderFamily}
-% colours
-% same problems as for dimensions: we want the key handler to use \definecolor.
-% first, some colours with no prefix, for backwards compatibility
-\newcommand*{\sphinxDeclareColorOption}[2]{%
-   \definecolor{#1}#2%
-   \define@key{sphinx}{#1}{\definecolor{#1}##1}%
-}%
-\sphinxDeclareColorOption{TitleColor}{{rgb}{0.126,0.263,0.361}}
-\sphinxDeclareColorOption{InnerLinkColor}{{rgb}{0.208,0.374,0.486}}
-\sphinxDeclareColorOption{OuterLinkColor}{{rgb}{0.216,0.439,0.388}}
-\sphinxDeclareColorOption{VerbatimColor}{{rgb}{1,1,1}}
-\sphinxDeclareColorOption{VerbatimBorderColor}{{rgb}{0,0,0}}
-% now the colours defined with "sphinx" prefix in their names
-\newcommand*{\sphinxDeclareSphinxColorOption}[2]{%
-   % set the initial default
-   \definecolor{sphinx#1}#2%
-   % set the key handler. The "value" ##1 must be acceptable by \definecolor.
-   \define@key{sphinx}{#1}{\definecolor{sphinx#1}##1}%
-}%
-% Default color chosen to be as in minted.sty LaTeX package!
-\sphinxDeclareSphinxColorOption{VerbatimHighlightColor}{{rgb}{0.878,1,1}}
-% admonition boxes, "light" style
-\sphinxDeclareSphinxColorOption{noteBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{hintBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{importantBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{tipBorderColor}{{rgb}{0,0,0}}
-% admonition boxes, "heavy" style
-\sphinxDeclareSphinxColorOption{warningBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{cautionBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{attentionBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{dangerBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{errorBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{warningBgColor}{{rgb}{1,1,1}}
-\sphinxDeclareSphinxColorOption{cautionBgColor}{{rgb}{1,1,1}}
-\sphinxDeclareSphinxColorOption{attentionBgColor}{{rgb}{1,1,1}}
-\sphinxDeclareSphinxColorOption{dangerBgColor}{{rgb}{1,1,1}}
-\sphinxDeclareSphinxColorOption{errorBgColor}{{rgb}{1,1,1}}
-
-\DeclareDefaultOption{\@unknownoptionerror}
-\ProcessKeyvalOptions*
-% don't allow use of maxlistdepth via \sphinxsetup.
-\DisableKeyvalOption{sphinx}{maxlistdepth}
-\DisableKeyvalOption{sphinx}{numfigreset}
-\DisableKeyvalOption{sphinx}{nonumfigreset}
-\DisableKeyvalOption{sphinx}{mathnumfig}
-% user interface: options can be changed midway in a document!
-\newcommand\sphinxsetup[1]{\setkeys{sphinx}{#1}}
+\input{sphinxlatexoptionhandling.sty}
 
 
-%% ALPHANUMERIC LIST ITEMS
-\newcommand\sphinxsetlistlabels[5]
-{% #1 = style, #2 = enum, #3 = enumnext, #4 = prefix, #5 = suffix
- % #2 and #3 are counters used by enumerate environement e.g. enumi, enumii.
- % #1 is a macro such as \arabic or \alph
- % prefix and suffix are strings (by default empty and a dot).
- \@namedef{the#2}{#1{#2}}%
- \@namedef{label#2}{#4\@nameuse{the#2}#5}%
- \@namedef{p@#3}{\@nameuse{p@#2}#4\@nameuse{the#2}#5}%
-}%
-
-
-%% MAXLISTDEPTH
+%% LISTS
 %
-% remove LaTeX's cap on nesting depth if 'maxlistdepth' key used.
-% This is a hack, which works with the standard classes: it assumes \@toodeep
-% is always used in "true" branches: "\if ... \@toodeep \else .. \fi."
-
-% will force use the "false" branch (if there is one)
-\def\spx@toodeep@hack{\fi\iffalse}
-
-% do nothing if 'maxlistdepth' key not used or if package enumitem loaded.
-\ifnum\spx@opt@maxlistdepth=\z@\expandafter\@gobbletwo\fi
-\AtBeginDocument{%
-\@ifpackageloaded{enumitem}{\remove@to@nnil}{}%
-  \let\spx@toodeepORI\@toodeep
-  \def\@toodeep{%
-    \ifnum\@listdepth<\spx@opt@maxlistdepth\relax
-      \expandafter\spx@toodeep@hack
-    \else
-      \expandafter\spx@toodeepORI
-    \fi}%
-% define all missing \@list... macros
-  \count@\@ne
-  \loop
-     \ltx@ifundefined{@list\romannumeral\the\count@}
-       {\iffalse}{\iftrue\advance\count@\@ne}%
-  \repeat
-  \loop
-     \ifnum\count@>\spx@opt@maxlistdepth\relax\else
-       \expandafter\let
-         \csname @list\romannumeral\the\count@\expandafter\endcsname
-         \csname @list\romannumeral\the\numexpr\count@-\@ne\endcsname
-       % workaround 2.6--3.2d babel-french issue (fixed in 3.2e; no change needed)
-       \ltx@ifundefined{leftmargin\romannumeral\the\count@}
-       {\expandafter\let
-         \csname leftmargin\romannumeral\the\count@\expandafter\endcsname
-         \csname leftmargin\romannumeral\the\numexpr\count@-\@ne\endcsname}{}%
-     \advance\count@\@ne
-  \repeat
-% define all missing enum... counters and \labelenum... macros and \p@enum..
-  \count@\@ne
-  \loop
-     \ltx@ifundefined{c@enum\romannumeral\the\count@}
-       {\iffalse}{\iftrue\advance\count@\@ne}%
-  \repeat
-  \loop
-     \ifnum\count@>\spx@opt@maxlistdepth\relax\else
-       \newcounter{enum\romannumeral\the\count@}%
-       \expandafter\def
-         \csname labelenum\romannumeral\the\count@\expandafter\endcsname
-         \expandafter
-         {\csname theenum\romannumeral\the\numexpr\count@\endcsname.}%
-       \expandafter\def
-         \csname p@enum\romannumeral\the\count@\expandafter\endcsname
-         \expandafter
-         {\csname p@enum\romannumeral\the\numexpr\count@-\@ne\expandafter
-          \endcsname\csname theenum\romannumeral\the\numexpr\count@-\@ne\endcsname.}%
-     \advance\count@\@ne
-  \repeat
-% define all missing labelitem... macros
-  \count@\@ne
-  \loop
-     \ltx@ifundefined{labelitem\romannumeral\the\count@}
-     {\iffalse}{\iftrue\advance\count@\@ne}%
-  \repeat
-  \loop
-     \ifnum\count@>\spx@opt@maxlistdepth\relax\else
-       \expandafter\let
-         \csname labelitem\romannumeral\the\count@\expandafter\endcsname
-         \csname labelitem\romannumeral\the\numexpr\count@-\@ne\endcsname
-     \advance\count@\@ne
-  \repeat
-  \PackageInfo{sphinx}{maximal list depth extended to \spx@opt@maxlistdepth}%
-\@gobble\@nnil
-}
+\input{sphinxlatexmisclists.sty}
 
 
 %% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS
 %
-% fix the double index and bibliography on the table of contents
-% in jsclasses (Japanese standard document classes)
-\ifx\@jsc@uplatextrue\@undefined\else
-  \renewenvironment{sphinxtheindex}
-    {\cleardoublepage\phantomsection
-     \begin{theindex}}
-    {\end{theindex}}
-
-  \renewenvironment{sphinxthebibliography}[1]
-    {\cleardoublepage% \phantomsection % not needed here since TeXLive 2010's hyperref
-     \begin{thebibliography}{#1}}
-    {\end{thebibliography}}
-\fi
+\input{sphinxlatexenvindbibtoc.sty}
 
-% disable \@chappos in Appendix in pTeX
-\ifx\kanjiskip\@undefined\else
-  \let\py@OldAppendix=\appendix
-  \renewcommand{\appendix}{
-    \py@OldAppendix
-    \gdef\@chappos{}
-  }
-\fi
 
-% make commands known to non-Sphinx document classes
-\providecommand*{\sphinxmaketitle}{\maketitle}
-\providecommand*{\sphinxtableofcontents}{\tableofcontents}
-\ltx@ifundefined{sphinxthebibliography}
- {\newenvironment
-  {sphinxthebibliography}{\begin{thebibliography}}{\end{thebibliography}}%
- }
- {}% else clause of \ltx@ifundefined
-\ltx@ifundefined{sphinxtheindex}
- {\newenvironment{sphinxtheindex}{\begin{theindex}}{\end{theindex}}}%
- {}% else clause of \ltx@ifundefined
-
-% for usage with xindy: this string gets internationalized in preamble
-\newcommand*{\sphinxnonalphabeticalgroupname}{}
-% redefined in preamble, headings for makeindex produced index
-\newcommand*{\sphinxsymbolsname}{}
-\newcommand*{\sphinxnumbersname}{}
-
-%% COLOR (general)
+%% FIXME STUFF
 %
-% FIXME: \normalcolor should probably be used in place of \py@NormalColor
-% elsewhere, and \py@NormalColor should never be defined. \normalcolor
-% switches to the colour from last \color call in preamble.
-\def\py@NormalColor{\color{black}}
-% FIXME: it is probably better to use \color{TitleColor}, as TitleColor
-% can be customized from 'sphinxsetup', and drop usage of \py@TitleColor
-\def\py@TitleColor{\color{TitleColor}}
-% FIXME: this line should be dropped, as "9" is default anyhow.
-\ifdefined\pdfcompresslevel\pdfcompresslevel = 9 \fi
+\input{sphinxlatexmiscfixme.sty}
 
 
 %% PAGE STYLING
 %
-% Style parameters and macros used by most documents here
-\raggedbottom
-\sloppy
-\hbadness = 5000                % don't print trivial gripes
-
-% Use \pagestyle{normal} as the primary pagestyle for text.
-% Redefine the 'normal' header/footer style when using "fancyhdr" package:
-\@ifpackageloaded{fancyhdr}{%
-  \ltx@ifundefined{c@chapter}
-  {% no \chapter, "howto" (non-Japanese) docclass
-   \fancypagestyle{plain}{
-    \fancyhf{}
-    \fancyfoot[C]{{\py@HeaderFamily\thepage}}
-    \renewcommand{\headrulewidth}{0pt}
-    \renewcommand{\footrulewidth}{0pt}
-   }
-   % Same as 'plain', this way we can use it in template
-   % FIXME: shouldn't this have a running header with Name and Release like 'manual'?
-   \fancypagestyle{normal}{
-    \fancyhf{}
-    \fancyfoot[C]{{\py@HeaderFamily\thepage}}
-    \renewcommand{\headrulewidth}{0pt}
-    \renewcommand{\footrulewidth}{0pt}
-   }
-  }%
-  {% classes with \chapter command
-   \fancypagestyle{normal}{
-    \fancyhf{}
-    \fancyfoot[RO]{{\py@HeaderFamily\thepage}}
-    \fancyfoot[LO]{{\py@HeaderFamily\nouppercase{\rightmark}}}
-    \fancyhead[RO]{{\py@HeaderFamily \@title\sphinxheadercomma\py@release}}
-    \if@twoside
-     \fancyfoot[LE]{{\py@HeaderFamily\thepage}}
-     \fancyfoot[RE]{{\py@HeaderFamily\nouppercase{\leftmark}}}
-     \fancyhead[LE]{{\py@HeaderFamily \@title\sphinxheadercomma\py@release}}
-    \fi
-    \renewcommand{\headrulewidth}{0.4pt}
-    \renewcommand{\footrulewidth}{0.4pt}
-    % define chaptermark with \@chappos when \@chappos is available for Japanese
-    \ltx@ifundefined{@chappos}{}
-      {\def\chaptermark##1{\markboth{\@chapapp\space\thechapter\space\@chappos\space ##1}{}}}
-    }
-  % Update the plain style so we get the page number & footer line,
-  % but not a chapter or section title.  This is to keep the first
-  % page of a chapter `clean.'
-   \fancypagestyle{plain}{
-    \fancyhf{}
-    \fancyfoot[RO]{{\py@HeaderFamily\thepage}}
-    \if@twoside\fancyfoot[LE]{{\py@HeaderFamily\thepage}}\fi
-    \renewcommand{\headrulewidth}{0pt}
-    \renewcommand{\footrulewidth}{0.4pt}
-    }
-   }
-  }
-  {% no fancyhdr: memoir class
-   % Provide default for 'normal' style simply as an alias of 'plain' style
-   % This way we can use \pagestyle{normal} in LaTeX template
-   \def\ps@normal{\ps@plain}
-   % Users of memoir class are invited to redefine 'normal' style in preamble
-  }
-
-% geometry
-\ifx\kanjiskip\@undefined
-  \PassOptionsToPackage{%
-     hmargin={\unexpanded{\spx@opt@hmargin}},%
-     vmargin={\unexpanded{\spx@opt@vmargin}},%
-     marginpar=\unexpanded{\spx@opt@marginpar}}
-  {geometry}
-\else
- % set text width for Japanese documents to be integer multiple of 1zw
- % and text height to be integer multiple of \baselineskip
- % the execution is delayed to \sphinxsetup then geometry.sty
- \normalsize\normalfont
- \newcommand*\sphinxtextwidthja[1]{%
-    \if@twocolumn\tw@\fi
-    \dimexpr
-       \numexpr\dimexpr\paperwidth-\tw@\dimexpr#1\relax\relax/
-               \dimexpr\if@twocolumn\tw@\else\@ne\fi zw\relax
-    zw\relax}%
- \newcommand*\sphinxmarginparwidthja[1]{%
-    \dimexpr\numexpr\dimexpr#1\relax/\dimexpr1zw\relax zw\relax}%
- \newcommand*\sphinxtextlinesja[1]{%
-    \numexpr\@ne+\dimexpr\paperheight-\topskip-\tw@\dimexpr#1\relax\relax/
-                 \baselineskip\relax}%
- \ifx\@jsc@uplatextrue\@undefined\else
- % the way we found in order for the papersize special written by
- % geometry in the dvi file to be correct in case of jsbook class
-   \ifnum\mag=\@m\else % do nothing special if nomag class option or 10pt
-     \PassOptionsToPackage{truedimen}{geometry}%
-   \fi
- \fi
- \PassOptionsToPackage{%
-    hmarginratio={1:1},%
-    textwidth=\unexpanded{\sphinxtextwidthja{\spx@opt@hmargin}},%
-    vmarginratio={1:1},%
-    lines=\unexpanded{\sphinxtextlinesja{\spx@opt@vmargin}},%
-    marginpar=\unexpanded{\sphinxmarginparwidthja{\spx@opt@marginpar}},%
-    footskip=2\baselineskip,%
-  }{geometry}%
- \AtBeginDocument
- {% update a dimension used by the jsclasses
-  \ifx\@jsc@uplatextrue\@undefined\else\fullwidth\textwidth\fi
-  % for some reason, jreport normalizes all dimensions with \@settopoint
-  \@ifclassloaded{jreport}
-    {\@settopoint\textwidth\@settopoint\textheight\@settopoint\marginparwidth}
-    {}% <-- "false" clause of \@ifclassloaded
-  }%
-\fi
-
-% fix fncychap's bug which uses prematurely the \textwidth value
-\@ifpackagewith{fncychap}{Bjornstrup}
- {\AtBeginDocument{\mylen\textwidth\advance\mylen-2\myhi}}%
- {}% <-- "false" clause of \@ifpackagewith
+\input{sphinxlatexstylepage.sty}
 
 
 %% TITLES
 %
-% Since Sphinx 1.5, users should use HeaderFamily key to 'sphinxsetup' rather
-% than defining their own \py@HeaderFamily command (which is still possible).
-% Memo: \py@HeaderFamily is also used by \maketitle as defined in
-% sphinxmanual.cls/sphinxhowto.cls
-\newcommand{\py@HeaderFamily}{\spx@opt@HeaderFamily}
-
-% This sets up the fancy chapter headings that make the documents look
-% at least a little better than the usual LaTeX output.
-\@ifpackagewith{fncychap}{Bjarne}{
-  \ChNameVar {\raggedleft\normalsize \py@HeaderFamily}
-  \ChNumVar  {\raggedleft\Large      \py@HeaderFamily}
-  \ChTitleVar{\raggedleft\Large      \py@HeaderFamily}
-  % This creates (numbered) chapter heads without the leading \vspace*{}:
-  \def\@makechapterhead#1{%
-    {\parindent \z@ \raggedright \normalfont
-      \ifnum \c@secnumdepth >\m@ne
-        \if@mainmatter
-          \DOCH
-        \fi
-      \fi
-      \interlinepenalty\@M
-      \if@mainmatter
-        \DOTI{#1}%
-      \else%
-        \DOTIS{#1}%
-      \fi
-    }}
-}{}% <-- "false" clause of \@ifpackagewith
-
-% Augment the sectioning commands used to get our own font family in place,
-% and reset some internal data items (\titleformat from titlesec package)
-\titleformat{\section}{\Large\py@HeaderFamily}%
-            {\py@TitleColor\thesection}{0.5em}{\py@TitleColor}{\py@NormalColor}
-\titleformat{\subsection}{\large\py@HeaderFamily}%
-            {\py@TitleColor\thesubsection}{0.5em}{\py@TitleColor}{\py@NormalColor}
-\titleformat{\subsubsection}{\py@HeaderFamily}%
-            {\py@TitleColor\thesubsubsection}{0.5em}{\py@TitleColor}{\py@NormalColor}
-% By default paragraphs (and subsubsections) will not be numbered because
-% sphinxmanual.cls and sphinxhowto.cls set secnumdepth to 2
-\titleformat{\paragraph}{\py@HeaderFamily}%
-            {\py@TitleColor\theparagraph}{0.5em}{\py@TitleColor}{\py@NormalColor}
-\titleformat{\subparagraph}{\py@HeaderFamily}%
-            {\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor}{\py@NormalColor}
+\input{sphinxlatexstyleheadings.sty}
 
 
 %% GRAPHICS
 %
-% \sphinxincludegraphics resizes images larger than the TeX \linewidth (which
-% is adjusted in indented environments), or taller than a certain maximal
-% height (usually \textheight and this is reduced in the environments which use
-% framed.sty to avoid infinite loop if image too tall).
-%
-% In case height or width options are present the rescaling is done
-% (since 2.0), in a way keeping the width:height ratio either native from
-% image or from the width and height options if both were present.
-%
-\newdimen\spx@image@maxheight
-\AtBeginDocument{\spx@image@maxheight\textheight}
-
-% box scratch register
-\newdimen\spx@image@box
-\newcommand*{\sphinxsafeincludegraphics}[2][]{%
-    % #1 contains possibly width=, height=, but no scale= since 1.8.4
-    \setbox\spx@image@box\hbox{\includegraphics[#1,draft]{#2}}%
-    \in@false % use some handy boolean flag
-    \ifdim \wd\spx@image@box>\linewidth
-      \in@true % flag to remember to adjust options and set box dimensions
-      % compute height which results from rescaling width to \linewidth
-      % and keep current aspect ratio. multiply-divide in \numexpr uses
-      % temporarily doubled precision, hence no overflow. (of course we
-      % assume \ht is not a few sp's below \maxdimen...(about 16384pt).
-      \edef\spx@image@rescaledheight % with sp units
-           {\the\numexpr\ht\spx@image@box
-                        *\linewidth/\wd\spx@image@box sp}%
-      \ifdim\spx@image@rescaledheight>\spx@image@maxheight
-        % the rescaled height will be too big, so it is height which decides
-        % the rescaling factor
-        \def\spx@image@requiredheight{\spx@image@maxheight}% dimen register
-        \edef\spx@image@requiredwidth % with sp units
-         {\the\numexpr\wd\spx@image@box
-                      *\spx@image@maxheight/\ht\spx@image@box sp}%
-        % TODO: decide if this commented-out block could be needed due to
-        % rounding in numexpr operations going up
-        % \ifdim\spx@image@requiredwidth>\linewidth
-        %     \def\spx@image@requiredwidth{\linewidth}% dimen register
-        % \fi
-      \else
-        \def\spx@image@requiredwidth{\linewidth}% dimen register
-        \let\spx@image@requiredheight\spx@image@rescaledheight% sp units
-      \fi
-    \else
-      % width is ok, let's check height
-      \ifdim\ht\spx@image@box>\spx@image@maxheight
-        \in@true
-        \edef\spx@image@requiredwidth % with sp units
-            {\the\numexpr\wd\spx@image@box
-                         *\spx@image@maxheight/\ht\spx@image@box sp}%
-        \def\spx@image@requiredheight{\spx@image@maxheight}% dimen register
-      \fi
-    \fi % end of check of width and height
-    \ifin@
-      \setbox\spx@image@box
-      \hbox{\includegraphics
-            [%#1,% contained only width and/or height and overruled anyhow
-            width=\spx@image@requiredwidth,height=\spx@image@requiredheight]%
-            {#2}}%
-      % \includegraphics does not set box dimensions to the exactly
-      % requested ones, see https://github.com/latex3/latex2e/issues/112
-      \wd\spx@image@box\spx@image@requiredwidth
-      \ht\spx@image@box\spx@image@requiredheight
-      \leavevmode\box\spx@image@box
-    \else
-      % here we do not modify the options, no need to adjust width and height
-      % on output, they will be computed exactly as with "draft" option
-      \setbox\spx@image@box\box\voidb@x % clear memory
-      \includegraphics[#1]{#2}%
-    \fi
-}%
-% Use the "safe" one by default (2.0)
-\def\sphinxincludegraphics{\sphinxsafeincludegraphics}
-
-
-%% FIGURE IN TABLE
-%
-\newenvironment{sphinxfigure-in-table}[1][\linewidth]{%
-  \def\@captype{figure}%
-  \sphinxsetvskipsforfigintablecaption
-  \begin{minipage}{#1}%
-}{\end{minipage}}
-% store the original \caption macro for usage with figures inside longtable
-% and tabulary cells. Make sure we get the final \caption in presence of
-% caption package, whether the latter was loaded before or after sphinx.
-\AtBeginDocument{%
-    \let\spx@originalcaption\caption
-    \@ifpackageloaded{caption}
-      {\let\spx@ifcaptionpackage\@firstoftwo
-       \caption@AtBeginDocument*{\let\spx@originalcaption\caption}%
-% in presence of caption package, drop our own \sphinxcaption whose aim was to
-% ensure same width of caption to all kinds of tables (tabular(y), longtable),
-% because caption package has its own width (or margin) option
-       \def\sphinxcaption{\caption}%
-      }%
-      {\let\spx@ifcaptionpackage\@secondoftwo}%
-}
-% tabulary expands twice contents, we need to prevent double counter stepping
-\newcommand*\sphinxfigcaption
-  {\ifx\equation$%$% this is trick to identify tabulary first pass
-       \firstchoice@false\else\firstchoice@true\fi
-   \spx@originalcaption }
-\newcommand*\sphinxsetvskipsforfigintablecaption
-  {\abovecaptionskip\smallskipamount
-   \belowcaptionskip\smallskipamount}
+\input{sphinxlatexgraphics.sty}
 
 
 %% CITATIONS
 %
 \protected\def\sphinxcite{\cite}
 
+
 %% FOOTNOTES
 %
 % Support large numbered footnotes in minipage
@@ -844,1113 +103,33 @@
 
 
 %% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS
-
-% Everything is delayed to \begin{document} to allow hyperref patches into
-%   \newcounter to solve duplicate label problems for internal hyperlinks to
-%   code listings (literalblock counter).  User or extension re-definitions of
-%   \theliteralblock, et al., thus have also to be delayed. (changed at 3.5.0)
-\AtBeginDocument{%
-\ltx@ifundefined{c@chapter}
-   {\newcounter{literalblock}}%
-   {\newcounter{literalblock}[chapter]%
-    \def\theliteralblock{\ifnum\c@chapter>\z@\arabic{chapter}.\fi
-                         \arabic{literalblock}}%
-    }%
-\ifspx@opt@nonumfigreset
-    \ltx@ifundefined{c@chapter}{}{%
-      \@removefromreset{figure}{chapter}%
-      \@removefromreset{table}{chapter}%
-      \@removefromreset{literalblock}{chapter}%
-      \ifspx@opt@mathnumfig
-        \@removefromreset{equation}{chapter}%
-      \fi
-    }%
-    \def\thefigure{\arabic{figure}}%
-    \def\thetable {\arabic{table}}%
-    \def\theliteralblock{\arabic{literalblock}}%
-    \ifspx@opt@mathnumfig
-      \def\theequation{\arabic{equation}}%
-    \fi
-\else
-\let\spx@preAthefigure\@empty
-\let\spx@preBthefigure\@empty
-% \ifspx@opt@usespart  % <-- LaTeX writer could pass such a 'usespart' boolean
-%                      %     as sphinx.sty package option
-% If document uses \part, (triggered in Sphinx by latex_toplevel_sectioning)
-% LaTeX core per default does not reset chapter or section
-% counters at each part.
-% But if we modify this, we need to redefine \thechapter, \thesection to
-% include the part number and this will cause problems in table of contents
-% because of too wide numbering. Simplest is to do nothing.
-% \fi
-\ifnum\spx@opt@numfigreset>0
-    \ltx@ifundefined{c@chapter}
-      {}
-      {\g@addto@macro\spx@preAthefigure{\ifnum\c@chapter>\z@\arabic{chapter}.}%
-       \g@addto@macro\spx@preBthefigure{\fi}}%
-\fi
-\ifnum\spx@opt@numfigreset>1
-    \@addtoreset{figure}{section}%
-    \@addtoreset{table}{section}%
-    \@addtoreset{literalblock}{section}%
-    \ifspx@opt@mathnumfig
-      \@addtoreset{equation}{section}%
-    \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@section>\z@\arabic{section}.}%
-    \g@addto@macro\spx@preBthefigure{\fi}%
-\fi
-\ifnum\spx@opt@numfigreset>2
-    \@addtoreset{figure}{subsection}%
-    \@addtoreset{table}{subsection}%
-    \@addtoreset{literalblock}{subsection}%
-    \ifspx@opt@mathnumfig
-      \@addtoreset{equation}{subsection}%
-    \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsection>\z@\arabic{subsection}.}%
-    \g@addto@macro\spx@preBthefigure{\fi}%
-\fi
-\ifnum\spx@opt@numfigreset>3
-    \@addtoreset{figure}{subsubsection}%
-    \@addtoreset{table}{subsubsection}%
-    \@addtoreset{literalblock}{subsubsection}%
-    \ifspx@opt@mathnumfig
-      \@addtoreset{equation}{subsubsection}%
-    \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubsection>\z@\arabic{subsubsection}.}%
-    \g@addto@macro\spx@preBthefigure{\fi}%
-\fi
-\ifnum\spx@opt@numfigreset>4
-    \@addtoreset{figure}{paragraph}%
-    \@addtoreset{table}{paragraph}%
-    \@addtoreset{literalblock}{paragraph}%
-    \ifspx@opt@mathnumfig
-      \@addtoreset{equation}{paragraph}%
-    \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@subparagraph>\z@\arabic{subparagraph}.}%
-    \g@addto@macro\spx@preBthefigure{\fi}%
-\fi
-\ifnum\spx@opt@numfigreset>5
-    \@addtoreset{figure}{subparagraph}%
-    \@addtoreset{table}{subparagraph}%
-    \@addtoreset{literalblock}{subparagraph}%
-    \ifspx@opt@mathnumfig
-      \@addtoreset{equation}{subparagraph}%
-    \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubparagraph>\z@\arabic{subsubparagraph}.}%
-    \g@addto@macro\spx@preBthefigure{\fi}%
-\fi
-\expandafter\g@addto@macro
-\expandafter\spx@preAthefigure\expandafter{\spx@preBthefigure}%
-\let\thefigure\spx@preAthefigure
-\let\thetable\spx@preAthefigure
-\let\theliteralblock\spx@preAthefigure
-\g@addto@macro\thefigure{\arabic{figure}}%
-\g@addto@macro\thetable{\arabic{table}}%
-\g@addto@macro\theliteralblock{\arabic{literalblock}}%
-  \ifspx@opt@mathnumfig
-    \let\theequation\spx@preAthefigure
-    \g@addto@macro\theequation{\arabic{equation}}%
-  \fi
-\fi
-}% end of big \AtBeginDocument
-
-%% LITERAL BLOCKS
 %
-% Based on use of "fancyvrb.sty"'s Verbatim.
-% - with framing allowing page breaks ("framed.sty")
-% - with breaking of long lines (exploits Pygments mark-up),
-% - with possibly of a top caption, non-separable by pagebreak.
-% - and usable inside tables or footnotes ("footnotehyper-sphinx").
+\input{sphinxlatexmiscnumbering.sty}
 
-% Prior to Sphinx 1.5, \Verbatim and \endVerbatim were modified by Sphinx.
-% The aliases defined here are used in sphinxVerbatim environment and can
-% serve as hook-points with no need to modify \Verbatim itself.
-\let\OriginalVerbatim   \Verbatim
-\let\endOriginalVerbatim\endVerbatim
 
-% for captions of literal blocks
-% at start of caption title
-\newcommand*{\fnum@literalblock}{\literalblockname\nobreakspace\theliteralblock}
-% this will be overwritten in document preamble by Babel translation
-\newcommand*{\literalblockname}{Listing }
-% file extension needed for \caption's good functioning, the file is created
-% only if a \listof{literalblock}{foo} command is encountered, which is
-% analogous to \listoffigures, but for the code listings (foo = chosen title.)
-\newcommand*{\ext@literalblock}{lol}
-
-\newif\ifspx@inframed % flag set if we are already in a framed environment
-% if forced use of minipage encapsulation is needed (e.g. table cells)
-\newif\ifsphinxverbatimwithminipage   \sphinxverbatimwithminipagefalse
-
-% Framing macro for use with framed.sty's \FrameCommand
-%  - it obeys current indentation,
-%  - frame is \fboxsep separated from the contents,
-%  - the contents use the full available text width,
-%  - #1 = color of frame, #2 = color of background,
-%  - #3 = above frame, #4 = below frame, #5 = within frame,
-%  - #3 and #4 must be already typeset boxes; they must issue \normalcolor
-%    or similar, else, they are under scope of color #1
-\long\def\spx@fcolorbox #1#2#3#4#5{%
-  \hskip\@totalleftmargin
-  \hskip-\fboxsep\hskip-\fboxrule
-  % use of \color@b@x here is compatible with both xcolor.sty and color.sty
-  \color@b@x {\color{#1}\spx@CustomFBox{#3}{#4}}{\color{#2}}{#5}%
-  \hskip-\fboxsep\hskip-\fboxrule
-  \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth
-}%
-% #1 = for material above frame, such as a caption or a "continued" hint
-% #2 = for material below frame, such as a caption or "continues on next page"
-% #3 = actual contents, which will be typeset with a background color
-\long\def\spx@CustomFBox#1#2#3{%
-  \begingroup
-  \setbox\@tempboxa\hbox{{#3}}% inner braces to avoid color leaks
-  \vbox{#1% above frame
-            % draw frame border _latest_ to avoid pdf viewer issue
-            \kern\fboxrule
-            \hbox{\kern\fboxrule
-                  \copy\@tempboxa
-                  \kern-\wd\@tempboxa\kern-\fboxrule
-                  \vrule\@width\fboxrule
-                  \kern\wd\@tempboxa
-                  \vrule\@width\fboxrule}%
-            \kern-\dimexpr\ht\@tempboxa+\dp\@tempboxa+\fboxrule\relax
-            \hrule\@height\fboxrule
-            \kern\dimexpr\ht\@tempboxa+\dp\@tempboxa\relax
-            \hrule\@height\fboxrule
-        #2% below frame
-       }%
-  \endgroup
-}%
-\def\spx@fcolorbox@put@c#1{% hide width from framed.sty measuring
-    \moveright\dimexpr\fboxrule+.5\wd\@tempboxa\hb@xt@\z@{\hss#1\hss}%
-}%
-\def\spx@fcolorbox@put@r#1{% right align with contents, width hidden
-    \moveright\dimexpr\fboxrule+\wd\@tempboxa-\fboxsep\hb@xt@\z@{\hss#1}%
-}%
-\def\spx@fcolorbox@put@l#1{% left align with contents, width hidden
-    \moveright\dimexpr\fboxrule+\fboxsep\hb@xt@\z@{#1\hss}%
-}%
-%
-\def\sphinxVerbatim@Continued
-   {\csname spx@fcolorbox@put@\spx@opt@verbatimcontinuedalign\endcsname
-    {\normalcolor\sphinxstylecodecontinued\literalblockcontinuedname}}%
-\def\sphinxVerbatim@Continues
-   {\csname spx@fcolorbox@put@\spx@opt@verbatimcontinuesalign\endcsname
-    {\normalcolor\sphinxstylecodecontinues\literalblockcontinuesname}}%
-\def\sphinxVerbatim@Title
-   {\spx@fcolorbox@put@c{\unhcopy\sphinxVerbatim@TitleBox}}%
-\let\sphinxVerbatim@Before\@empty
-\let\sphinxVerbatim@After\@empty
-% Defaults are redefined in document preamble according to language
-\newcommand*\literalblockcontinuedname{continued from previous page}%
-\newcommand*\literalblockcontinuesname{continues on next page}%
+%% LITERAL BLOCKS
 %
-\def\spx@verbatimfcolorbox{\spx@fcolorbox{VerbatimBorderColor}{VerbatimColor}}%
-\def\sphinxVerbatim@FrameCommand
-   {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@After}%
-\def\sphinxVerbatim@FirstFrameCommand
-   {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@Continues}%
-\def\sphinxVerbatim@MidFrameCommand
-   {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@Continues}%
-\def\sphinxVerbatim@LastFrameCommand
-   {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@After}%
-
-% For linebreaks inside Verbatim environment from package fancyvrb.
-\newbox\sphinxcontinuationbox
-\newbox\sphinxvisiblespacebox
-\newcommand*\sphinxafterbreak {\copy\sphinxcontinuationbox}
-
-% Take advantage of the already applied Pygments mark-up to insert
-% potential linebreaks for TeX processing.
-%        {, <, #, %, $, ' and ": go to next line.
-%        _, }, ^, &, >, -, ~, and \: stay at end of broken line.
-% Use of \textquotesingle for straight quote.
-% FIXME: convert this to package options ?
-\newcommand*\sphinxbreaksbeforelist {%
-    \do\PYGZob\{\do\PYGZlt\<\do\PYGZsh\#\do\PYGZpc\%% {, <, #, %,
-    \do\PYGZdl\$\do\PYGZdq\"% $, "
-    \def\PYGZsq
-     {\discretionary{}{\sphinxafterbreak\textquotesingle}{\textquotesingle}}% '
-}
-\newcommand*\sphinxbreaksafterlist {%
-    \do\PYGZus\_\do\PYGZcb\}\do\PYGZca\^\do\PYGZam\&% _, }, ^, &,
-    \do\PYGZgt\>\do\PYGZhy\-\do\PYGZti\~% >, -, ~
-    \do\PYGZbs\\% \
-}
-\newcommand*\sphinxbreaksatspecials {%
-  \def\do##1##2%
-     {\def##1{\discretionary{}{\sphinxafterbreak\char`##2}{\char`##2}}}%
-  \sphinxbreaksbeforelist
-  \def\do##1##2%
-     {\def##1{\discretionary{\char`##2}{\sphinxafterbreak}{\char`##2}}}%
-  \sphinxbreaksafterlist
-}
-
-\def\sphinx@verbatim@nolig@list {\do \`}%
-% Some characters . , ; ? ! / are neither pygmentized nor "tex-escaped".
-% This macro makes them "active" and they will insert potential linebreaks.
-% Not compatible with math mode (cf \sphinxunactivateextras).
-\newcommand*\sphinxbreaksbeforeactivelist {}% none
-\newcommand*\sphinxbreaksafteractivelist  {\do\.\do\,\do\;\do\?\do\!\do\/}
-\newcommand*\sphinxbreaksviaactive {%
-   \def\do##1{\lccode`\~`##1%
-    \lowercase{\def~}{\discretionary{}{\sphinxafterbreak\char`##1}{\char`##1}}%
-    \catcode`##1\active}%
-   \sphinxbreaksbeforeactivelist
-   \def\do##1{\lccode`\~`##1%
-    \lowercase{\def~}{\discretionary{\char`##1}{\sphinxafterbreak}{\char`##1}}%
-    \catcode`##1\active}%
-   \sphinxbreaksafteractivelist
-   \lccode`\~`\~
-}
-
-% If the linebreak is at a space, the latter will be displayed as visible
-% space at end of first line, and a continuation symbol starts next line.
-\def\spx@verbatim@space {%
-     \nobreak\hskip\z@skip
-     \discretionary{\copy\sphinxvisiblespacebox}{\sphinxafterbreak}
-                   {\kern\fontdimen2\font}%
-}%
-
-% if the available space on page is less than \literalblockneedspace, insert pagebreak
-\newcommand{\sphinxliteralblockneedspace}{5\baselineskip}
-\newcommand{\sphinxliteralblockwithoutcaptionneedspace}{1.5\baselineskip}
-% The title (caption) is specified from outside as macro \sphinxVerbatimTitle.
-% \sphinxVerbatimTitle is reset to empty after each use of Verbatim.
-\newcommand*\sphinxVerbatimTitle {}
-% This box to typeset the caption before framed.sty multiple passes for framing.
-\newbox\sphinxVerbatim@TitleBox
-% This box to measure contents if nested as inner \MakeFramed requires then
-% minipage encapsulation but too long contents then break outer \MakeFramed
-\newbox\sphinxVerbatim@ContentsBox
-% This is a workaround to a "feature" of French lists, when literal block
-% follows immediately; usable generally (does only \par then), a priori...
-\newcommand*\sphinxvspacefixafterfrenchlists{%
-   \ifvmode\ifdim\lastskip<\z@ \vskip\parskip\fi\else\par\fi
-}
-% Holder macro for labels of literal blocks. Set-up by LaTeX writer.
-\newcommand*\sphinxLiteralBlockLabel {}
-\newcommand*\sphinxSetupCaptionForVerbatim [1]
-{%
-    \sphinxvspacefixafterfrenchlists
-    \needspace{\sphinxliteralblockneedspace}%
-% insert a \label via \sphinxLiteralBlockLabel
-% reset to normal the color for the literal block caption
-    \def\sphinxVerbatimTitle
-       {\py@NormalColor\sphinxcaption{\sphinxLiteralBlockLabel #1}}%
-}
-\newcommand*\sphinxSetupCodeBlockInFootnote {%
-  \fvset{fontsize=\footnotesize}\let\caption\sphinxfigcaption
-  \sphinxverbatimwithminipagetrue % reduces vertical spaces
-  % we counteract (this is in a group) the \@normalsize from \caption
-  \let\normalsize\footnotesize\let\@parboxrestore\relax
-  \def\spx@abovecaptionskip{\sphinxverbatimsmallskipamount}%
-}
-\newcommand*{\sphinxverbatimsmallskipamount}{\smallskipamount}
-% serves to implement line highlighting and line wrapping
-\newcommand\sphinxFancyVerbFormatLine[1]{%
-  \expandafter\sphinx@verbatim@checkifhl\expandafter{\the\FV@CodeLineNo}%
-  \ifin@
-     \sphinxVerbatimHighlightLine{#1}%
-  \else
-     \sphinxVerbatimFormatLine{#1}%
-  \fi
-}%
-\newcommand\sphinxVerbatimHighlightLine[1]{%
-  \edef\sphinxrestorefboxsep{\fboxsep\the\fboxsep\relax}%
-  \fboxsep0pt\relax % cf LaTeX bug graphics/4524
-  \colorbox{sphinxVerbatimHighlightColor}%
-           {\sphinxrestorefboxsep\sphinxVerbatimFormatLine{#1}}%
-  % no need to restore \fboxsep here, as this ends up in a \hbox from fancyvrb
-}%
-% \sphinxVerbatimFormatLine will be set locally to one of those two:
-\newcommand\sphinxVerbatimFormatLineWrap[1]{%
-    \hsize\linewidth
-    \vtop{\raggedright\hyphenpenalty\z@\exhyphenpenalty\z@
-          \doublehyphendemerits\z@\finalhyphendemerits\z@
-          \strut #1\strut}%
-}%
-\newcommand\sphinxVerbatimFormatLineNoWrap[1]{\hb@xt@\linewidth{\strut #1\hss}}%
-\g@addto@macro\FV@SetupFont{%
-    \sbox\sphinxcontinuationbox {\spx@opt@verbatimcontinued}%
-    \sbox\sphinxvisiblespacebox {\spx@opt@verbatimvisiblespace}%
-}%
-\newenvironment{sphinxVerbatim}{%
-  % first, let's check if there is a caption
-  \ifx\sphinxVerbatimTitle\empty
-      \sphinxvspacefixafterfrenchlists
-      \parskip\z@skip
-      \vskip\sphinxverbatimsmallskipamount
-      % there was no caption. Check if nevertheless a label was set.
-      \ifx\sphinxLiteralBlockLabel\empty\else
-      % we require some space to be sure hyperlink target from \phantomsection
-      % will not be separated from upcoming verbatim by a page break
-          \needspace{\sphinxliteralblockwithoutcaptionneedspace}%
-          \phantomsection\sphinxLiteralBlockLabel
-      \fi
-  \else
-     \parskip\z@skip
-     \if t\spx@opt@literalblockcappos
-       \vskip\spx@abovecaptionskip
-       \def\sphinxVerbatim@Before
-           {\sphinxVerbatim@Title\nointerlineskip
-            \kern\dimexpr-\dp\strutbox+\sphinxbelowcaptionspace
-                 % if no frame (code-blocks inside table cells), remove
-                 % the "verbatimsep" whitespace from the top (better visually)
-                 \ifspx@opt@verbatimwithframe\else-\sphinxverbatimsep\fi
-                 % caption package adds \abovecaptionskip vspace, remove it
-                 \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax}%
-     \else
-       \vskip\sphinxverbatimsmallskipamount
-       \def\sphinxVerbatim@After
-          {\nointerlineskip\kern\dimexpr\dp\strutbox
-            \ifspx@opt@verbatimwithframe\else-\sphinxverbatimsep\fi
-            \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax
-           \sphinxVerbatim@Title}%
-     \fi
-     \def\@captype{literalblock}%
-     \capstart
-     % \sphinxVerbatimTitle must reset color
-     \setbox\sphinxVerbatim@TitleBox
-            \hbox{\begin{minipage}{\linewidth}%
-     % caption package may detect wrongly if top or bottom, so we help it
-                    \spx@ifcaptionpackage
-                      {\caption@setposition{\spx@opt@literalblockcappos}}{}%
-                    \sphinxVerbatimTitle
-                  \end{minipage}}%
-  \fi
-  \global\let\sphinxLiteralBlockLabel\empty
-  \global\let\sphinxVerbatimTitle\empty
-  \fboxsep\sphinxverbatimsep \fboxrule\sphinxverbatimborder
-  \ifspx@opt@verbatimwithframe\else\fboxrule\z@\fi
-  \let\FrameCommand     \sphinxVerbatim@FrameCommand
-  \let\FirstFrameCommand\sphinxVerbatim@FirstFrameCommand
-  \let\MidFrameCommand  \sphinxVerbatim@MidFrameCommand
-  \let\LastFrameCommand \sphinxVerbatim@LastFrameCommand
-  \ifspx@opt@verbatimhintsturnover\else
-      \let\sphinxVerbatim@Continued\@empty
-      \let\sphinxVerbatim@Continues\@empty
-  \fi
-  \ifspx@opt@verbatimwrapslines
-  % fancyvrb's Verbatim puts each input line in (unbreakable) horizontal boxes.
-  % This customization wraps each line from the input in a \vtop, thus
-  % allowing it to wrap and display on two or more lines in the latex output.
-  %     - The codeline counter will be increased only once.
-  %     - The wrapped material will not break across pages, it is impossible
-  %       to achieve this without extensive rewrite of fancyvrb.
-  %     - The (not used in sphinx) obeytabs option to Verbatim is
-  %       broken by this change (showtabs and tabspace work).
-    \let\sphinxVerbatimFormatLine\sphinxVerbatimFormatLineWrap
-    \let\FV@Space\spx@verbatim@space
-  % Allow breaks at special characters using \PYG... macros.
-    \sphinxbreaksatspecials
-  % Breaks at punctuation characters . , ; ? ! and / (needs catcode activation)
-    \fvset{codes*=\sphinxbreaksviaactive}%
-  \else % end of conditional code for wrapping long code lines
-    \let\sphinxVerbatimFormatLine\sphinxVerbatimFormatLineNoWrap
-  \fi
-  \let\FancyVerbFormatLine\sphinxFancyVerbFormatLine
-  \VerbatimEnvironment
-  % workaround to fancyvrb's check of current list depth
-  \def\@toodeep {\advance\@listdepth\@ne}%
-  % The list environment is needed to control perfectly the vertical space.
-  % Note: \OuterFrameSep used by framed.sty is later set to \topsep hence 0pt.
-  % - if caption: distance from last text baseline to caption baseline is
-  %   A+(B-F)+\ht\strutbox, A = \abovecaptionskip (default 10pt), B =
-  %   \baselineskip, F is the framed.sty \FrameHeightAdjust macro, default 6pt.
-  %   Formula valid for F < 10pt.
-  % - distance of baseline of caption to top of frame is like for tables:
-  %   \sphinxbelowcaptionspace (=0.5\baselineskip)
-  % - if no caption: distance of last text baseline to code frame is S+(B-F),
-  %   with S = \sphinxverbatimtopskip (=\smallskip)
-  % - and distance from bottom of frame to next text baseline is
-  %   \baselineskip+\parskip.
-  % The \trivlist is used to avoid possible "too deeply nested" error.
-  \itemsep   \z@skip
-  \topsep    \z@skip
-  \partopsep \z@skip
-  % trivlist will set \parsep to \parskip (which itself is set to zero above)
-  % \leftmargin will be set to zero by trivlist
-  \rightmargin\z@
-  \parindent  \z@% becomes \itemindent. Default zero, but perhaps overwritten.
-  \trivlist\item\relax
-     \ifspx@inframed\setbox\sphinxVerbatim@ContentsBox\vbox\bgroup
-        \@setminipage\hsize\linewidth
-        % use bulk of minipage paragraph shape restores (this is needed
-        % in indented contexts, at least for some)
-        \textwidth\hsize \columnwidth\hsize \@totalleftmargin\z@
-        \leftskip\z@skip \rightskip\z@skip  \@rightskip\z@skip
-     \else
-       \ifsphinxverbatimwithminipage\noindent\begin{minipage}{\linewidth}\fi
-       \MakeFramed {% adapted over from framed.sty's snugshade environment
-        \advance\hsize-\width\@totalleftmargin\z@\linewidth\hsize\@setminipage
-        }%
-     \fi
-     % For grid placement from \strut's in \FancyVerbFormatLine
-     \lineskip\z@skip
-     % active comma should not be overwritten by \@noligs
-     \ifspx@opt@verbatimwrapslines
-       \let\verbatim@nolig@list \sphinx@verbatim@nolig@list
-     \fi
-     % will fetch its optional arguments if any
-     \OriginalVerbatim
-}
-{%
-  \endOriginalVerbatim
-  \ifspx@inframed
-   \egroup % finish \sphinxVerbatim@ContentsBox vbox
-   \nobreak % update page totals
-   \ifdim\dimexpr\ht\sphinxVerbatim@ContentsBox+
-         \dp\sphinxVerbatim@ContentsBox+
-         \ht\sphinxVerbatim@TitleBox+
-         \dp\sphinxVerbatim@TitleBox+
-         2\fboxsep+2\fboxrule+
-         % try to account for external frame parameters
-         \FrameSep+\FrameRule+
-         % Usage here of 2 baseline distances is empirical.
-         % In border case where code-block fits barely in remaining space,
-         % it gets framed and looks good but the outer frame may continue
-         % on top of next page and give (if no contents after code-block)
-         % an empty framed line, as testing showed.
-         2\baselineskip+
-         % now add all to accumulated page totals and compare to \pagegoal
-         \pagetotal+\pagedepth>\pagegoal
-    % long contents: do not \MakeFramed. Do make a caption (either before or
-    % after) if title exists. Continuation hints across pagebreaks dropped.
-    % FIXME? a bottom caption may end up isolated at top of next page
-    %        (no problem with a top caption, which is default)
-    \spx@opt@verbatimwithframefalse
-    \def\sphinxVerbatim@Title{\noindent\box\sphinxVerbatim@TitleBox\par}%
-    \sphinxVerbatim@Before
-    \noindent\unvbox\sphinxVerbatim@ContentsBox\par
-    \sphinxVerbatim@After
-   \else
-    % short enough contents: use \MakeFramed. As it is nested, this requires
-    % minipage encapsulation.
-    \noindent\begin{minipage}{\linewidth}%
-     \MakeFramed {% Use it now with the fetched contents
-      \advance\hsize-\width\@totalleftmargin\z@\linewidth\hsize\@setminipage
-      }%
-     \unvbox\sphinxVerbatim@ContentsBox
-     % some of this may be superfluous:
-     \par\unskip\@minipagefalse\endMakeFramed
-    \end{minipage}%
-   \fi
-  \else % non-nested \MakeFramed
-    \par\unskip\@minipagefalse\endMakeFramed % from framed.sty snugshade
-    \ifsphinxverbatimwithminipage\end{minipage}\fi
-  \fi
-  \endtrivlist
-}
-\newenvironment {sphinxVerbatimNoFrame}
-  {\spx@opt@verbatimwithframefalse
-   \VerbatimEnvironment
-   \begin{sphinxVerbatim}}
-  {\end{sphinxVerbatim}}
-\newenvironment {sphinxVerbatimintable}
-  {% don't use a frame if in a table cell
-   \spx@opt@verbatimwithframefalse
-   \sphinxverbatimwithminipagetrue
-   % the literal block caption uses \sphinxcaption which is wrapper of \caption,
-   % but \caption must be modified because longtable redefines it to work only
-   % for the own table caption, and tabulary has multiple passes
-   \let\caption\sphinxfigcaption
-   % reduce above caption skip
-   \def\spx@abovecaptionskip{\sphinxverbatimsmallskipamount}%
-   \VerbatimEnvironment
-   \begin{sphinxVerbatim}}
-  {\end{sphinxVerbatim}}
-
-
-%% PARSED LITERALS
-% allow long lines to wrap like they do in code-blocks
-
-% this should be kept in sync with definitions in sphinx.util.texescape
-\newcommand*\sphinxbreaksattexescapedchars{%
-  \def\do##1##2% put potential break point before character
-     {\def##1{\discretionary{}{\sphinxafterbreak\char`##2}{\char`##2}}}%
-  \do\{\{\do\textless\<\do\#\#\do\%\%\do\$\$% {, <, #, %, $
-  \def\do##1##2% put potential break point after character
-     {\def##1{\discretionary{\char`##2}{\sphinxafterbreak}{\char`##2}}}%
-  \do\_\_\do\}\}\do\textasciicircum\^\do\&\&% _, }, ^, &,
-  \do\textgreater\>\do\textasciitilde\~% >, ~
-  \do\textbackslash\\% \
-}
-\newcommand*\sphinxbreaksviaactiveinparsedliteral{%
-  \sphinxbreaksviaactive % by default handles . , ; ? ! /
-  \lccode`\~`\~ %
-  % update \dospecials as it is used by \url
-  % but deactivation will already have been done hence this is unneeded:
-  %  \expandafter\def\expandafter\dospecials\expandafter{\dospecials
-  %   \sphinxbreaksbeforeactivelist\sphinxbreaksafteractivelist\do\-}%
-}
-\newcommand*\sphinxbreaksatspaceinparsedliteral{%
-  \lccode`~32 \lowercase{\let~}\spx@verbatim@space\lccode`\~`\~
-}
-\newcommand*{\sphinxunactivateextras}{\let\do\@makeother
-      \sphinxbreaksbeforeactivelist\sphinxbreaksafteractivelist}%
-% the \catcode13=5\relax (deactivate end of input lines) is left to callers
-\newcommand*{\sphinxunactivateextrasandspace}{\catcode32=10\relax
-      \sphinxunactivateextras}%
-% now for the modified alltt environment
-\newenvironment{sphinxalltt}
-{% at start of next line to workaround Emacs/AUCTeX issue with this file
-\begin{alltt}%
- \ifspx@opt@parsedliteralwraps
-   \sbox\sphinxcontinuationbox {\spx@opt@verbatimcontinued}%
-   \sbox\sphinxvisiblespacebox {\spx@opt@verbatimvisiblespace}%
-   \sphinxbreaksattexescapedchars
-   \sphinxbreaksviaactiveinparsedliteral
-   \sphinxbreaksatspaceinparsedliteral
-% alltt takes care of the ' as derivative ("prime") in math mode
-   \everymath\expandafter{\the\everymath\sphinxunactivateextrasandspace
-             \catcode`\<=12\catcode`\>=12\catcode`\^=7\catcode`\_=8 }%
-% not sure if displayed math (align,...) can end up in parsed-literal, anyway
-   \everydisplay\expandafter{\the\everydisplay
-             \catcode13=5 \sphinxunactivateextrasandspace
-             \catcode`\<=12\catcode`\>=12\catcode`\^=7\catcode`\_=8 }%
- \fi }
-{\end{alltt}}
-
-% Protect \href's first argument in contexts such as sphinxalltt (or
-% \sphinxcode). Sphinx uses \#, \%, \& ... always inside \sphinxhref.
-\protected\def\sphinxhref#1#2{{%
-    \sphinxunactivateextrasandspace % never do \scantokens with active space!
-% for the \endlinechar business, https://github.com/latex3/latex2e/issues/286
-    \endlinechar\m@ne\everyeof{{\endlinechar13 #2}}% keep catcode regime for #2
-    \scantokens{\href{#1}}% normalise it for #1 during \href expansion
-}}
-% Same for \url. And also \nolinkurl for coherence.
-\protected\def\sphinxurl#1{{%
-    \sphinxunactivateextrasandspace\everyeof{}% (<- precaution for \scantokens)
-    \endlinechar\m@ne\scantokens{\url{#1}}%
-}}
-\protected\def\sphinxnolinkurl#1{{%
-    \sphinxunactivateextrasandspace\everyeof{}%
-    \endlinechar\m@ne\scantokens{\nolinkurl{#1}}%
-}}
+\input{sphinxlatexenvliteral.sty}
 
 
 %% TOPIC AND CONTENTS BOXES
 %
-% Again based on use of "framed.sty", this allows breakable framed boxes.
-\long\def\spx@ShadowFBox#1{%
-  \leavevmode\begingroup
-  % first we frame the box #1
-  \setbox\@tempboxa
-   \hbox{\vrule\@width\sphinxshadowrule
-         \vbox{\hrule\@height\sphinxshadowrule
-               \kern\sphinxshadowsep
-               \hbox{\kern\sphinxshadowsep #1\kern\sphinxshadowsep}%
-               \kern\sphinxshadowsep
-               \hrule\@height\sphinxshadowrule}%
-         \vrule\@width\sphinxshadowrule}%
-  % Now we add the shadow, like \shadowbox from fancybox.sty would do
-  \dimen@\dimexpr.5\sphinxshadowrule+\sphinxshadowsize\relax
-  \hbox{\vbox{\offinterlineskip
-              \hbox{\copy\@tempboxa\kern-.5\sphinxshadowrule
-                    % add shadow on right side
-                    \lower\sphinxshadowsize
-                          \hbox{\vrule\@height\ht\@tempboxa \@width\dimen@}%
-                    }%
-              \kern-\dimen@ % shift back vertically to bottom of frame
-              % and add shadow at bottom
-              \moveright\sphinxshadowsize
-                    \vbox{\hrule\@width\wd\@tempboxa \@height\dimen@}%
-              }%
-        % move left by the size of right shadow so shadow adds no width
-        \kern-\sphinxshadowsize
-       }%
-  \endgroup
-}
-
-% use framed.sty to allow page breaks in frame+shadow
-% works well inside Lists and Quote-like environments
-% produced by ``topic'' directive (or local contents)
-% could nest if LaTeX writer authorized it
-\newenvironment{sphinxShadowBox}
-  {\def\FrameCommand {\spx@ShadowFBox }%
-   \advance\spx@image@maxheight
-   -\dimexpr2\sphinxshadowrule
-           +2\sphinxshadowsep
-           +\sphinxshadowsize
-           +\baselineskip\relax
-   % configure framed.sty not to add extra vertical spacing
-   \ltx@ifundefined{OuterFrameSep}{}{\OuterFrameSep\z@skip}%
-   % the \trivlist will add the vertical spacing on top and bottom which is
-   % typical of center environment as used in Sphinx <= 1.4.1
-   % the \noindent has the effet of an extra blank line on top, to
-   % imitate closely the layout from Sphinx <= 1.4.1; the \FrameHeightAdjust
-   % will put top part of frame on this baseline.
-   \def\FrameHeightAdjust {\baselineskip}%
-   % use package footnote to handle footnotes
-   \savenotes
-   \trivlist\item\noindent
-    % use a minipage if we are already inside a framed environment
-    \ifspx@inframed\begin{minipage}{\linewidth}\fi
-    \MakeFramed {\spx@inframedtrue
-    % framed.sty puts into "\width" the added width (=2shadowsep+2shadowrule)
-    % adjust \hsize to what the contents must use
-    \advance\hsize-\width
-    % adjust LaTeX parameters to behave properly in indented/quoted contexts
-    \FrameRestore
-    % typeset the contents as in a minipage (Sphinx <= 1.4.1 used a minipage and
-    % itemize/enumerate are therein typeset more tightly, we want to keep
-    % that). We copy-paste from LaTeX source code but don't do a real minipage.
-    \@pboxswfalse
-    \let\@listdepth\@mplistdepth \@mplistdepth\z@
-    \@minipagerestore
-    \@setminipage
-    }%
-  }%
-  {% insert the "endminipage" code
-    \par\unskip
-    \@minipagefalse
-   \endMakeFramed
-     \ifspx@inframed\end{minipage}\fi
-   \endtrivlist
-   % output the stored footnotes
-   \spewnotes
-  }
+\input{sphinxlatexenvshadowbox.sty}
 
 
 %% NOTICES AND ADMONITIONS
 %
-% Some are quite plain
-% the spx@notice@bordercolor etc are set in the sphinxadmonition environment
-\newenvironment{sphinxlightbox}{%
-  \par
-  \noindent{\color{spx@notice@bordercolor}%
-            \rule{\linewidth}{\spx@notice@border}}\par\nobreak
-  {\parskip\z@skip\noindent}%
-  }
-  {%
-  % counteract previous possible negative skip (French lists!):
-  % (we can't cancel that any earlier \vskip introduced a potential pagebreak)
-  \sphinxvspacefixafterfrenchlists
-  \nobreak\vbox{\noindent\kern\@totalleftmargin
-      {\color{spx@notice@bordercolor}%
-       \rule[\dimexpr.4\baselineskip-\spx@notice@border\relax]
-             {\linewidth}{\spx@notice@border}}\hss}\allowbreak
-  }% end of sphinxlightbox environment definition
-% may be renewenvironment'd by user for complete customization
-\newenvironment{sphinxnote}[1]
-  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
-\newenvironment{sphinxhint}[1]
-  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
-\newenvironment{sphinximportant}[1]
-  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
-\newenvironment{sphinxtip}[1]
-  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
-% or just use the package options
-% these are needed for common handling by notice environment of lightbox
-% and heavybox but they are  currently not used by lightbox environment
-% and there is consequently no corresponding package option
-\definecolor{sphinxnoteBgColor}{rgb}{1,1,1}
-\definecolor{sphinxhintBgColor}{rgb}{1,1,1}
-\definecolor{sphinximportantBgColor}{rgb}{1,1,1}
-\definecolor{sphinxtipBgColor}{rgb}{1,1,1}
-
-% Others get more distinction
-% Code adapted from framed.sty's "snugshade" environment.
-% Nesting works (inner frames do not allow page breaks).
-\newenvironment{sphinxheavybox}{\par
-   \setlength{\FrameRule}{\spx@notice@border}%
-   \setlength{\FrameSep}{\dimexpr.6\baselineskip-\FrameRule\relax}
-   \advance\spx@image@maxheight
-   -\dimexpr2\FrameRule
-           +2\FrameSep
-           +\baselineskip\relax % will happen again if nested, needed indeed!
-   % configure framed.sty's parameters to obtain same vertical spacing
-   % as for "light" boxes. We need for this to manually insert parskip glue and
-   % revert a skip done by framed before the frame.
-    \ltx@ifundefined{OuterFrameSep}{}{\OuterFrameSep\z@skip}%
-    \vspace{\FrameHeightAdjust}
-   % copied/adapted from framed.sty's snugshade
-   \def\FrameCommand##1{\hskip\@totalleftmargin
-       \fboxsep\FrameSep \fboxrule\FrameRule
-       \fcolorbox{spx@notice@bordercolor}{spx@notice@bgcolor}{##1}%
-       \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth}%
-   \savenotes
-   % use a minipage if we are already inside a framed environment
-   \ifspx@inframed
-       \noindent\begin{minipage}{\linewidth}
-   \else
-       % handle case where notice is first thing in a list item (or is quoted)
-       \if@inlabel
-        \noindent\par\vspace{-\baselineskip}
-       \else
-        \vspace{\parskip}
-       \fi
-   \fi
-   \MakeFramed {\spx@inframedtrue
-     \advance\hsize-\width \@totalleftmargin\z@ \linewidth\hsize
-     % minipage initialization copied from LaTeX source code.
-     \@pboxswfalse
-     \let\@listdepth\@mplistdepth \@mplistdepth\z@
-     \@minipagerestore
-     \@setminipage }%
-   }
-   {%
-   \par\unskip
-   \@minipagefalse
-   \endMakeFramed
-   \ifspx@inframed\end{minipage}\fi
-   % set footnotes at bottom of page
-   \spewnotes
-   % arrange for similar spacing below frame as for "light" boxes.
-   \vskip .4\baselineskip
-   }% end of sphinxheavybox environment definition
-% may be renewenvironment'd by user for complete customization
-\newenvironment{sphinxwarning}[1]
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
-\newenvironment{sphinxcaution}[1]
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
-\newenvironment{sphinxattention}[1]
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
-\newenvironment{sphinxdanger}[1]
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
-\newenvironment{sphinxerror}[1]
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
-% or just use package options
-
-% the \colorlet of xcolor (if at all loaded) is overkill for our use case
-\newcommand{\sphinxcolorlet}[2]
-    {\expandafter\let\csname\@backslashchar color@#1\expandafter\endcsname
-                     \csname\@backslashchar color@#2\endcsname }
-
-% the main dispatch for all types of notices
-\newenvironment{sphinxadmonition}[2]{% #1=type, #2=heading
-  % can't use #1 directly in definition of end part
-  \def\spx@noticetype {#1}%
-  % set parameters of heavybox/lightbox
-  \sphinxcolorlet{spx@notice@bordercolor}{sphinx#1BorderColor}%
-  \sphinxcolorlet{spx@notice@bgcolor}{sphinx#1BgColor}%
-  \spx@notice@border \dimexpr\csname spx@opt@#1border\endcsname\relax
-  % start specific environment, passing the heading as argument
-  \begin{sphinx#1}{#2}}
-  % workaround some LaTeX "feature" of \end command
- {\edef\spx@temp{\noexpand\end{sphinx\spx@noticetype}}\spx@temp}
+\input{sphinxlatexenvadmonitions.sty}
 
 
 %% PYTHON DOCS MACROS AND ENVIRONMENTS
-%  (some macros here used by \maketitle in sphinxmanual.cls and sphinxhowto.cls)
-
-% \moduleauthor{name}{email}
-\newcommand{\moduleauthor}[2]{}
-
-% \sectionauthor{name}{email}
-\newcommand{\sectionauthor}[2]{}
-
-% Allow the release number to be specified independently of the
-% \date{}.  This allows the date to reflect the document's date and
-% release to specify the release that is documented.
 %
-\newcommand{\py@release}{\releasename\space\version}
-\newcommand{\version}{}% part of \py@release, used by title page and headers
-% \releaseinfo is used on titlepage (sphinxmanual.cls, sphinxhowto.cls)
-\newcommand{\releaseinfo}{}
-\newcommand{\setreleaseinfo}[1]{\renewcommand{\releaseinfo}{#1}}
-% this is inserted via template and #1=release config variable
-\newcommand{\release}[1]{\renewcommand{\version}{#1}}
-% this is defined by template to 'releasename' latex_elements key
-\newcommand{\releasename}{}
-% Fix issue in case release and releasename deliberately left blank
-\newcommand{\sphinxheadercomma}{, }% used in fancyhdr header definition
-\newcommand{\sphinxifemptyorblank}[1]{%
-% test after one expansion of macro #1 if contents is empty or spaces
-     \if&\expandafter\@firstofone\detokenize\expandafter{#1}&%
-     \expandafter\@firstoftwo\else\expandafter\@secondoftwo\fi}%
-\AtBeginDocument {%
-   \sphinxifemptyorblank{\releasename}
-     {\sphinxifemptyorblank{\version}{\let\sphinxheadercomma\empty}{}}
-     {}%
-}%
+\input{sphinxlatexenvdocs.sty}
 
-% Allow specification of the author's address separately from the
-% author's name.  This can be used to format them differently, which
-% is a good thing.
-%
-\newcommand{\py@authoraddress}{}
-\newcommand{\authoraddress}[1]{\renewcommand{\py@authoraddress}{#1}}
-
-% {fulllineitems} is the main environment for object descriptions.
-%
-\newcommand{\py@itemnewline}[1]{%
-  \kern\labelsep
-  \@tempdima\linewidth
-  \advance\@tempdima \labelwidth\makebox[\@tempdima][l]{#1}%
-  \kern-\labelsep
-}
-
-\newenvironment{fulllineitems}{%
-  \begin{list}{}{\labelwidth \leftmargin
-                 \rightmargin \z@ \topsep -\parskip \partopsep \parskip
-                 \itemsep -\parsep
-                 \let\makelabel=\py@itemnewline}%
-}{\end{list}}
-
-% Signatures, possibly multi-line
-%
-\newlength{\py@argswidth}
-\newcommand{\py@sigparams}[2]{%
-  \parbox[t]{\py@argswidth}{#1\sphinxcode{)}#2}}
-\newcommand{\pysigline}[1]{\item[{#1}]}
-\newcommand{\pysiglinewithargsret}[3]{%
-  \settowidth{\py@argswidth}{#1\sphinxcode{(}}%
-  \addtolength{\py@argswidth}{-2\py@argswidth}%
-  \addtolength{\py@argswidth}{\linewidth}%
-  \item[{#1\sphinxcode{(}\py@sigparams{#2}{#3}}]}
-\newcommand{\pysigstartmultiline}{%
- \def\pysigstartmultiline{\vskip\smallskipamount\parskip\z@skip\itemsep\z@skip}%
- \edef\pysigstopmultiline
-     {\noexpand\leavevmode\parskip\the\parskip\relax\itemsep\the\itemsep\relax}%
- \parskip\z@skip\itemsep\z@skip
-}
-
-% Production lists
-%
-\newenvironment{productionlist}{%
-%  \def\sphinxoptional##1{{\Large[}##1{\Large]}}
-  \def\production##1##2{\\\sphinxcode{\sphinxupquote{##1}}&::=&\sphinxcode{\sphinxupquote{##2}}}%
-  \def\productioncont##1{\\& &\sphinxcode{\sphinxupquote{##1}}}%
-  \parindent=2em
-  \indent
-  \setlength{\LTpre}{0pt}%
-  \setlength{\LTpost}{0pt}%
-  \begin{longtable}[l]{lcl}
-}{%
-  \end{longtable}
-}
-
-% Definition lists; requested by AMK for HOWTO documents.  Probably useful
-% elsewhere as well, so keep in in the general style support.
-%
-\newenvironment{definitions}{%
-  \begin{description}%
-  \def\term##1{\item[{##1}]\mbox{}\\*[0mm]}%
-}{%
-  \end{description}%
-}
-
-%% FROM DOCTUTILS LATEX WRITER
-%
-% The following is stuff copied from docutils' latex writer.
-%
-\newcommand{\optionlistlabel}[1]{\normalfont\bfseries #1 \hfill}% \bf deprecated
-\newenvironment{optionlist}[1]
-{\begin{list}{}
-  {\setlength{\labelwidth}{#1}
-   \setlength{\rightmargin}{1cm}
-   \setlength{\leftmargin}{\rightmargin}
-   \addtolength{\leftmargin}{\labelwidth}
-   \addtolength{\leftmargin}{\labelsep}
-   \renewcommand{\makelabel}{\optionlistlabel}}
-}{\end{list}}
-
-\newlength{\lineblockindentation}
-\setlength{\lineblockindentation}{2.5em}
-\newenvironment{lineblock}[1]
-{\begin{list}{}
-  {\setlength{\partopsep}{\parskip}
-   \addtolength{\partopsep}{\baselineskip}
-   \topsep0pt\itemsep0.15\baselineskip\parsep0pt
-   \leftmargin#1\relax}
- \raggedright}
-{\end{list}}
-
-% From docutils.writers.latex2e
-% inline markup (custom roles)
-% \DUrole{#1}{#2} tries \DUrole#1{#2}
-\providecommand*{\DUrole}[2]{%
-  \ifcsname DUrole\detokenize{#1}\endcsname
-    \csname DUrole\detokenize{#1}\endcsname{#2}%
-  \else% backwards compatibility: try \docutilsrole#1{#2}
-    \ifcsname docutilsrole\detokenize{#1}\endcsname
-      \csname docutilsrole\detokenize{#1}\endcsname{#2}%
-    \else
-      #2%
-    \fi
-  \fi
-}
-
-\providecommand*{\DUprovidelength}[2]{%
-  \ifdefined#1\else\newlength{#1}\setlength{#1}{#2}\fi
-}
-
-\DUprovidelength{\DUlineblockindent}{2.5em}
-\ifdefined\DUlineblock\else
-  \newenvironment{DUlineblock}[1]{%
-    \list{}{\setlength{\partopsep}{\parskip}
-            \addtolength{\partopsep}{\baselineskip}
-            \setlength{\topsep}{0pt}
-            \setlength{\itemsep}{0.15\baselineskip}
-            \setlength{\parsep}{0pt}
-            \setlength{\leftmargin}{#1}}
-    \raggedright
-  }
-  {\endlist}
-\fi
 
 %% TEXT STYLING
 %
-% to obtain straight quotes we execute \@noligs as patched by upquote, and
-% \scantokens is needed in cases where it would be too late for the macro to
-% first set catcodes and then fetch its argument. We also make the contents
-% breakable at non-escaped . , ; ? ! / using \sphinxbreaksviaactive,
-% and also at \ character (which is escaped to \textbackslash{}).
-\protected\def\sphinxtextbackslashbreakbefore
- {\discretionary{}{\sphinxafterbreak\sphinx@textbackslash}{\sphinx@textbackslash}}
-\protected\def\sphinxtextbackslashbreakafter
- {\discretionary{\sphinx@textbackslash}{\sphinxafterbreak}{\sphinx@textbackslash}}
-\let\sphinxtextbackslash\sphinxtextbackslashbreakafter
-% the macro must be protected if it ends up used in moving arguments,
-% in 'alltt' \@noligs is done already, and the \scantokens must be avoided.
-\protected\def\sphinxupquote#1{{\def\@tempa{alltt}%
-  \ifx\@tempa\@currenvir\else
-   \ifspx@opt@inlineliteralwraps
-      % break at . , ; ? ! /
-      \sphinxbreaksviaactive
-      % break also at \
-      \let\sphinx@textbackslash\textbackslash
-      \let\textbackslash\sphinxtextbackslash
-      % by default, no continuation symbol on next line but may be added
-      \let\sphinxafterbreak\sphinxafterbreakofinlineliteral
-      % do not overwrite the comma set-up
-      \let\verbatim@nolig@list\sphinx@literal@nolig@list
-   \fi
-   % fix a space-gobbling issue due to LaTeX's original \do@noligs
-% TODO: using \@noligs as patched by upquote.sty is now unneeded because
-% either ` and ' are escaped (non-unicode engines) or they don't build
-% ligatures (unicode engines). Thus remove this and unify handling of `, <, >,
-% ' and - with the characters . , ; ? ! / as handled via
-% \sphinxbreaksviaactive.
-% Hence \sphinx@do@noligs will be removed, or rather replaced  with code
-% inserting discretionaries, as they allow a continuation symbol on start of
-% next line to achieve common design with code-blocks.
-   \let\do@noligs\sphinx@do@noligs
-   \@noligs\endlinechar\m@ne\everyeof{}% (<- in case inside \sphinxhref)
-   \expandafter\scantokens
-  \fi {{#1}}}}% extra brace pair to fix end-space gobbling issue...
-\def\sphinx@do@noligs #1{\catcode`#1\active\begingroup\lccode`\~`#1\relax
-    \lowercase{\endgroup\def~{\leavevmode\kern\z@\char`#1 }}}
-\def\sphinx@literal@nolig@list {\do\`\do\<\do\>\do\'\do\-}%
-\let\sphinxafterbreakofinlineliteral\empty
+\input{sphinxlatexstyletext.sty}
 
-% Some custom font markup commands.
-\protected\def\sphinxstrong#1{\textbf{#1}}
-\protected\def\sphinxcode#1{\texttt{#1}}
-\protected\def\sphinxbfcode#1{\textbf{\sphinxcode{#1}}}
-\protected\def\sphinxemail#1{\textsf{#1}}
-\protected\def\sphinxtablecontinued#1{\textsf{#1}}
-\protected\def\sphinxtitleref#1{\emph{#1}}
-\protected\def\sphinxmenuselection#1{\emph{#1}}
-\protected\def\sphinxguilabel#1{\emph{#1}}
-\protected\def\sphinxkeyboard#1{\sphinxcode{#1}}
-\protected\def\sphinxaccelerator#1{\underline{#1}}
-\protected\def\sphinxcrossref#1{\emph{#1}}
-\protected\def\sphinxtermref#1{\emph{#1}}
-% \optional is used for ``[, arg]``, i.e. desc_optional nodes.
-\long\protected\def\sphinxoptional#1{%
-  {\textnormal{\Large[}}{#1}\hspace{0.5mm}{\textnormal{\Large]}}}
-
-% additional customizable styling
-\def\sphinxstyleindexentry   #1{\texttt{#1}}
-\def\sphinxstyleindexextra   #1{ (\emph{#1})}
-\def\sphinxstyleindexpageref #1{, \pageref{#1}}
-\def\sphinxstyleindexpagemain#1{\textbf{#1}}
-\protected\def\spxentry#1{#1}% will get \let to \sphinxstyleindexentry in index
-\protected\def\spxextra#1{#1}% will get \let to \sphinxstyleindexextra in index
-\def\sphinxstyleindexlettergroup #1%
-    {{\Large\sffamily#1}\nopagebreak\vspace{1mm}}
-\def\sphinxstyleindexlettergroupDefault #1%
-    {{\Large\sffamily\sphinxnonalphabeticalgroupname}\nopagebreak\vspace{1mm}}
-\protected\def\sphinxstyletopictitle   #1{\textbf{#1}\par\medskip}
-\let\sphinxstylesidebartitle\sphinxstyletopictitle
-\protected\def\sphinxstyleothertitle   #1{\textbf{#1}}
-\protected\def\sphinxstylesidebarsubtitle #1{~\\\textbf{#1} \smallskip}
-% \text.. commands do not allow multiple paragraphs
-\protected\def\sphinxstyletheadfamily    {\sffamily}
-\protected\def\sphinxstyleemphasis     #1{\emph{#1}}
-\protected\def\sphinxstyleliteralemphasis#1{\emph{\sphinxcode{#1}}}
-\protected\def\sphinxstylestrong       #1{\textbf{#1}}
-\protected\def\sphinxstyleliteralstrong#1{\sphinxbfcode{#1}}
-\protected\def\sphinxstyleabbreviation #1{\textsc{#1}}
-\protected\def\sphinxstyleliteralintitle#1{\sphinxcode{#1}}
-\newcommand*\sphinxstylecodecontinued[1]{\footnotesize(#1)}%
-\newcommand*\sphinxstylecodecontinues[1]{\footnotesize(#1)}%
-% figure legend comes after caption and may contain arbitrary body elements
-\newenvironment{sphinxlegend}{\par\small}{\par}
-% reduce hyperref "Token not allowed in a PDF string" warnings on PDF builds
-\AtBeginDocument{\pdfstringdefDisableCommands{%
-% all "protected" macros possibly ending up in section titles should be here
-% TODO: examine if \sphinxhref, \sphinxurl, \sphinnolinkurl should be handled
-    \let\sphinxstyleemphasis        \@firstofone
-    \let\sphinxstyleliteralemphasis \@firstofone
-    \let\sphinxstylestrong          \@firstofone
-    \let\sphinxstyleliteralstrong   \@firstofone
-    \let\sphinxstyleabbreviation    \@firstofone
-    \let\sphinxstyleliteralintitle  \@firstofone
-    \let\sphinxupquote  \@firstofone
-    \let\sphinxstrong   \@firstofone
-    \let\sphinxcode     \@firstofone
-    \let\sphinxbfcode   \@firstofone
-    \let\sphinxemail    \@firstofone
-    \let\sphinxcrossref \@firstofone
-    \let\sphinxtermref  \@firstofone
-    \let\sphinxhyphen\sphinxhyphenforbookmarks
-}}
-
-% Special characters
-%
-% This definition prevents en-dash and em-dash TeX ligatures.
-%
-% It inserts a potential breakpoint after the hyphen. This is to keep in sync
-% with behavior in code-blocks, parsed and inline literals. For a breakpoint
-% before the hyphen use \leavevmode\kern\z@- (within \makeatletter/\makeatother)
-\protected\def\sphinxhyphen#1{-\kern\z@}
-% The {} from texescape mark-up is kept, else -- gives en-dash in PDF bookmark
-\def\sphinxhyphenforbookmarks{-}
-
-% For curly braces inside \index macro
-\def\sphinxleftcurlybrace{\{}
-\def\sphinxrightcurlybrace{\}}
-
-% Declare Unicode characters used by linux tree command to pdflatex utf8/utf8x
-\def\spx@bd#1#2{%
-  \leavevmode
-  \begingroup
-  \ifx\spx@bd@height   \@undefined\def\spx@bd@height{\baselineskip}\fi
-  \ifx\spx@bd@width    \@undefined\setbox0\hbox{0}\def\spx@bd@width{\wd0 }\fi
-  \ifx\spx@bd@thickness\@undefined\def\spx@bd@thickness{.6\p@}\fi
-  \ifx\spx@bd@lower    \@undefined\def\spx@bd@lower{\dp\strutbox}\fi
-  \lower\spx@bd@lower#1{#2}%
-  \endgroup
-}%
-\@namedef{sphinx@u2500}% BOX DRAWINGS LIGHT HORIZONTAL
-  {\spx@bd{\vbox to\spx@bd@height}
-          {\vss\hrule\@height\spx@bd@thickness
-                     \@width\spx@bd@width\vss}}%
-\@namedef{sphinx@u2502}% BOX DRAWINGS LIGHT VERTICAL
-  {\spx@bd{\hb@xt@\spx@bd@width}
-          {\hss\vrule\@height\spx@bd@height
-                     \@width \spx@bd@thickness\hss}}%
-\@namedef{sphinx@u2514}% BOX DRAWINGS LIGHT UP AND RIGHT
-  {\spx@bd{\hb@xt@\spx@bd@width}
-          {\hss\raise.5\spx@bd@height
-           \hb@xt@\z@{\hss\vrule\@height.5\spx@bd@height
-                                \@width \spx@bd@thickness\hss}%
-           \vbox to\spx@bd@height{\vss\hrule\@height\spx@bd@thickness
-                                            \@width.5\spx@bd@width\vss}}}%
-\@namedef{sphinx@u251C}% BOX DRAWINGS LIGHT VERTICAL AND RIGHT
-  {\spx@bd{\hb@xt@\spx@bd@width}
-          {\hss
-           \hb@xt@\z@{\hss\vrule\@height\spx@bd@height
-                                \@width \spx@bd@thickness\hss}%
-           \vbox to\spx@bd@height{\vss\hrule\@height\spx@bd@thickness
-                                            \@width.5\spx@bd@width\vss}}}%
-\protected\def\sphinxunichar#1{\@nameuse{sphinx@u#1}}%
 
-% Tell TeX about pathological hyphenation cases:
-\hyphenation{Base-HTTP-Re-quest-Hand-ler}
 \endinput
diff --git a/sphinx/texinputs/sphinxlatexenvadmonitions.sty b/sphinx/texinputs/sphinxlatexenvadmonitions.sty
new file mode 100644
index 00000000000..c7d37bc2fdc
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexenvadmonitions.sty
@@ -0,0 +1,122 @@
+%% NOTICES AND ADMONITIONS
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexenvadmonitions}[2021/01/27 admonitions]
+
+% Some are quite plain
+% the spx@notice@bordercolor etc are set in the sphinxadmonition environment
+\newenvironment{sphinxlightbox}{%
+  \par
+  \noindent{\color{spx@notice@bordercolor}%
+            \rule{\linewidth}{\spx@notice@border}}\par\nobreak
+  {\parskip\z@skip\noindent}%
+  }
+  {%
+  % counteract previous possible negative skip (French lists!):
+  % (we can't cancel that any earlier \vskip introduced a potential pagebreak)
+  \sphinxvspacefixafterfrenchlists
+  \nobreak\vbox{\noindent\kern\@totalleftmargin
+      {\color{spx@notice@bordercolor}%
+       \rule[\dimexpr.4\baselineskip-\spx@notice@border\relax]
+             {\linewidth}{\spx@notice@border}}\hss}\allowbreak
+  }% end of sphinxlightbox environment definition
+% may be renewenvironment'd by user for complete customization
+\newenvironment{sphinxnote}[1]
+  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
+\newenvironment{sphinxhint}[1]
+  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
+\newenvironment{sphinximportant}[1]
+  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
+\newenvironment{sphinxtip}[1]
+  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
+% or just use the package options
+% these are needed for common handling by notice environment of lightbox
+% and heavybox but they are  currently not used by lightbox environment
+% and there is consequently no corresponding package option
+\definecolor{sphinxnoteBgColor}{rgb}{1,1,1}
+\definecolor{sphinxhintBgColor}{rgb}{1,1,1}
+\definecolor{sphinximportantBgColor}{rgb}{1,1,1}
+\definecolor{sphinxtipBgColor}{rgb}{1,1,1}
+
+% Others get more distinction
+% Code adapted from framed.sty's "snugshade" environment.
+% Nesting works (inner frames do not allow page breaks).
+\newenvironment{sphinxheavybox}{\par
+   \setlength{\FrameRule}{\spx@notice@border}%
+   \setlength{\FrameSep}{\dimexpr.6\baselineskip-\FrameRule\relax}
+   \advance\spx@image@maxheight
+   -\dimexpr2\FrameRule
+           +2\FrameSep
+           +\baselineskip\relax % will happen again if nested, needed indeed!
+   % configure framed.sty's parameters to obtain same vertical spacing
+   % as for "light" boxes. We need for this to manually insert parskip glue and
+   % revert a skip done by framed before the frame.
+    \ltx@ifundefined{OuterFrameSep}{}{\OuterFrameSep\z@skip}%
+    \vspace{\FrameHeightAdjust}
+   % copied/adapted from framed.sty's snugshade
+   \def\FrameCommand##1{\hskip\@totalleftmargin
+       \fboxsep\FrameSep \fboxrule\FrameRule
+       \fcolorbox{spx@notice@bordercolor}{spx@notice@bgcolor}{##1}%
+       \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth}%
+   \savenotes
+   % use a minipage if we are already inside a framed environment
+   \ifspx@inframed
+       \noindent\begin{minipage}{\linewidth}
+   \else
+       % handle case where notice is first thing in a list item (or is quoted)
+       \if@inlabel
+        \noindent\par\vspace{-\baselineskip}
+       \else
+        \vspace{\parskip}
+       \fi
+   \fi
+   \MakeFramed {\spx@inframedtrue
+     \advance\hsize-\width \@totalleftmargin\z@ \linewidth\hsize
+     % minipage initialization copied from LaTeX source code.
+     \@pboxswfalse
+     \let\@listdepth\@mplistdepth \@mplistdepth\z@
+     \@minipagerestore
+     \@setminipage }%
+   }
+   {%
+   \par\unskip
+   \@minipagefalse
+   \endMakeFramed
+   \ifspx@inframed\end{minipage}\fi
+   % set footnotes at bottom of page
+   \spewnotes
+   % arrange for similar spacing below frame as for "light" boxes.
+   \vskip .4\baselineskip
+   }% end of sphinxheavybox environment definition
+% may be renewenvironment'd by user for complete customization
+\newenvironment{sphinxwarning}[1]
+  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
+\newenvironment{sphinxcaution}[1]
+  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
+\newenvironment{sphinxattention}[1]
+  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
+\newenvironment{sphinxdanger}[1]
+  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
+\newenvironment{sphinxerror}[1]
+  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
+% or just use package options
+
+% the \colorlet of xcolor (if at all loaded) is overkill for our use case
+\newcommand{\sphinxcolorlet}[2]
+    {\expandafter\let\csname\@backslashchar color@#1\expandafter\endcsname
+                     \csname\@backslashchar color@#2\endcsname }
+
+% the main dispatch for all types of notices
+\newenvironment{sphinxadmonition}[2]{% #1=type, #2=heading
+  % can't use #1 directly in definition of end part
+  \def\spx@noticetype {#1}%
+  % set parameters of heavybox/lightbox
+  \sphinxcolorlet{spx@notice@bordercolor}{sphinx#1BorderColor}%
+  \sphinxcolorlet{spx@notice@bgcolor}{sphinx#1BgColor}%
+  \spx@notice@border \dimexpr\csname spx@opt@#1border\endcsname\relax
+  % start specific environment, passing the heading as argument
+  \begin{sphinx#1}{#2}}
+  % workaround some LaTeX "feature" of \end command
+ {\edef\spx@temp{\noexpand\end{sphinx\spx@noticetype}}\spx@temp}
+
+\endinput
\ No newline at end of file
diff --git a/sphinx/texinputs/sphinxlatexenvdocs.sty b/sphinx/texinputs/sphinxlatexenvdocs.sty
new file mode 100644
index 00000000000..a05d30f2711
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexenvdocs.sty
@@ -0,0 +1,164 @@
+%% PYTHON DOCS MACROS AND ENVIRONMENTS
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexenvdocs}[2021/01/27 documentation environments]
+
+%  (some macros here used by \maketitle in sphinxmanual.cls and sphinxhowto.cls)
+
+% \moduleauthor{name}{email}
+\newcommand{\moduleauthor}[2]{}
+
+% \sectionauthor{name}{email}
+\newcommand{\sectionauthor}[2]{}
+
+% Allow the release number to be specified independently of the
+% \date{}.  This allows the date to reflect the document's date and
+% release to specify the release that is documented.
+%
+\newcommand{\py@release}{\releasename\space\version}
+\newcommand{\version}{}% part of \py@release, used by title page and headers
+% \releaseinfo is used on titlepage (sphinxmanual.cls, sphinxhowto.cls)
+\newcommand{\releaseinfo}{}
+\newcommand{\setreleaseinfo}[1]{\renewcommand{\releaseinfo}{#1}}
+% this is inserted via template and #1=release config variable
+\newcommand{\release}[1]{\renewcommand{\version}{#1}}
+% this is defined by template to 'releasename' latex_elements key
+\newcommand{\releasename}{}
+% Fix issue in case release and releasename deliberately left blank
+\newcommand{\sphinxheadercomma}{, }% used in fancyhdr header definition
+\newcommand{\sphinxifemptyorblank}[1]{%
+% test after one expansion of macro #1 if contents is empty or spaces
+     \if&\expandafter\@firstofone\detokenize\expandafter{#1}&%
+     \expandafter\@firstoftwo\else\expandafter\@secondoftwo\fi}%
+\AtBeginDocument {%
+   \sphinxifemptyorblank{\releasename}
+     {\sphinxifemptyorblank{\version}{\let\sphinxheadercomma\empty}{}}
+     {}%
+}%
+
+% Allow specification of the author's address separately from the
+% author's name.  This can be used to format them differently, which
+% is a good thing.
+%
+\newcommand{\py@authoraddress}{}
+\newcommand{\authoraddress}[1]{\renewcommand{\py@authoraddress}{#1}}
+
+% {fulllineitems} is the main environment for object descriptions.
+%
+\newcommand{\py@itemnewline}[1]{%
+  \kern\labelsep
+  \@tempdima\linewidth
+  \advance\@tempdima \labelwidth\makebox[\@tempdima][l]{#1}%
+  \kern-\labelsep
+}
+
+\newenvironment{fulllineitems}{%
+  \begin{list}{}{\labelwidth \leftmargin
+                 \rightmargin \z@ \topsep -\parskip \partopsep \parskip
+                 \itemsep -\parsep
+                 \let\makelabel=\py@itemnewline}%
+}{\end{list}}
+
+% Signatures, possibly multi-line
+%
+\newlength{\py@argswidth}
+\newcommand{\py@sigparams}[2]{%
+  \parbox[t]{\py@argswidth}{#1\sphinxcode{)}#2}}
+\newcommand{\pysigline}[1]{\item[{#1}]}
+\newcommand{\pysiglinewithargsret}[3]{%
+  \settowidth{\py@argswidth}{#1\sphinxcode{(}}%
+  \addtolength{\py@argswidth}{-2\py@argswidth}%
+  \addtolength{\py@argswidth}{\linewidth}%
+  \item[{#1\sphinxcode{(}\py@sigparams{#2}{#3}}]}
+\newcommand{\pysigstartmultiline}{%
+ \def\pysigstartmultiline{\vskip\smallskipamount\parskip\z@skip\itemsep\z@skip}%
+ \edef\pysigstopmultiline
+     {\noexpand\leavevmode\parskip\the\parskip\relax\itemsep\the\itemsep\relax}%
+ \parskip\z@skip\itemsep\z@skip
+}
+
+% Production lists
+%
+\newenvironment{productionlist}{%
+%  \def\sphinxoptional##1{{\Large[}##1{\Large]}}
+  \def\production##1##2{\\\sphinxcode{\sphinxupquote{##1}}&::=&\sphinxcode{\sphinxupquote{##2}}}%
+  \def\productioncont##1{\\& &\sphinxcode{\sphinxupquote{##1}}}%
+  \parindent=2em
+  \indent
+  \setlength{\LTpre}{0pt}%
+  \setlength{\LTpost}{0pt}%
+  \begin{longtable}[l]{lcl}
+}{%
+  \end{longtable}
+}
+
+% Definition lists; requested by AMK for HOWTO documents.  Probably useful
+% elsewhere as well, so keep in in the general style support.
+%
+\newenvironment{definitions}{%
+  \begin{description}%
+  \def\term##1{\item[{##1}]\mbox{}\\*[0mm]}%
+}{%
+  \end{description}%
+}
+
+%% FROM DOCTUTILS LATEX WRITER
+%
+% The following is stuff copied from docutils' latex writer.
+%
+\newcommand{\optionlistlabel}[1]{\normalfont\bfseries #1 \hfill}% \bf deprecated
+\newenvironment{optionlist}[1]
+{\begin{list}{}
+  {\setlength{\labelwidth}{#1}
+   \setlength{\rightmargin}{1cm}
+   \setlength{\leftmargin}{\rightmargin}
+   \addtolength{\leftmargin}{\labelwidth}
+   \addtolength{\leftmargin}{\labelsep}
+   \renewcommand{\makelabel}{\optionlistlabel}}
+}{\end{list}}
+
+\newlength{\lineblockindentation}
+\setlength{\lineblockindentation}{2.5em}
+\newenvironment{lineblock}[1]
+{\begin{list}{}
+  {\setlength{\partopsep}{\parskip}
+   \addtolength{\partopsep}{\baselineskip}
+   \topsep0pt\itemsep0.15\baselineskip\parsep0pt
+   \leftmargin#1\relax}
+ \raggedright}
+{\end{list}}
+
+% From docutils.writers.latex2e
+% inline markup (custom roles)
+% \DUrole{#1}{#2} tries \DUrole#1{#2}
+\providecommand*{\DUrole}[2]{%
+  \ifcsname DUrole\detokenize{#1}\endcsname
+    \csname DUrole\detokenize{#1}\endcsname{#2}%
+  \else% backwards compatibility: try \docutilsrole#1{#2}
+    \ifcsname docutilsrole\detokenize{#1}\endcsname
+      \csname docutilsrole\detokenize{#1}\endcsname{#2}%
+    \else
+      #2%
+    \fi
+  \fi
+}
+
+\providecommand*{\DUprovidelength}[2]{%
+  \ifdefined#1\else\newlength{#1}\setlength{#1}{#2}\fi
+}
+
+\DUprovidelength{\DUlineblockindent}{2.5em}
+\ifdefined\DUlineblock\else
+  \newenvironment{DUlineblock}[1]{%
+    \list{}{\setlength{\partopsep}{\parskip}
+            \addtolength{\partopsep}{\baselineskip}
+            \setlength{\topsep}{0pt}
+            \setlength{\itemsep}{0.15\baselineskip}
+            \setlength{\parsep}{0pt}
+            \setlength{\leftmargin}{#1}}
+    \raggedright
+  }
+  {\endlist}
+\fi
+
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexenvindbibtoc.sty b/sphinx/texinputs/sphinxlatexenvindbibtoc.sty
new file mode 100644
index 00000000000..61ed66897d5
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexenvindbibtoc.sty
@@ -0,0 +1,47 @@
+%% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexenvindbibtoc}[2021/01/27 index, bib., toc]
+
+% fix the double index and bibliography on the table of contents
+% in jsclasses (Japanese standard document classes)
+\ifx\@jsc@uplatextrue\@undefined\else
+  \renewenvironment{sphinxtheindex}
+    {\cleardoublepage\phantomsection
+     \begin{theindex}}
+    {\end{theindex}}
+
+  \renewenvironment{sphinxthebibliography}[1]
+    {\cleardoublepage% \phantomsection % not needed here since TeXLive 2010's hyperref
+     \begin{thebibliography}{#1}}
+    {\end{thebibliography}}
+\fi
+
+% disable \@chappos in Appendix in pTeX
+\ifx\kanjiskip\@undefined\else
+  \let\py@OldAppendix=\appendix
+  \renewcommand{\appendix}{
+    \py@OldAppendix
+    \gdef\@chappos{}
+  }
+\fi
+
+% make commands known to non-Sphinx document classes
+\providecommand*{\sphinxmaketitle}{\maketitle}
+\providecommand*{\sphinxtableofcontents}{\tableofcontents}
+\ltx@ifundefined{sphinxthebibliography}
+ {\newenvironment
+  {sphinxthebibliography}{\begin{thebibliography}}{\end{thebibliography}}%
+ }
+ {}% else clause of \ltx@ifundefined
+\ltx@ifundefined{sphinxtheindex}
+ {\newenvironment{sphinxtheindex}{\begin{theindex}}{\end{theindex}}}%
+ {}% else clause of \ltx@ifundefined
+
+% for usage with xindy: this string gets internationalized in preamble
+\newcommand*{\sphinxnonalphabeticalgroupname}{}
+% redefined in preamble, headings for makeindex produced index
+\newcommand*{\sphinxsymbolsname}{}
+\newcommand*{\sphinxnumbersname}{}
+
+\endinput
\ No newline at end of file
diff --git a/sphinx/texinputs/sphinxlatexenvliteral.sty b/sphinx/texinputs/sphinxlatexenvliteral.sty
new file mode 100644
index 00000000000..8f5533c0d9f
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexenvliteral.sty
@@ -0,0 +1,480 @@
+%% LITERAL BLOCKS
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexenvliteral}[2021/01/27 code-blocks and parsed literals]
+
+% Based on use of "fancyvrb.sty"'s Verbatim.
+% - with framing allowing page breaks ("framed.sty")
+% - with breaking of long lines (exploits Pygments mark-up),
+% - with possibly of a top caption, non-separable by pagebreak.
+% - and usable inside tables or footnotes ("footnotehyper-sphinx").
+
+% Prior to Sphinx 1.5, \Verbatim and \endVerbatim were modified by Sphinx.
+% The aliases defined here are used in sphinxVerbatim environment and can
+% serve as hook-points with no need to modify \Verbatim itself.
+\let\OriginalVerbatim   \Verbatim
+\let\endOriginalVerbatim\endVerbatim
+
+% for captions of literal blocks
+% at start of caption title
+\newcommand*{\fnum@literalblock}{\literalblockname\nobreakspace\theliteralblock}
+% this will be overwritten in document preamble by Babel translation
+\newcommand*{\literalblockname}{Listing }
+% file extension needed for \caption's good functioning, the file is created
+% only if a \listof{literalblock}{foo} command is encountered, which is
+% analogous to \listoffigures, but for the code listings (foo = chosen title.)
+\newcommand*{\ext@literalblock}{lol}
+
+\newif\ifspx@inframed % flag set if we are already in a framed environment
+% if forced use of minipage encapsulation is needed (e.g. table cells)
+\newif\ifsphinxverbatimwithminipage   \sphinxverbatimwithminipagefalse
+
+% Framing macro for use with framed.sty's \FrameCommand
+%  - it obeys current indentation,
+%  - frame is \fboxsep separated from the contents,
+%  - the contents use the full available text width,
+%  - #1 = color of frame, #2 = color of background,
+%  - #3 = above frame, #4 = below frame, #5 = within frame,
+%  - #3 and #4 must be already typeset boxes; they must issue \normalcolor
+%    or similar, else, they are under scope of color #1
+\long\def\spx@fcolorbox #1#2#3#4#5{%
+  \hskip\@totalleftmargin
+  \hskip-\fboxsep\hskip-\fboxrule
+  % use of \color@b@x here is compatible with both xcolor.sty and color.sty
+  \color@b@x {\color{#1}\spx@CustomFBox{#3}{#4}}{\color{#2}}{#5}%
+  \hskip-\fboxsep\hskip-\fboxrule
+  \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth
+}%
+% #1 = for material above frame, such as a caption or a "continued" hint
+% #2 = for material below frame, such as a caption or "continues on next page"
+% #3 = actual contents, which will be typeset with a background color
+\long\def\spx@CustomFBox#1#2#3{%
+  \begingroup
+  \setbox\@tempboxa\hbox{{#3}}% inner braces to avoid color leaks
+  \vbox{#1% above frame
+            % draw frame border _latest_ to avoid pdf viewer issue
+            \kern\fboxrule
+            \hbox{\kern\fboxrule
+                  \copy\@tempboxa
+                  \kern-\wd\@tempboxa\kern-\fboxrule
+                  \vrule\@width\fboxrule
+                  \kern\wd\@tempboxa
+                  \vrule\@width\fboxrule}%
+            \kern-\dimexpr\ht\@tempboxa+\dp\@tempboxa+\fboxrule\relax
+            \hrule\@height\fboxrule
+            \kern\dimexpr\ht\@tempboxa+\dp\@tempboxa\relax
+            \hrule\@height\fboxrule
+        #2% below frame
+       }%
+  \endgroup
+}%
+\def\spx@fcolorbox@put@c#1{% hide width from framed.sty measuring
+    \moveright\dimexpr\fboxrule+.5\wd\@tempboxa\hb@xt@\z@{\hss#1\hss}%
+}%
+\def\spx@fcolorbox@put@r#1{% right align with contents, width hidden
+    \moveright\dimexpr\fboxrule+\wd\@tempboxa-\fboxsep\hb@xt@\z@{\hss#1}%
+}%
+\def\spx@fcolorbox@put@l#1{% left align with contents, width hidden
+    \moveright\dimexpr\fboxrule+\fboxsep\hb@xt@\z@{#1\hss}%
+}%
+%
+\def\sphinxVerbatim@Continued
+   {\csname spx@fcolorbox@put@\spx@opt@verbatimcontinuedalign\endcsname
+    {\normalcolor\sphinxstylecodecontinued\literalblockcontinuedname}}%
+\def\sphinxVerbatim@Continues
+   {\csname spx@fcolorbox@put@\spx@opt@verbatimcontinuesalign\endcsname
+    {\normalcolor\sphinxstylecodecontinues\literalblockcontinuesname}}%
+\def\sphinxVerbatim@Title
+   {\spx@fcolorbox@put@c{\unhcopy\sphinxVerbatim@TitleBox}}%
+\let\sphinxVerbatim@Before\@empty
+\let\sphinxVerbatim@After\@empty
+% Defaults are redefined in document preamble according to language
+\newcommand*\literalblockcontinuedname{continued from previous page}%
+\newcommand*\literalblockcontinuesname{continues on next page}%
+%
+\def\spx@verbatimfcolorbox{\spx@fcolorbox{VerbatimBorderColor}{VerbatimColor}}%
+\def\sphinxVerbatim@FrameCommand
+   {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@After}%
+\def\sphinxVerbatim@FirstFrameCommand
+   {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@Continues}%
+\def\sphinxVerbatim@MidFrameCommand
+   {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@Continues}%
+\def\sphinxVerbatim@LastFrameCommand
+   {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@After}%
+
+% For linebreaks inside Verbatim environment from package fancyvrb.
+\newbox\sphinxcontinuationbox
+\newbox\sphinxvisiblespacebox
+\newcommand*\sphinxafterbreak {\copy\sphinxcontinuationbox}
+
+% Take advantage of the already applied Pygments mark-up to insert
+% potential linebreaks for TeX processing.
+%        {, <, #, %, $, ' and ": go to next line.
+%        _, }, ^, &, >, -, ~, and \: stay at end of broken line.
+% Use of \textquotesingle for straight quote.
+% FIXME: convert this to package options ?
+\newcommand*\sphinxbreaksbeforelist {%
+    \do\PYGZob\{\do\PYGZlt\<\do\PYGZsh\#\do\PYGZpc\%% {, <, #, %,
+    \do\PYGZdl\$\do\PYGZdq\"% $, "
+    \def\PYGZsq
+     {\discretionary{}{\sphinxafterbreak\textquotesingle}{\textquotesingle}}% '
+}
+\newcommand*\sphinxbreaksafterlist {%
+    \do\PYGZus\_\do\PYGZcb\}\do\PYGZca\^\do\PYGZam\&% _, }, ^, &,
+    \do\PYGZgt\>\do\PYGZhy\-\do\PYGZti\~% >, -, ~
+    \do\PYGZbs\\% \
+}
+\newcommand*\sphinxbreaksatspecials {%
+  \def\do##1##2%
+     {\def##1{\discretionary{}{\sphinxafterbreak\char`##2}{\char`##2}}}%
+  \sphinxbreaksbeforelist
+  \def\do##1##2%
+     {\def##1{\discretionary{\char`##2}{\sphinxafterbreak}{\char`##2}}}%
+  \sphinxbreaksafterlist
+}
+
+\def\sphinx@verbatim@nolig@list {\do \`}%
+% Some characters . , ; ? ! / are neither pygmentized nor "tex-escaped".
+% This macro makes them "active" and they will insert potential linebreaks.
+% Not compatible with math mode (cf \sphinxunactivateextras).
+\newcommand*\sphinxbreaksbeforeactivelist {}% none
+\newcommand*\sphinxbreaksafteractivelist  {\do\.\do\,\do\;\do\?\do\!\do\/}
+\newcommand*\sphinxbreaksviaactive {%
+   \def\do##1{\lccode`\~`##1%
+    \lowercase{\def~}{\discretionary{}{\sphinxafterbreak\char`##1}{\char`##1}}%
+    \catcode`##1\active}%
+   \sphinxbreaksbeforeactivelist
+   \def\do##1{\lccode`\~`##1%
+    \lowercase{\def~}{\discretionary{\char`##1}{\sphinxafterbreak}{\char`##1}}%
+    \catcode`##1\active}%
+   \sphinxbreaksafteractivelist
+   \lccode`\~`\~
+}
+
+% If the linebreak is at a space, the latter will be displayed as visible
+% space at end of first line, and a continuation symbol starts next line.
+\def\spx@verbatim@space {%
+     \nobreak\hskip\z@skip
+     \discretionary{\copy\sphinxvisiblespacebox}{\sphinxafterbreak}
+                   {\kern\fontdimen2\font}%
+}%
+
+% if the available space on page is less than \literalblockneedspace, insert pagebreak
+\newcommand{\sphinxliteralblockneedspace}{5\baselineskip}
+\newcommand{\sphinxliteralblockwithoutcaptionneedspace}{1.5\baselineskip}
+% The title (caption) is specified from outside as macro \sphinxVerbatimTitle.
+% \sphinxVerbatimTitle is reset to empty after each use of Verbatim.
+\newcommand*\sphinxVerbatimTitle {}
+% This box to typeset the caption before framed.sty multiple passes for framing.
+\newbox\sphinxVerbatim@TitleBox
+% This box to measure contents if nested as inner \MakeFramed requires then
+% minipage encapsulation but too long contents then break outer \MakeFramed
+\newbox\sphinxVerbatim@ContentsBox
+% This is a workaround to a "feature" of French lists, when literal block
+% follows immediately; usable generally (does only \par then), a priori...
+\newcommand*\sphinxvspacefixafterfrenchlists{%
+   \ifvmode\ifdim\lastskip<\z@ \vskip\parskip\fi\else\par\fi
+}
+% Holder macro for labels of literal blocks. Set-up by LaTeX writer.
+\newcommand*\sphinxLiteralBlockLabel {}
+\newcommand*\sphinxSetupCaptionForVerbatim [1]
+{%
+    \sphinxvspacefixafterfrenchlists
+    \needspace{\sphinxliteralblockneedspace}%
+% insert a \label via \sphinxLiteralBlockLabel
+% reset to normal the color for the literal block caption
+    \def\sphinxVerbatimTitle
+       {\py@NormalColor\sphinxcaption{\sphinxLiteralBlockLabel #1}}%
+}
+\newcommand*\sphinxSetupCodeBlockInFootnote {%
+  \fvset{fontsize=\footnotesize}\let\caption\sphinxfigcaption
+  \sphinxverbatimwithminipagetrue % reduces vertical spaces
+  % we counteract (this is in a group) the \@normalsize from \caption
+  \let\normalsize\footnotesize\let\@parboxrestore\relax
+  \def\spx@abovecaptionskip{\sphinxverbatimsmallskipamount}%
+}
+\newcommand*{\sphinxverbatimsmallskipamount}{\smallskipamount}
+% serves to implement line highlighting and line wrapping
+\newcommand\sphinxFancyVerbFormatLine[1]{%
+  \expandafter\sphinx@verbatim@checkifhl\expandafter{\the\FV@CodeLineNo}%
+  \ifin@
+     \sphinxVerbatimHighlightLine{#1}%
+  \else
+     \sphinxVerbatimFormatLine{#1}%
+  \fi
+}%
+\newcommand\sphinxVerbatimHighlightLine[1]{%
+  \edef\sphinxrestorefboxsep{\fboxsep\the\fboxsep\relax}%
+  \fboxsep0pt\relax % cf LaTeX bug graphics/4524
+  \colorbox{sphinxVerbatimHighlightColor}%
+           {\sphinxrestorefboxsep\sphinxVerbatimFormatLine{#1}}%
+  % no need to restore \fboxsep here, as this ends up in a \hbox from fancyvrb
+}%
+% \sphinxVerbatimFormatLine will be set locally to one of those two:
+\newcommand\sphinxVerbatimFormatLineWrap[1]{%
+    \hsize\linewidth
+    \vtop{\raggedright\hyphenpenalty\z@\exhyphenpenalty\z@
+          \doublehyphendemerits\z@\finalhyphendemerits\z@
+          \strut #1\strut}%
+}%
+\newcommand\sphinxVerbatimFormatLineNoWrap[1]{\hb@xt@\linewidth{\strut #1\hss}}%
+\g@addto@macro\FV@SetupFont{%
+    \sbox\sphinxcontinuationbox {\spx@opt@verbatimcontinued}%
+    \sbox\sphinxvisiblespacebox {\spx@opt@verbatimvisiblespace}%
+}%
+\newenvironment{sphinxVerbatim}{%
+  % first, let's check if there is a caption
+  \ifx\sphinxVerbatimTitle\empty
+      \sphinxvspacefixafterfrenchlists
+      \parskip\z@skip
+      \vskip\sphinxverbatimsmallskipamount
+      % there was no caption. Check if nevertheless a label was set.
+      \ifx\sphinxLiteralBlockLabel\empty\else
+      % we require some space to be sure hyperlink target from \phantomsection
+      % will not be separated from upcoming verbatim by a page break
+          \needspace{\sphinxliteralblockwithoutcaptionneedspace}%
+          \phantomsection\sphinxLiteralBlockLabel
+      \fi
+  \else
+     \parskip\z@skip
+     \if t\spx@opt@literalblockcappos
+       \vskip\spx@abovecaptionskip
+       \def\sphinxVerbatim@Before
+           {\sphinxVerbatim@Title\nointerlineskip
+            \kern\dimexpr-\dp\strutbox+\sphinxbelowcaptionspace
+                 % if no frame (code-blocks inside table cells), remove
+                 % the "verbatimsep" whitespace from the top (better visually)
+                 \ifspx@opt@verbatimwithframe\else-\sphinxverbatimsep\fi
+                 % caption package adds \abovecaptionskip vspace, remove it
+                 \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax}%
+     \else
+       \vskip\sphinxverbatimsmallskipamount
+       \def\sphinxVerbatim@After
+          {\nointerlineskip\kern\dimexpr\dp\strutbox
+            \ifspx@opt@verbatimwithframe\else-\sphinxverbatimsep\fi
+            \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax
+           \sphinxVerbatim@Title}%
+     \fi
+     \def\@captype{literalblock}%
+     \capstart
+     % \sphinxVerbatimTitle must reset color
+     \setbox\sphinxVerbatim@TitleBox
+            \hbox{\begin{minipage}{\linewidth}%
+     % caption package may detect wrongly if top or bottom, so we help it
+                    \spx@ifcaptionpackage
+                      {\caption@setposition{\spx@opt@literalblockcappos}}{}%
+                    \sphinxVerbatimTitle
+                  \end{minipage}}%
+  \fi
+  \global\let\sphinxLiteralBlockLabel\empty
+  \global\let\sphinxVerbatimTitle\empty
+  \fboxsep\sphinxverbatimsep \fboxrule\sphinxverbatimborder
+  \ifspx@opt@verbatimwithframe\else\fboxrule\z@\fi
+  \let\FrameCommand     \sphinxVerbatim@FrameCommand
+  \let\FirstFrameCommand\sphinxVerbatim@FirstFrameCommand
+  \let\MidFrameCommand  \sphinxVerbatim@MidFrameCommand
+  \let\LastFrameCommand \sphinxVerbatim@LastFrameCommand
+  \ifspx@opt@verbatimhintsturnover\else
+      \let\sphinxVerbatim@Continued\@empty
+      \let\sphinxVerbatim@Continues\@empty
+  \fi
+  \ifspx@opt@verbatimwrapslines
+  % fancyvrb's Verbatim puts each input line in (unbreakable) horizontal boxes.
+  % This customization wraps each line from the input in a \vtop, thus
+  % allowing it to wrap and display on two or more lines in the latex output.
+  %     - The codeline counter will be increased only once.
+  %     - The wrapped material will not break across pages, it is impossible
+  %       to achieve this without extensive rewrite of fancyvrb.
+  %     - The (not used in sphinx) obeytabs option to Verbatim is
+  %       broken by this change (showtabs and tabspace work).
+    \let\sphinxVerbatimFormatLine\sphinxVerbatimFormatLineWrap
+    \let\FV@Space\spx@verbatim@space
+  % Allow breaks at special characters using \PYG... macros.
+    \sphinxbreaksatspecials
+  % Breaks at punctuation characters . , ; ? ! and / (needs catcode activation)
+    \fvset{codes*=\sphinxbreaksviaactive}%
+  \else % end of conditional code for wrapping long code lines
+    \let\sphinxVerbatimFormatLine\sphinxVerbatimFormatLineNoWrap
+  \fi
+  \let\FancyVerbFormatLine\sphinxFancyVerbFormatLine
+  \VerbatimEnvironment
+  % workaround to fancyvrb's check of current list depth
+  \def\@toodeep {\advance\@listdepth\@ne}%
+  % The list environment is needed to control perfectly the vertical space.
+  % Note: \OuterFrameSep used by framed.sty is later set to \topsep hence 0pt.
+  % - if caption: distance from last text baseline to caption baseline is
+  %   A+(B-F)+\ht\strutbox, A = \abovecaptionskip (default 10pt), B =
+  %   \baselineskip, F is the framed.sty \FrameHeightAdjust macro, default 6pt.
+  %   Formula valid for F < 10pt.
+  % - distance of baseline of caption to top of frame is like for tables:
+  %   \sphinxbelowcaptionspace (=0.5\baselineskip)
+  % - if no caption: distance of last text baseline to code frame is S+(B-F),
+  %   with S = \sphinxverbatimtopskip (=\smallskip)
+  % - and distance from bottom of frame to next text baseline is
+  %   \baselineskip+\parskip.
+  % The \trivlist is used to avoid possible "too deeply nested" error.
+  \itemsep   \z@skip
+  \topsep    \z@skip
+  \partopsep \z@skip
+  % trivlist will set \parsep to \parskip (which itself is set to zero above)
+  % \leftmargin will be set to zero by trivlist
+  \rightmargin\z@
+  \parindent  \z@% becomes \itemindent. Default zero, but perhaps overwritten.
+  \trivlist\item\relax
+     \ifspx@inframed\setbox\sphinxVerbatim@ContentsBox\vbox\bgroup
+        \@setminipage\hsize\linewidth
+        % use bulk of minipage paragraph shape restores (this is needed
+        % in indented contexts, at least for some)
+        \textwidth\hsize \columnwidth\hsize \@totalleftmargin\z@
+        \leftskip\z@skip \rightskip\z@skip  \@rightskip\z@skip
+     \else
+       \ifsphinxverbatimwithminipage\noindent\begin{minipage}{\linewidth}\fi
+       \MakeFramed {% adapted over from framed.sty's snugshade environment
+        \advance\hsize-\width\@totalleftmargin\z@\linewidth\hsize\@setminipage
+        }%
+     \fi
+     % For grid placement from \strut's in \FancyVerbFormatLine
+     \lineskip\z@skip
+     % active comma should not be overwritten by \@noligs
+     \ifspx@opt@verbatimwrapslines
+       \let\verbatim@nolig@list \sphinx@verbatim@nolig@list
+     \fi
+     % will fetch its optional arguments if any
+     \OriginalVerbatim
+}
+{%
+  \endOriginalVerbatim
+  \ifspx@inframed
+   \egroup % finish \sphinxVerbatim@ContentsBox vbox
+   \nobreak % update page totals
+   \ifdim\dimexpr\ht\sphinxVerbatim@ContentsBox+
+         \dp\sphinxVerbatim@ContentsBox+
+         \ht\sphinxVerbatim@TitleBox+
+         \dp\sphinxVerbatim@TitleBox+
+         2\fboxsep+2\fboxrule+
+         % try to account for external frame parameters
+         \FrameSep+\FrameRule+
+         % Usage here of 2 baseline distances is empirical.
+         % In border case where code-block fits barely in remaining space,
+         % it gets framed and looks good but the outer frame may continue
+         % on top of next page and give (if no contents after code-block)
+         % an empty framed line, as testing showed.
+         2\baselineskip+
+         % now add all to accumulated page totals and compare to \pagegoal
+         \pagetotal+\pagedepth>\pagegoal
+    % long contents: do not \MakeFramed. Do make a caption (either before or
+    % after) if title exists. Continuation hints across pagebreaks dropped.
+    % FIXME? a bottom caption may end up isolated at top of next page
+    %        (no problem with a top caption, which is default)
+    \spx@opt@verbatimwithframefalse
+    \def\sphinxVerbatim@Title{\noindent\box\sphinxVerbatim@TitleBox\par}%
+    \sphinxVerbatim@Before
+    \noindent\unvbox\sphinxVerbatim@ContentsBox\par
+    \sphinxVerbatim@After
+   \else
+    % short enough contents: use \MakeFramed. As it is nested, this requires
+    % minipage encapsulation.
+    \noindent\begin{minipage}{\linewidth}%
+     \MakeFramed {% Use it now with the fetched contents
+      \advance\hsize-\width\@totalleftmargin\z@\linewidth\hsize\@setminipage
+      }%
+     \unvbox\sphinxVerbatim@ContentsBox
+     % some of this may be superfluous:
+     \par\unskip\@minipagefalse\endMakeFramed
+    \end{minipage}%
+   \fi
+  \else % non-nested \MakeFramed
+    \par\unskip\@minipagefalse\endMakeFramed % from framed.sty snugshade
+    \ifsphinxverbatimwithminipage\end{minipage}\fi
+  \fi
+  \endtrivlist
+}
+\newenvironment {sphinxVerbatimNoFrame}
+  {\spx@opt@verbatimwithframefalse
+   \VerbatimEnvironment
+   \begin{sphinxVerbatim}}
+  {\end{sphinxVerbatim}}
+\newenvironment {sphinxVerbatimintable}
+  {% don't use a frame if in a table cell
+   \spx@opt@verbatimwithframefalse
+   \sphinxverbatimwithminipagetrue
+   % the literal block caption uses \sphinxcaption which is wrapper of \caption,
+   % but \caption must be modified because longtable redefines it to work only
+   % for the own table caption, and tabulary has multiple passes
+   \let\caption\sphinxfigcaption
+   % reduce above caption skip
+   \def\spx@abovecaptionskip{\sphinxverbatimsmallskipamount}%
+   \VerbatimEnvironment
+   \begin{sphinxVerbatim}}
+  {\end{sphinxVerbatim}}
+
+
+%% PARSED LITERALS
+% allow long lines to wrap like they do in code-blocks
+
+% this should be kept in sync with definitions in sphinx.util.texescape
+\newcommand*\sphinxbreaksattexescapedchars{%
+  \def\do##1##2% put potential break point before character
+     {\def##1{\discretionary{}{\sphinxafterbreak\char`##2}{\char`##2}}}%
+  \do\{\{\do\textless\<\do\#\#\do\%\%\do\$\$% {, <, #, %, $
+  \def\do##1##2% put potential break point after character
+     {\def##1{\discretionary{\char`##2}{\sphinxafterbreak}{\char`##2}}}%
+  \do\_\_\do\}\}\do\textasciicircum\^\do\&\&% _, }, ^, &,
+  \do\textgreater\>\do\textasciitilde\~% >, ~
+  \do\textbackslash\\% \
+}
+\newcommand*\sphinxbreaksviaactiveinparsedliteral{%
+  \sphinxbreaksviaactive % by default handles . , ; ? ! /
+  \lccode`\~`\~ %
+  % update \dospecials as it is used by \url
+  % but deactivation will already have been done hence this is unneeded:
+  %  \expandafter\def\expandafter\dospecials\expandafter{\dospecials
+  %   \sphinxbreaksbeforeactivelist\sphinxbreaksafteractivelist\do\-}%
+}
+\newcommand*\sphinxbreaksatspaceinparsedliteral{%
+  \lccode`~32 \lowercase{\let~}\spx@verbatim@space\lccode`\~`\~
+}
+\newcommand*{\sphinxunactivateextras}{\let\do\@makeother
+      \sphinxbreaksbeforeactivelist\sphinxbreaksafteractivelist}%
+% the \catcode13=5\relax (deactivate end of input lines) is left to callers
+\newcommand*{\sphinxunactivateextrasandspace}{\catcode32=10\relax
+      \sphinxunactivateextras}%
+% now for the modified alltt environment
+\newenvironment{sphinxalltt}
+{% at start of next line to workaround Emacs/AUCTeX issue with this file
+\begin{alltt}%
+ \ifspx@opt@parsedliteralwraps
+   \sbox\sphinxcontinuationbox {\spx@opt@verbatimcontinued}%
+   \sbox\sphinxvisiblespacebox {\spx@opt@verbatimvisiblespace}%
+   \sphinxbreaksattexescapedchars
+   \sphinxbreaksviaactiveinparsedliteral
+   \sphinxbreaksatspaceinparsedliteral
+% alltt takes care of the ' as derivative ("prime") in math mode
+   \everymath\expandafter{\the\everymath\sphinxunactivateextrasandspace
+             \catcode`\<=12\catcode`\>=12\catcode`\^=7\catcode`\_=8 }%
+% not sure if displayed math (align,...) can end up in parsed-literal, anyway
+   \everydisplay\expandafter{\the\everydisplay
+             \catcode13=5 \sphinxunactivateextrasandspace
+             \catcode`\<=12\catcode`\>=12\catcode`\^=7\catcode`\_=8 }%
+ \fi }
+{\end{alltt}}
+
+% Protect \href's first argument in contexts such as sphinxalltt (or
+% \sphinxcode). Sphinx uses \#, \%, \& ... always inside \sphinxhref.
+\protected\def\sphinxhref#1#2{{%
+    \sphinxunactivateextrasandspace % never do \scantokens with active space!
+% for the \endlinechar business, https://github.com/latex3/latex2e/issues/286
+    \endlinechar\m@ne\everyeof{{\endlinechar13 #2}}% keep catcode regime for #2
+    \scantokens{\href{#1}}% normalise it for #1 during \href expansion
+}}
+% Same for \url. And also \nolinkurl for coherence.
+\protected\def\sphinxurl#1{{%
+    \sphinxunactivateextrasandspace\everyeof{}% (<- precaution for \scantokens)
+    \endlinechar\m@ne\scantokens{\url{#1}}%
+}}
+\protected\def\sphinxnolinkurl#1{{%
+    \sphinxunactivateextrasandspace\everyeof{}%
+    \endlinechar\m@ne\scantokens{\nolinkurl{#1}}%
+}}
+
+\endinput
\ No newline at end of file
diff --git a/sphinx/texinputs/sphinxlatexenvshadowbox.sty b/sphinx/texinputs/sphinxlatexenvshadowbox.sty
new file mode 100644
index 00000000000..dbc080039bf
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexenvshadowbox.sty
@@ -0,0 +1,86 @@
+%% TOPIC AND CONTENTS BOXES
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexenvshadowbox}[2021/01/27 topic and contents boxes]
+
+% Again based on use of "framed.sty", this allows breakable framed boxes.
+\long\def\spx@ShadowFBox#1{%
+  \leavevmode\begingroup
+  % first we frame the box #1
+  \setbox\@tempboxa
+   \hbox{\vrule\@width\sphinxshadowrule
+         \vbox{\hrule\@height\sphinxshadowrule
+               \kern\sphinxshadowsep
+               \hbox{\kern\sphinxshadowsep #1\kern\sphinxshadowsep}%
+               \kern\sphinxshadowsep
+               \hrule\@height\sphinxshadowrule}%
+         \vrule\@width\sphinxshadowrule}%
+  % Now we add the shadow, like \shadowbox from fancybox.sty would do
+  \dimen@\dimexpr.5\sphinxshadowrule+\sphinxshadowsize\relax
+  \hbox{\vbox{\offinterlineskip
+              \hbox{\copy\@tempboxa\kern-.5\sphinxshadowrule
+                    % add shadow on right side
+                    \lower\sphinxshadowsize
+                          \hbox{\vrule\@height\ht\@tempboxa \@width\dimen@}%
+                    }%
+              \kern-\dimen@ % shift back vertically to bottom of frame
+              % and add shadow at bottom
+              \moveright\sphinxshadowsize
+                    \vbox{\hrule\@width\wd\@tempboxa \@height\dimen@}%
+              }%
+        % move left by the size of right shadow so shadow adds no width
+        \kern-\sphinxshadowsize
+       }%
+  \endgroup
+}
+
+% use framed.sty to allow page breaks in frame+shadow
+% works well inside Lists and Quote-like environments
+% produced by ``topic'' directive (or local contents)
+% could nest if LaTeX writer authorized it
+\newenvironment{sphinxShadowBox}
+  {\def\FrameCommand {\spx@ShadowFBox }%
+   \advance\spx@image@maxheight
+   -\dimexpr2\sphinxshadowrule
+           +2\sphinxshadowsep
+           +\sphinxshadowsize
+           +\baselineskip\relax
+   % configure framed.sty not to add extra vertical spacing
+   \ltx@ifundefined{OuterFrameSep}{}{\OuterFrameSep\z@skip}%
+   % the \trivlist will add the vertical spacing on top and bottom which is
+   % typical of center environment as used in Sphinx <= 1.4.1
+   % the \noindent has the effet of an extra blank line on top, to
+   % imitate closely the layout from Sphinx <= 1.4.1; the \FrameHeightAdjust
+   % will put top part of frame on this baseline.
+   \def\FrameHeightAdjust {\baselineskip}%
+   % use package footnote to handle footnotes
+   \savenotes
+   \trivlist\item\noindent
+    % use a minipage if we are already inside a framed environment
+    \ifspx@inframed\begin{minipage}{\linewidth}\fi
+    \MakeFramed {\spx@inframedtrue
+    % framed.sty puts into "\width" the added width (=2shadowsep+2shadowrule)
+    % adjust \hsize to what the contents must use
+    \advance\hsize-\width
+    % adjust LaTeX parameters to behave properly in indented/quoted contexts
+    \FrameRestore
+    % typeset the contents as in a minipage (Sphinx <= 1.4.1 used a minipage and
+    % itemize/enumerate are therein typeset more tightly, we want to keep
+    % that). We copy-paste from LaTeX source code but don't do a real minipage.
+    \@pboxswfalse
+    \let\@listdepth\@mplistdepth \@mplistdepth\z@
+    \@minipagerestore
+    \@setminipage
+    }%
+  }%
+  {% insert the "endminipage" code
+    \par\unskip
+    \@minipagefalse
+   \endMakeFramed
+     \ifspx@inframed\end{minipage}\fi
+   \endtrivlist
+   % output the stored footnotes
+   \spewnotes
+  }
+
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexgraphics.sty b/sphinx/texinputs/sphinxlatexgraphics.sty
new file mode 100644
index 00000000000..c2f7cc783aa
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexgraphics.sty
@@ -0,0 +1,112 @@
+%% GRAPHICS
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexgraphics}[2021/01/27 graphics]
+
+% \sphinxincludegraphics resizes images larger than the TeX \linewidth (which
+% is adjusted in indented environments), or taller than a certain maximal
+% height (usually \textheight and this is reduced in the environments which use
+% framed.sty to avoid infinite loop if image too tall).
+%
+% In case height or width options are present the rescaling is done
+% (since 2.0), in a way keeping the width:height ratio either native from
+% image or from the width and height options if both were present.
+%
+\newdimen\spx@image@maxheight
+\AtBeginDocument{\spx@image@maxheight\textheight}
+
+% box scratch register
+\newdimen\spx@image@box
+\newcommand*{\sphinxsafeincludegraphics}[2][]{%
+    % #1 contains possibly width=, height=, but no scale= since 1.8.4
+    \setbox\spx@image@box\hbox{\includegraphics[#1,draft]{#2}}%
+    \in@false % use some handy boolean flag
+    \ifdim \wd\spx@image@box>\linewidth
+      \in@true % flag to remember to adjust options and set box dimensions
+      % compute height which results from rescaling width to \linewidth
+      % and keep current aspect ratio. multiply-divide in \numexpr uses
+      % temporarily doubled precision, hence no overflow. (of course we
+      % assume \ht is not a few sp's below \maxdimen...(about 16384pt).
+      \edef\spx@image@rescaledheight % with sp units
+           {\the\numexpr\ht\spx@image@box
+                        *\linewidth/\wd\spx@image@box sp}%
+      \ifdim\spx@image@rescaledheight>\spx@image@maxheight
+        % the rescaled height will be too big, so it is height which decides
+        % the rescaling factor
+        \def\spx@image@requiredheight{\spx@image@maxheight}% dimen register
+        \edef\spx@image@requiredwidth % with sp units
+         {\the\numexpr\wd\spx@image@box
+                      *\spx@image@maxheight/\ht\spx@image@box sp}%
+        % TODO: decide if this commented-out block could be needed due to
+        % rounding in numexpr operations going up
+        % \ifdim\spx@image@requiredwidth>\linewidth
+        %     \def\spx@image@requiredwidth{\linewidth}% dimen register
+        % \fi
+      \else
+        \def\spx@image@requiredwidth{\linewidth}% dimen register
+        \let\spx@image@requiredheight\spx@image@rescaledheight% sp units
+      \fi
+    \else
+      % width is ok, let's check height
+      \ifdim\ht\spx@image@box>\spx@image@maxheight
+        \in@true
+        \edef\spx@image@requiredwidth % with sp units
+            {\the\numexpr\wd\spx@image@box
+                         *\spx@image@maxheight/\ht\spx@image@box sp}%
+        \def\spx@image@requiredheight{\spx@image@maxheight}% dimen register
+      \fi
+    \fi % end of check of width and height
+    \ifin@
+      \setbox\spx@image@box
+      \hbox{\includegraphics
+            [%#1,% contained only width and/or height and overruled anyhow
+            width=\spx@image@requiredwidth,height=\spx@image@requiredheight]%
+            {#2}}%
+      % \includegraphics does not set box dimensions to the exactly
+      % requested ones, see https://github.com/latex3/latex2e/issues/112
+      \wd\spx@image@box\spx@image@requiredwidth
+      \ht\spx@image@box\spx@image@requiredheight
+      \leavevmode\box\spx@image@box
+    \else
+      % here we do not modify the options, no need to adjust width and height
+      % on output, they will be computed exactly as with "draft" option
+      \setbox\spx@image@box\box\voidb@x % clear memory
+      \includegraphics[#1]{#2}%
+    \fi
+}%
+% Use the "safe" one by default (2.0)
+\def\sphinxincludegraphics{\sphinxsafeincludegraphics}
+
+
+%% FIGURE IN TABLE
+%
+\newenvironment{sphinxfigure-in-table}[1][\linewidth]{%
+  \def\@captype{figure}%
+  \sphinxsetvskipsforfigintablecaption
+  \begin{minipage}{#1}%
+}{\end{minipage}}
+% store the original \caption macro for usage with figures inside longtable
+% and tabulary cells. Make sure we get the final \caption in presence of
+% caption package, whether the latter was loaded before or after sphinx.
+\AtBeginDocument{%
+    \let\spx@originalcaption\caption
+    \@ifpackageloaded{caption}
+      {\let\spx@ifcaptionpackage\@firstoftwo
+       \caption@AtBeginDocument*{\let\spx@originalcaption\caption}%
+% in presence of caption package, drop our own \sphinxcaption whose aim was to
+% ensure same width of caption to all kinds of tables (tabular(y), longtable),
+% because caption package has its own width (or margin) option
+       \def\sphinxcaption{\caption}%
+      }%
+      {\let\spx@ifcaptionpackage\@secondoftwo}%
+}
+% tabulary expands twice contents, we need to prevent double counter stepping
+\newcommand*\sphinxfigcaption
+  {\ifx\equation$%$% this is trick to identify tabulary first pass
+       \firstchoice@false\else\firstchoice@true\fi
+   \spx@originalcaption }
+\newcommand*\sphinxsetvskipsforfigintablecaption
+  {\abovecaptionskip\smallskipamount
+   \belowcaptionskip\smallskipamount}
+
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexmiscfixme.sty b/sphinx/texinputs/sphinxlatexmiscfixme.sty
new file mode 100644
index 00000000000..2c086ae0a3e
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexmiscfixme.sty
@@ -0,0 +1,18 @@
+%% FIXME STUFF attention, changes here may necessitate changes elsewhere
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexmiscfixme}[2021/01/27 latex to be removed at some point]
+
+%% COLOR (general)
+%
+% FIXME: \normalcolor should probably be used in place of \py@NormalColor
+% elsewhere, and \py@NormalColor should never be defined. \normalcolor
+% switches to the colour from last \color call in preamble.
+\def\py@NormalColor{\color{black}}
+% FIXME: it is probably better to use \color{TitleColor}, as TitleColor
+% can be customized from 'sphinxsetup', and drop usage of \py@TitleColor
+\def\py@TitleColor{\color{TitleColor}}
+% FIXME: this line should be dropped, as "9" is default anyhow.
+\ifdefined\pdfcompresslevel\pdfcompresslevel = 9 \fi
+
+\endinput
\ No newline at end of file
diff --git a/sphinx/texinputs/sphinxlatexmisclists.sty b/sphinx/texinputs/sphinxlatexmisclists.sty
new file mode 100644
index 00000000000..8a0dc72e981
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexmisclists.sty
@@ -0,0 +1,92 @@
+%% ALPHANUMERIC LIST ITEMS
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexmisclists}[2021/01/27 lists]
+
+\newcommand\sphinxsetlistlabels[5]
+{% #1 = style, #2 = enum, #3 = enumnext, #4 = prefix, #5 = suffix
+ % #2 and #3 are counters used by enumerate environement e.g. enumi, enumii.
+ % #1 is a macro such as \arabic or \alph
+ % prefix and suffix are strings (by default empty and a dot).
+ \@namedef{the#2}{#1{#2}}%
+ \@namedef{label#2}{#4\@nameuse{the#2}#5}%
+ \@namedef{p@#3}{\@nameuse{p@#2}#4\@nameuse{the#2}#5}%
+}%
+
+
+%% MAXLISTDEPTH
+%
+% remove LaTeX's cap on nesting depth if 'maxlistdepth' key used.
+% This is a hack, which works with the standard classes: it assumes \@toodeep
+% is always used in "true" branches: "\if ... \@toodeep \else .. \fi."
+
+% will force use the "false" branch (if there is one)
+\def\spx@toodeep@hack{\fi\iffalse}
+
+% do nothing if 'maxlistdepth' key not used or if package enumitem loaded.
+\ifnum\spx@opt@maxlistdepth=\z@\expandafter\@gobbletwo\fi
+\AtBeginDocument{%
+\@ifpackageloaded{enumitem}{\remove@to@nnil}{}%
+  \let\spx@toodeepORI\@toodeep
+  \def\@toodeep{%
+    \ifnum\@listdepth<\spx@opt@maxlistdepth\relax
+      \expandafter\spx@toodeep@hack
+    \else
+      \expandafter\spx@toodeepORI
+    \fi}%
+% define all missing \@list... macros
+  \count@\@ne
+  \loop
+     \ltx@ifundefined{@list\romannumeral\the\count@}
+       {\iffalse}{\iftrue\advance\count@\@ne}%
+  \repeat
+  \loop
+     \ifnum\count@>\spx@opt@maxlistdepth\relax\else
+       \expandafter\let
+         \csname @list\romannumeral\the\count@\expandafter\endcsname
+         \csname @list\romannumeral\the\numexpr\count@-\@ne\endcsname
+       % workaround 2.6--3.2d babel-french issue (fixed in 3.2e; no change needed)
+       \ltx@ifundefined{leftmargin\romannumeral\the\count@}
+       {\expandafter\let
+         \csname leftmargin\romannumeral\the\count@\expandafter\endcsname
+         \csname leftmargin\romannumeral\the\numexpr\count@-\@ne\endcsname}{}%
+     \advance\count@\@ne
+  \repeat
+% define all missing enum... counters and \labelenum... macros and \p@enum..
+  \count@\@ne
+  \loop
+     \ltx@ifundefined{c@enum\romannumeral\the\count@}
+       {\iffalse}{\iftrue\advance\count@\@ne}%
+  \repeat
+  \loop
+     \ifnum\count@>\spx@opt@maxlistdepth\relax\else
+       \newcounter{enum\romannumeral\the\count@}%
+       \expandafter\def
+         \csname labelenum\romannumeral\the\count@\expandafter\endcsname
+         \expandafter
+         {\csname theenum\romannumeral\the\numexpr\count@\endcsname.}%
+       \expandafter\def
+         \csname p@enum\romannumeral\the\count@\expandafter\endcsname
+         \expandafter
+         {\csname p@enum\romannumeral\the\numexpr\count@-\@ne\expandafter
+          \endcsname\csname theenum\romannumeral\the\numexpr\count@-\@ne\endcsname.}%
+     \advance\count@\@ne
+  \repeat
+% define all missing labelitem... macros
+  \count@\@ne
+  \loop
+     \ltx@ifundefined{labelitem\romannumeral\the\count@}
+     {\iffalse}{\iftrue\advance\count@\@ne}%
+  \repeat
+  \loop
+     \ifnum\count@>\spx@opt@maxlistdepth\relax\else
+       \expandafter\let
+         \csname labelitem\romannumeral\the\count@\expandafter\endcsname
+         \csname labelitem\romannumeral\the\numexpr\count@-\@ne\endcsname
+     \advance\count@\@ne
+  \repeat
+  \PackageInfo{sphinx}{maximal list depth extended to \spx@opt@maxlistdepth}%
+\@gobble\@nnil
+}
+
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexmiscnumbering.sty b/sphinx/texinputs/sphinxlatexmiscnumbering.sty
new file mode 100644
index 00000000000..acd9243fe9e
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexmiscnumbering.sty
@@ -0,0 +1,115 @@
+%% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexmiscnumbering}[2021/01/27 numbering]
+
+% Everything is delayed to \begin{document} to allow hyperref patches into
+%   \newcounter to solve duplicate label problems for internal hyperlinks to
+%   code listings (literalblock counter).  User or extension re-definitions of
+%   \theliteralblock, et al., thus have also to be delayed. (changed at 3.5.0)
+\AtBeginDocument{%
+\ltx@ifundefined{c@chapter}
+   {\newcounter{literalblock}}%
+   {\newcounter{literalblock}[chapter]%
+    \def\theliteralblock{\ifnum\c@chapter>\z@\arabic{chapter}.\fi
+                         \arabic{literalblock}}%
+    }%
+\ifspx@opt@nonumfigreset
+    \ltx@ifundefined{c@chapter}{}{%
+      \@removefromreset{figure}{chapter}%
+      \@removefromreset{table}{chapter}%
+      \@removefromreset{literalblock}{chapter}%
+      \ifspx@opt@mathnumfig
+        \@removefromreset{equation}{chapter}%
+      \fi
+    }%
+    \def\thefigure{\arabic{figure}}%
+    \def\thetable {\arabic{table}}%
+    \def\theliteralblock{\arabic{literalblock}}%
+    \ifspx@opt@mathnumfig
+      \def\theequation{\arabic{equation}}%
+    \fi
+\else
+\let\spx@preAthefigure\@empty
+\let\spx@preBthefigure\@empty
+% \ifspx@opt@usespart  % <-- LaTeX writer could pass such a 'usespart' boolean
+%                      %     as sphinx.sty package option
+% If document uses \part, (triggered in Sphinx by latex_toplevel_sectioning)
+% LaTeX core per default does not reset chapter or section
+% counters at each part.
+% But if we modify this, we need to redefine \thechapter, \thesection to
+% include the part number and this will cause problems in table of contents
+% because of too wide numbering. Simplest is to do nothing.
+% \fi
+\ifnum\spx@opt@numfigreset>0
+    \ltx@ifundefined{c@chapter}
+      {}
+      {\g@addto@macro\spx@preAthefigure{\ifnum\c@chapter>\z@\arabic{chapter}.}%
+       \g@addto@macro\spx@preBthefigure{\fi}}%
+\fi
+\ifnum\spx@opt@numfigreset>1
+    \@addtoreset{figure}{section}%
+    \@addtoreset{table}{section}%
+    \@addtoreset{literalblock}{section}%
+    \ifspx@opt@mathnumfig
+      \@addtoreset{equation}{section}%
+    \fi%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@section>\z@\arabic{section}.}%
+    \g@addto@macro\spx@preBthefigure{\fi}%
+\fi
+\ifnum\spx@opt@numfigreset>2
+    \@addtoreset{figure}{subsection}%
+    \@addtoreset{table}{subsection}%
+    \@addtoreset{literalblock}{subsection}%
+    \ifspx@opt@mathnumfig
+      \@addtoreset{equation}{subsection}%
+    \fi%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsection>\z@\arabic{subsection}.}%
+    \g@addto@macro\spx@preBthefigure{\fi}%
+\fi
+\ifnum\spx@opt@numfigreset>3
+    \@addtoreset{figure}{subsubsection}%
+    \@addtoreset{table}{subsubsection}%
+    \@addtoreset{literalblock}{subsubsection}%
+    \ifspx@opt@mathnumfig
+      \@addtoreset{equation}{subsubsection}%
+    \fi%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubsection>\z@\arabic{subsubsection}.}%
+    \g@addto@macro\spx@preBthefigure{\fi}%
+\fi
+\ifnum\spx@opt@numfigreset>4
+    \@addtoreset{figure}{paragraph}%
+    \@addtoreset{table}{paragraph}%
+    \@addtoreset{literalblock}{paragraph}%
+    \ifspx@opt@mathnumfig
+      \@addtoreset{equation}{paragraph}%
+    \fi%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@subparagraph>\z@\arabic{subparagraph}.}%
+    \g@addto@macro\spx@preBthefigure{\fi}%
+\fi
+\ifnum\spx@opt@numfigreset>5
+    \@addtoreset{figure}{subparagraph}%
+    \@addtoreset{table}{subparagraph}%
+    \@addtoreset{literalblock}{subparagraph}%
+    \ifspx@opt@mathnumfig
+      \@addtoreset{equation}{subparagraph}%
+    \fi%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubparagraph>\z@\arabic{subsubparagraph}.}%
+    \g@addto@macro\spx@preBthefigure{\fi}%
+\fi
+\expandafter\g@addto@macro
+\expandafter\spx@preAthefigure\expandafter{\spx@preBthefigure}%
+\let\thefigure\spx@preAthefigure
+\let\thetable\spx@preAthefigure
+\let\theliteralblock\spx@preAthefigure
+\g@addto@macro\thefigure{\arabic{figure}}%
+\g@addto@macro\thetable{\arabic{table}}%
+\g@addto@macro\theliteralblock{\arabic{literalblock}}%
+  \ifspx@opt@mathnumfig
+    \let\theequation\spx@preAthefigure
+    \g@addto@macro\theequation{\arabic{equation}}%
+  \fi
+\fi
+}% end of big \AtBeginDocument
+
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexoptionhandling.sty b/sphinx/texinputs/sphinxlatexoptionhandling.sty
new file mode 100644
index 00000000000..ad8cd75c74d
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexoptionhandling.sty
@@ -0,0 +1,134 @@
+%% OPTION HANDLING
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexoptionhandling}[2021/01/27 option handling]
+
+% Handle options via "kvoptions" (later loaded by hyperref anyhow)
+\RequirePackage{kvoptions}
+\SetupKeyvalOptions{prefix=spx@opt@} % use \spx@opt@ prefix
+
+% Sphinx legacy text layout: 1in margins on all four sides
+\ifx\@jsc@uplatextrue\@undefined
+\DeclareStringOption[1in]{hmargin}
+\DeclareStringOption[1in]{vmargin}
+\DeclareStringOption[.5in]{marginpar}
+\else
+% Japanese standard document classes handle \mag in a special way
+\DeclareStringOption[\inv@mag in]{hmargin}
+\DeclareStringOption[\inv@mag in]{vmargin}
+\DeclareStringOption[.5\dimexpr\inv@mag in\relax]{marginpar}
+\fi
+
+\DeclareStringOption[0]{maxlistdepth}% \newcommand*\spx@opt@maxlistdepth{0}
+\DeclareStringOption[-1]{numfigreset}
+\DeclareBoolOption[false]{nonumfigreset}
+\DeclareBoolOption[false]{mathnumfig}
+% \DeclareBoolOption[false]{usespart}% not used
+% dimensions, we declare the \dimen registers here.
+\newdimen\sphinxverbatimsep
+\newdimen\sphinxverbatimborder
+\newdimen\sphinxshadowsep
+\newdimen\sphinxshadowsize
+\newdimen\sphinxshadowrule
+% \DeclareStringOption is not convenient for the handling of these dimensions
+% because we want to assign the values to the corresponding registers. Even if
+% we added the code to the key handler it would be too late for the initial
+% set-up and we would need to do initial assignments explicitely. We end up
+% using \define@key directly.
+% verbatim
+\sphinxverbatimsep=\fboxsep
+  \define@key{sphinx}{verbatimsep}{\sphinxverbatimsep\dimexpr #1\relax}
+\sphinxverbatimborder=\fboxrule
+  \define@key{sphinx}{verbatimborder}{\sphinxverbatimborder\dimexpr #1\relax}
+% topic boxes
+\sphinxshadowsep =5pt
+  \define@key{sphinx}{shadowsep}{\sphinxshadowsep\dimexpr #1\relax}
+\sphinxshadowsize=4pt
+  \define@key{sphinx}{shadowsize}{\sphinxshadowsize\dimexpr #1\relax}
+\sphinxshadowrule=\fboxrule
+  \define@key{sphinx}{shadowrule}{\sphinxshadowrule\dimexpr #1\relax}
+% verbatim
+\DeclareBoolOption[true]{verbatimwithframe}
+\DeclareBoolOption[true]{verbatimwrapslines}
+\DeclareBoolOption[true]{verbatimhintsturnover}
+\DeclareBoolOption[true]{inlineliteralwraps}
+\DeclareStringOption[t]{literalblockcappos}
+\DeclareStringOption[r]{verbatimcontinuedalign}
+\DeclareStringOption[r]{verbatimcontinuesalign}
+% parsed literal
+\DeclareBoolOption[true]{parsedliteralwraps}
+% \textvisiblespace for compatibility with fontspec+XeTeX/LuaTeX
+\DeclareStringOption[\textcolor{red}{\textvisiblespace}]{verbatimvisiblespace}
+\DeclareStringOption % must use braces to hide the brackets
+  [{\makebox[2\fontcharwd\font`\x][r]{\textcolor{red}{\tiny$\m@th\hookrightarrow$}}}]%
+  {verbatimcontinued}
+% notices/admonitions
+% the dimensions for notices/admonitions are kept as macros and assigned to
+% \spx@notice@border at time of use, hence \DeclareStringOption is ok for this
+\newdimen\spx@notice@border
+\DeclareStringOption[0.5pt]{noteborder}
+\DeclareStringOption[0.5pt]{hintborder}
+\DeclareStringOption[0.5pt]{importantborder}
+\DeclareStringOption[0.5pt]{tipborder}
+\DeclareStringOption[1pt]{warningborder}
+\DeclareStringOption[1pt]{cautionborder}
+\DeclareStringOption[1pt]{attentionborder}
+\DeclareStringOption[1pt]{dangerborder}
+\DeclareStringOption[1pt]{errorborder}
+% footnotes
+\DeclareStringOption[\mbox{ }]{AtStartFootnote}
+% we need a public macro name for direct use in latex file
+\newcommand*{\sphinxAtStartFootnote}{\spx@opt@AtStartFootnote}
+% no such need for this one, as it is used inside other macros
+\DeclareStringOption[\leavevmode\unskip]{BeforeFootnote}
+% some font styling.
+\DeclareStringOption[\sffamily\bfseries]{HeaderFamily}
+% colours
+% same problems as for dimensions: we want the key handler to use \definecolor.
+% first, some colours with no prefix, for backwards compatibility
+\newcommand*{\sphinxDeclareColorOption}[2]{%
+   \definecolor{#1}#2%
+   \define@key{sphinx}{#1}{\definecolor{#1}##1}%
+}%
+\sphinxDeclareColorOption{TitleColor}{{rgb}{0.126,0.263,0.361}}
+\sphinxDeclareColorOption{InnerLinkColor}{{rgb}{0.208,0.374,0.486}}
+\sphinxDeclareColorOption{OuterLinkColor}{{rgb}{0.216,0.439,0.388}}
+\sphinxDeclareColorOption{VerbatimColor}{{rgb}{1,1,1}}
+\sphinxDeclareColorOption{VerbatimBorderColor}{{rgb}{0,0,0}}
+% now the colours defined with "sphinx" prefix in their names
+\newcommand*{\sphinxDeclareSphinxColorOption}[2]{%
+   % set the initial default
+   \definecolor{sphinx#1}#2%
+   % set the key handler. The "value" ##1 must be acceptable by \definecolor.
+   \define@key{sphinx}{#1}{\definecolor{sphinx#1}##1}%
+}%
+% Default color chosen to be as in minted.sty LaTeX package!
+\sphinxDeclareSphinxColorOption{VerbatimHighlightColor}{{rgb}{0.878,1,1}}
+% admonition boxes, "light" style
+\sphinxDeclareSphinxColorOption{noteBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{hintBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{importantBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{tipBorderColor}{{rgb}{0,0,0}}
+% admonition boxes, "heavy" style
+\sphinxDeclareSphinxColorOption{warningBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{cautionBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{attentionBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{dangerBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{errorBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{warningBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{cautionBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{attentionBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{dangerBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{errorBgColor}{{rgb}{1,1,1}}
+
+\DeclareDefaultOption{\@unknownoptionerror}
+\ProcessKeyvalOptions*
+% don't allow use of maxlistdepth via \sphinxsetup.
+\DisableKeyvalOption{sphinx}{maxlistdepth}
+\DisableKeyvalOption{sphinx}{numfigreset}
+\DisableKeyvalOption{sphinx}{nonumfigreset}
+\DisableKeyvalOption{sphinx}{mathnumfig}
+% user interface: options can be changed midway in a document!
+\newcommand\sphinxsetup[1]{\setkeys{sphinx}{#1}}
+
+\endinput
\ No newline at end of file
diff --git a/sphinx/texinputs/sphinxlatexrequirepackages.sty b/sphinx/texinputs/sphinxlatexrequirepackages.sty
new file mode 100644
index 00000000000..5b5052a67d3
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexrequirepackages.sty
@@ -0,0 +1,239 @@
+%% PACKAGES
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexrequirepackages}[2021/01/27 packages]
+
+\RequirePackage{graphicx}
+\@ifclassloaded{memoir}{}{\RequirePackage{fancyhdr}}
+% for \text macro and \iffirstchoice@ conditional even if amsmath not loaded
+\RequirePackage{amstext}
+\RequirePackage{textcomp}% "warn" option issued from template
+\RequirePackage[nobottomtitles*]{titlesec}
+\@ifpackagelater{titlesec}{2016/03/15}%
+ {\@ifpackagelater{titlesec}{2016/03/21}%
+  {}%
+  {\newif\ifsphinx@ttlpatch@ok
+   \IfFileExists{etoolbox.sty}{%
+     \RequirePackage{etoolbox}%
+     \patchcmd{\ttlh@hang}{\parindent\z@}{\parindent\z@\leavevmode}%
+                                {\sphinx@ttlpatch@oktrue}{}%
+     \ifsphinx@ttlpatch@ok
+     \patchcmd{\ttlh@hang}{\noindent}{}{}{\sphinx@ttlpatch@okfalse}%
+     \fi
+   }{}%
+   \ifsphinx@ttlpatch@ok
+     \typeout{^^J Package Sphinx Info: ^^J
+              **** titlesec 2.10.1 successfully patched for bugfix ****^^J}%
+   \else
+     \AtEndDocument{\PackageWarningNoLine{sphinx}{^^J%
+******** titlesec 2.10.1 has a bug, (section numbers disappear) ......|^^J%
+******** and Sphinx could not patch it, perhaps because your local ...|^^J%
+******** copy is already fixed without a changed release date. .......|^^J%
+******** If not, you must update titlesec! ...........................|}}%
+   \fi
+  }%
+ }{}
+\RequirePackage{tabulary}
+% tabulary has a bug with its re-definition of \multicolumn in its first pass
+% which is not \long. But now Sphinx does not use LaTeX's \multicolumn but its
+% own macro. Hence we don't even need to patch tabulary. See sphinxmulticell.sty
+% X or S (Sphinx) may have meanings if some table package is loaded hence
+% \X was chosen to avoid possibility of conflict
+\newcolumntype{\X}[2]{p{\dimexpr
+      (\linewidth-\arrayrulewidth)*#1/#2-\tw@\tabcolsep-\arrayrulewidth\relax}}
+\newcolumntype{\Y}[1]{p{\dimexpr
+      #1\dimexpr\linewidth-\arrayrulewidth\relax-\tw@\tabcolsep-\arrayrulewidth\relax}}
+% using here T (for Tabulary) feels less of a problem than the X could be
+\newcolumntype{T}{J}%
+% For tables allowing pagebreaks
+\RequirePackage{longtable}
+% User interface to set-up whitespace before and after tables:
+\newcommand*\sphinxtablepre {0pt}%
+\newcommand*\sphinxtablepost{\medskipamount}%
+% Space from caption baseline to top of table or frame of literal-block
+\newcommand*\sphinxbelowcaptionspace{.5\sphinxbaselineskip}%
+% as one can not use \baselineskip from inside longtable (it is zero there)
+% we need \sphinxbaselineskip, which defaults to \baselineskip
+\def\sphinxbaselineskip{\baselineskip}%
+% The following is to ensure that, whether tabular(y) or longtable:
+% - if a caption is on top of table:
+%   a) the space between its last baseline and the top rule of table is
+%      exactly \sphinxbelowcaptionspace
+%   b) the space from last baseline of previous text to first baseline of
+%      caption is exactly \parskip+\baselineskip+ height of a strut.
+%   c) the caption text will wrap at width \LTcapwidth (4in)
+% - make sure this works also if "caption" package is loaded by user
+%   (with its width or margin option taking place of \LTcapwidth role)
+% TODO: obtain same for caption of literal block: a) & c) DONE, b) TO BE DONE
+%
+% To modify space below such top caption, adjust \sphinxbelowcaptionspace
+% To add or remove space above such top caption, adjust \sphinxtablepre:
+%   notice that \abovecaptionskip, \belowcaptionskip, \LTpre are **ignored**
+% A. Table with longtable
+\def\sphinxatlongtablestart
+   {\par
+    \vskip\parskip
+    \vskip\dimexpr\sphinxtablepre\relax % adjust vertical position
+    \vbox{}% get correct baseline from above
+    \LTpre\z@skip\LTpost\z@skip % set to zero longtable's own skips
+    \edef\sphinxbaselineskip{\dimexpr\the\dimexpr\baselineskip\relax\relax}%
+   }%
+% Compatibility with caption package
+\def\sphinxthelongtablecaptionisattop{%
+    \spx@ifcaptionpackage{\noalign{\vskip-\belowcaptionskip}}{}%
+}%
+% Achieves exactly \sphinxbelowcaptionspace below longtable caption
+\def\sphinxlongtablecapskipadjust
+   {\dimexpr-\dp\strutbox
+            -\spx@ifcaptionpackage{\abovecaptionskip}{\sphinxbaselineskip}%
+            +\sphinxbelowcaptionspace\relax}%
+\def\sphinxatlongtableend{\@nobreakfalse % latex3/latex2e#173
+    \prevdepth\z@\vskip\sphinxtablepost\relax}%
+% B. Table with tabular or tabulary
+\def\sphinxattablestart{\par\vskip\dimexpr\sphinxtablepre\relax}%
+\let\sphinxattableend\sphinxatlongtableend
+% This is used by tabular and tabulary templates
+\newcommand*\sphinxcapstartof[1]{%
+   \vskip\parskip
+   \vbox{}% force baselineskip for good positioning by capstart of hyperanchor
+   % hyperref puts the anchor 6pt above this baseline; in case of caption
+   % this baseline will be \ht\strutbox above first baseline of caption
+   \def\@captype{#1}%
+   \capstart
+% move back vertically, as tabular (or its caption) will compensate
+   \vskip-\baselineskip\vskip-\parskip
+}%
+\def\sphinxthecaptionisattop{% locate it after \sphinxcapstartof
+    \spx@ifcaptionpackage
+      {\caption@setposition{t}%
+       \vskip\baselineskip\vskip\parskip % undo those from \sphinxcapstartof
+       \vskip-\belowcaptionskip          % anticipate caption package skip
+       % caption package uses a \vbox, not a \vtop, so "single line" case
+       % gives different result from "multi-line" without this:
+       \nointerlineskip
+      }%
+      {}%
+}%
+\def\sphinxthecaptionisatbottom{% (not finalized; for template usage)
+    \spx@ifcaptionpackage{\caption@setposition{b}}{}%
+}%
+% The aim of \sphinxcaption is to apply to tabular(y) the maximal width
+% of caption as done by longtable
+\def\sphinxtablecapwidth{\LTcapwidth}%
+\newcommand\sphinxcaption{\@dblarg\spx@caption}%
+\long\def\spx@caption[#1]#2{%
+   \noindent\hb@xt@\linewidth{\hss
+      \vtop{\@tempdima\dimexpr\sphinxtablecapwidth\relax
+% don't exceed linewidth for the caption width
+            \ifdim\@tempdima>\linewidth\hsize\linewidth\else\hsize\@tempdima\fi
+% longtable ignores \abovecaptionskip/\belowcaptionskip, so do the same here
+            \abovecaptionskip\sphinxabovecaptionskip % \z@skip
+            \belowcaptionskip\sphinxbelowcaptionskip % \z@skip
+            \caption[{#1}]%
+               {\strut\ignorespaces#2\ifhmode\unskip\@finalstrut\strutbox\fi}%
+           }\hss}%
+   \par\prevdepth\dp\strutbox
+}%
+\def\sphinxabovecaptionskip{\z@skip}% Do not use! Flagged for removal
+\def\sphinxbelowcaptionskip{\z@skip}% Do not use! Flagged for removal
+% This wrapper of \abovecaptionskip is used in sphinxVerbatim for top
+% caption, and with another value in sphinxVerbatimintable
+% TODO: To unify space above caption of a code-block with the one above
+%       caption of a table/longtable, \abovecaptionskip must not be used
+%       This auxiliary will get renamed and receive a different meaning
+%       in future.
+\def\spx@abovecaptionskip{\abovecaptionskip}%
+% Achieve \sphinxbelowcaptionspace below a caption located above a tabular
+% or a tabulary
+\newcommand\sphinxaftertopcaption
+{%
+   \spx@ifcaptionpackage
+     {\par\prevdepth\dp\strutbox\nobreak\vskip-\abovecaptionskip}{\nobreak}%
+   \vskip\dimexpr\sphinxbelowcaptionspace\relax
+   \vskip-\baselineskip\vskip-\parskip
+}%
+% varwidth is crucial for our handling of general contents in merged cells
+\RequirePackage{varwidth}
+% but addition of a compatibility patch with hyperref is needed
+% (tested with varwidth v 0.92  Mar 2009)
+\AtBeginDocument {%
+    \let\@@vwid@Hy@raisedlink\Hy@raisedlink
+    \long\def\@vwid@Hy@raisedlink#1{\@vwid@wrap{\@@vwid@Hy@raisedlink{#1}}}%
+    \edef\@vwid@setup{%
+      \let\noexpand\Hy@raisedlink\noexpand\@vwid@Hy@raisedlink % HYPERREF !
+      \unexpanded\expandafter{\@vwid@setup}}%
+}%
+% Homemade package to handle merged cells
+\RequirePackage{sphinxmulticell}
+\RequirePackage{makeidx}
+% For framing code-blocks and warning type notices, and shadowing topics
+\RequirePackage{framed}
+% The xcolor package draws better fcolorboxes around verbatim code
+\IfFileExists{xcolor.sty}{
+    \RequirePackage{xcolor}
+}{
+    \RequirePackage{color}
+}
+% For highlighted code.
+\RequirePackage{fancyvrb}
+\define@key{FV}{hllines}{\def\sphinx@verbatim@checkifhl##1{\in@{, ##1,}{#1}}}
+% sphinxVerbatim must be usable by third party without requiring hllines set-up
+\def\sphinxresetverbatimhllines{\def\sphinx@verbatim@checkifhl##1{\in@false}}
+\sphinxresetverbatimhllines
+% For hyperlinked footnotes in tables; also for gathering footnotes from
+% topic and warning blocks. Also to allow code-blocks in footnotes.
+\RequirePackage{footnotehyper-sphinx}
+% For the H specifier. Do not \restylefloat{figure}, it breaks Sphinx code
+% for allowing figures in tables.
+\RequirePackage{float}
+% For floating figures in the text. Better to load after float.
+\RequirePackage{wrapfig}
+% Separate paragraphs by space by default.
+\IfFileExists{parskip-2001-04-09.sty}% since September 2018 TeXLive update
+% new parskip.sty, but let it rollback to old one.
+% hopefully TeX installation not broken and LaTeX kernel not too old
+   {\RequirePackage{parskip}[=v1]}
+% standard one from 1989. Admittedly \section of article/book gives possibly
+% anomalous spacing, but we can't require September 2018 release for some time.
+   {\RequirePackage{parskip}}
+% For parsed-literal blocks.
+\RequirePackage{alltt}
+% Display "real" single quotes in literal blocks.
+\RequirePackage{upquote}
+% control caption around literal-block
+\RequirePackage{capt-of}
+\RequirePackage{needspace}
+% LaTeX 2018-04-01 and later provides \@removefromreset
+\ltx@ifundefined{@removefromreset}
+    {\RequirePackage{remreset}}
+    {}% avoid warning
+% to make pdf with correct encoded bookmarks in Japanese
+% this should precede the hyperref package
+\ifx\kanjiskip\@undefined
+% for non-Japanese: make sure bookmarks are ok also with lualatex
+  \PassOptionsToPackage{pdfencoding=unicode}{hyperref}
+\else
+  \RequirePackage{atbegshi}
+  \ifx\ucs\@undefined
+    \ifnum 42146=\euc"A4A2
+      \AtBeginShipoutFirst{\special{pdf:tounicode EUC-UCS2}}
+    \else
+      \AtBeginShipoutFirst{\special{pdf:tounicode 90ms-RKSJ-UCS2}}
+    \fi
+  \else
+    \AtBeginShipoutFirst{\special{pdf:tounicode UTF8-UCS2}}
+  \fi
+\fi
+
+\ifx\@jsc@uplatextrue\@undefined\else
+  \PassOptionsToPackage{setpagesize=false}{hyperref}
+\fi
+
+% These options can be overriden inside  'hyperref' key
+% or by later use of \hypersetup.
+\PassOptionsToPackage{colorlinks,breaklinks,%
+ linkcolor=InnerLinkColor,filecolor=OuterLinkColor,%
+ menucolor=OuterLinkColor,urlcolor=OuterLinkColor,%
+ citecolor=InnerLinkColor}{hyperref}
+
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexstyleheadings.sty b/sphinx/texinputs/sphinxlatexstyleheadings.sty
new file mode 100644
index 00000000000..4e99655563a
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexstyleheadings.sty
@@ -0,0 +1,50 @@
+% change this info string if making any custom modification
+%% TITLES
+%
+\ProvidesFile{sphinxlatexstyleheadings}[2021/01/27 headings]
+
+% Since Sphinx 1.5, users should use HeaderFamily key to 'sphinxsetup' rather
+% than defining their own \py@HeaderFamily command (which is still possible).
+% Memo: \py@HeaderFamily is also used by \maketitle as defined in
+% sphinxmanual.cls/sphinxhowto.cls
+\newcommand{\py@HeaderFamily}{\spx@opt@HeaderFamily}
+
+% This sets up the fancy chapter headings that make the documents look
+% at least a little better than the usual LaTeX output.
+\@ifpackagewith{fncychap}{Bjarne}{
+  \ChNameVar {\raggedleft\normalsize \py@HeaderFamily}
+  \ChNumVar  {\raggedleft\Large      \py@HeaderFamily}
+  \ChTitleVar{\raggedleft\Large      \py@HeaderFamily}
+  % This creates (numbered) chapter heads without the leading \vspace*{}:
+  \def\@makechapterhead#1{%
+    {\parindent \z@ \raggedright \normalfont
+      \ifnum \c@secnumdepth >\m@ne
+        \if@mainmatter
+          \DOCH
+        \fi
+      \fi
+      \interlinepenalty\@M
+      \if@mainmatter
+        \DOTI{#1}%
+      \else%
+        \DOTIS{#1}%
+      \fi
+    }}
+}{}% <-- "false" clause of \@ifpackagewith
+
+% Augment the sectioning commands used to get our own font family in place,
+% and reset some internal data items (\titleformat from titlesec package)
+\titleformat{\section}{\Large\py@HeaderFamily}%
+            {\py@TitleColor\thesection}{0.5em}{\py@TitleColor}{\py@NormalColor}
+\titleformat{\subsection}{\large\py@HeaderFamily}%
+            {\py@TitleColor\thesubsection}{0.5em}{\py@TitleColor}{\py@NormalColor}
+\titleformat{\subsubsection}{\py@HeaderFamily}%
+            {\py@TitleColor\thesubsubsection}{0.5em}{\py@TitleColor}{\py@NormalColor}
+% By default paragraphs (and subsubsections) will not be numbered because
+% sphinxmanual.cls and sphinxhowto.cls set secnumdepth to 2
+\titleformat{\paragraph}{\py@HeaderFamily}%
+            {\py@TitleColor\theparagraph}{0.5em}{\py@TitleColor}{\py@NormalColor}
+\titleformat{\subparagraph}{\py@HeaderFamily}%
+            {\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor}{\py@NormalColor}
+
+\endinput
\ No newline at end of file
diff --git a/sphinx/texinputs/sphinxlatexstylepage.sty b/sphinx/texinputs/sphinxlatexstylepage.sty
new file mode 100644
index 00000000000..b259741e394
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexstylepage.sty
@@ -0,0 +1,120 @@
+%% PAGE STYLING
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexstylepage}[2021/01/27 page styling]
+
+% Style parameters and macros used by most documents here
+\raggedbottom
+\sloppy
+\hbadness = 5000                % don't print trivial gripes
+
+% Use \pagestyle{normal} as the primary pagestyle for text.
+% Redefine the 'normal' header/footer style when using "fancyhdr" package:
+\@ifpackageloaded{fancyhdr}{%
+  \ltx@ifundefined{c@chapter}
+  {% no \chapter, "howto" (non-Japanese) docclass
+   \fancypagestyle{plain}{
+    \fancyhf{}
+    \fancyfoot[C]{{\py@HeaderFamily\thepage}}
+    \renewcommand{\headrulewidth}{0pt}
+    \renewcommand{\footrulewidth}{0pt}
+   }
+   % Same as 'plain', this way we can use it in template
+   % FIXME: shouldn't this have a running header with Name and Release like 'manual'?
+   \fancypagestyle{normal}{
+    \fancyhf{}
+    \fancyfoot[C]{{\py@HeaderFamily\thepage}}
+    \renewcommand{\headrulewidth}{0pt}
+    \renewcommand{\footrulewidth}{0pt}
+   }
+  }%
+  {% classes with \chapter command
+   \fancypagestyle{normal}{
+    \fancyhf{}
+    \fancyfoot[RO]{{\py@HeaderFamily\thepage}}
+    \fancyfoot[LO]{{\py@HeaderFamily\nouppercase{\rightmark}}}
+    \fancyhead[RO]{{\py@HeaderFamily \@title\sphinxheadercomma\py@release}}
+    \if@twoside
+     \fancyfoot[LE]{{\py@HeaderFamily\thepage}}
+     \fancyfoot[RE]{{\py@HeaderFamily\nouppercase{\leftmark}}}
+     \fancyhead[LE]{{\py@HeaderFamily \@title\sphinxheadercomma\py@release}}
+    \fi
+    \renewcommand{\headrulewidth}{0.4pt}
+    \renewcommand{\footrulewidth}{0.4pt}
+    % define chaptermark with \@chappos when \@chappos is available for Japanese
+    \ltx@ifundefined{@chappos}{}
+      {\def\chaptermark##1{\markboth{\@chapapp\space\thechapter\space\@chappos\space ##1}{}}}
+    }
+  % Update the plain style so we get the page number & footer line,
+  % but not a chapter or section title.  This is to keep the first
+  % page of a chapter `clean.'
+   \fancypagestyle{plain}{
+    \fancyhf{}
+    \fancyfoot[RO]{{\py@HeaderFamily\thepage}}
+    \if@twoside\fancyfoot[LE]{{\py@HeaderFamily\thepage}}\fi
+    \renewcommand{\headrulewidth}{0pt}
+    \renewcommand{\footrulewidth}{0.4pt}
+    }
+   }
+  }
+  {% no fancyhdr: memoir class
+   % Provide default for 'normal' style simply as an alias of 'plain' style
+   % This way we can use \pagestyle{normal} in LaTeX template
+   \def\ps@normal{\ps@plain}
+   % Users of memoir class are invited to redefine 'normal' style in preamble
+  }
+
+% geometry
+\ifx\kanjiskip\@undefined
+  \PassOptionsToPackage{%
+     hmargin={\unexpanded{\spx@opt@hmargin}},%
+     vmargin={\unexpanded{\spx@opt@vmargin}},%
+     marginpar=\unexpanded{\spx@opt@marginpar}}
+  {geometry}
+\else
+ % set text width for Japanese documents to be integer multiple of 1zw
+ % and text height to be integer multiple of \baselineskip
+ % the execution is delayed to \sphinxsetup then geometry.sty
+ \normalsize\normalfont
+ \newcommand*\sphinxtextwidthja[1]{%
+    \if@twocolumn\tw@\fi
+    \dimexpr
+       \numexpr\dimexpr\paperwidth-\tw@\dimexpr#1\relax\relax/
+               \dimexpr\if@twocolumn\tw@\else\@ne\fi zw\relax
+    zw\relax}%
+ \newcommand*\sphinxmarginparwidthja[1]{%
+    \dimexpr\numexpr\dimexpr#1\relax/\dimexpr1zw\relax zw\relax}%
+ \newcommand*\sphinxtextlinesja[1]{%
+    \numexpr\@ne+\dimexpr\paperheight-\topskip-\tw@\dimexpr#1\relax\relax/
+                 \baselineskip\relax}%
+ \ifx\@jsc@uplatextrue\@undefined\else
+ % the way we found in order for the papersize special written by
+ % geometry in the dvi file to be correct in case of jsbook class
+   \ifnum\mag=\@m\else % do nothing special if nomag class option or 10pt
+     \PassOptionsToPackage{truedimen}{geometry}%
+   \fi
+ \fi
+ \PassOptionsToPackage{%
+    hmarginratio={1:1},%
+    textwidth=\unexpanded{\sphinxtextwidthja{\spx@opt@hmargin}},%
+    vmarginratio={1:1},%
+    lines=\unexpanded{\sphinxtextlinesja{\spx@opt@vmargin}},%
+    marginpar=\unexpanded{\sphinxmarginparwidthja{\spx@opt@marginpar}},%
+    footskip=2\baselineskip,%
+  }{geometry}%
+ \AtBeginDocument
+ {% update a dimension used by the jsclasses
+  \ifx\@jsc@uplatextrue\@undefined\else\fullwidth\textwidth\fi
+  % for some reason, jreport normalizes all dimensions with \@settopoint
+  \@ifclassloaded{jreport}
+    {\@settopoint\textwidth\@settopoint\textheight\@settopoint\marginparwidth}
+    {}% <-- "false" clause of \@ifclassloaded
+  }%
+\fi
+
+% fix fncychap's bug which uses prematurely the \textwidth value
+\@ifpackagewith{fncychap}{Bjornstrup}
+ {\AtBeginDocument{\mylen\textwidth\advance\mylen-2\myhi}}%
+ {}% <-- "false" clause of \@ifpackagewith
+
+\endinput
\ No newline at end of file
diff --git a/sphinx/texinputs/sphinxlatexstyletext.sty b/sphinx/texinputs/sphinxlatexstyletext.sty
new file mode 100644
index 00000000000..cfb8714e37b
--- /dev/null
+++ b/sphinx/texinputs/sphinxlatexstyletext.sty
@@ -0,0 +1,166 @@
+%% TEXT STYLING
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexstyletext}[2021/01/27 text styling]
+
+% to obtain straight quotes we execute \@noligs as patched by upquote, and
+% \scantokens is needed in cases where it would be too late for the macro to
+% first set catcodes and then fetch its argument. We also make the contents
+% breakable at non-escaped . , ; ? ! / using \sphinxbreaksviaactive,
+% and also at \ character (which is escaped to \textbackslash{}).
+\protected\def\sphinxtextbackslashbreakbefore
+ {\discretionary{}{\sphinxafterbreak\sphinx@textbackslash}{\sphinx@textbackslash}}
+\protected\def\sphinxtextbackslashbreakafter
+ {\discretionary{\sphinx@textbackslash}{\sphinxafterbreak}{\sphinx@textbackslash}}
+\let\sphinxtextbackslash\sphinxtextbackslashbreakafter
+% the macro must be protected if it ends up used in moving arguments,
+% in 'alltt' \@noligs is done already, and the \scantokens must be avoided.
+\protected\def\sphinxupquote#1{{\def\@tempa{alltt}%
+  \ifx\@tempa\@currenvir\else
+   \ifspx@opt@inlineliteralwraps
+      % break at . , ; ? ! /
+      \sphinxbreaksviaactive
+      % break also at \
+      \let\sphinx@textbackslash\textbackslash
+      \let\textbackslash\sphinxtextbackslash
+      % by default, no continuation symbol on next line but may be added
+      \let\sphinxafterbreak\sphinxafterbreakofinlineliteral
+      % do not overwrite the comma set-up
+      \let\verbatim@nolig@list\sphinx@literal@nolig@list
+   \fi
+   % fix a space-gobbling issue due to LaTeX's original \do@noligs
+% TODO: using \@noligs as patched by upquote.sty is now unneeded because
+% either ` and ' are escaped (non-unicode engines) or they don't build
+% ligatures (unicode engines). Thus remove this and unify handling of `, <, >,
+% ' and - with the characters . , ; ? ! / as handled via
+% \sphinxbreaksviaactive.
+% Hence \sphinx@do@noligs will be removed, or rather replaced  with code
+% inserting discretionaries, as they allow a continuation symbol on start of
+% next line to achieve common design with code-blocks.
+   \let\do@noligs\sphinx@do@noligs
+   \@noligs\endlinechar\m@ne\everyeof{}% (<- in case inside \sphinxhref)
+   \expandafter\scantokens
+  \fi {{#1}}}}% extra brace pair to fix end-space gobbling issue...
+\def\sphinx@do@noligs #1{\catcode`#1\active\begingroup\lccode`\~`#1\relax
+    \lowercase{\endgroup\def~{\leavevmode\kern\z@\char`#1 }}}
+\def\sphinx@literal@nolig@list {\do\`\do\<\do\>\do\'\do\-}%
+\let\sphinxafterbreakofinlineliteral\empty
+
+% Some custom font markup commands.
+\protected\def\sphinxstrong#1{\textbf{#1}}
+\protected\def\sphinxcode#1{\texttt{#1}}
+\protected\def\sphinxbfcode#1{\textbf{\sphinxcode{#1}}}
+\protected\def\sphinxemail#1{\textsf{#1}}
+\protected\def\sphinxtablecontinued#1{\textsf{#1}}
+\protected\def\sphinxtitleref#1{\emph{#1}}
+\protected\def\sphinxmenuselection#1{\emph{#1}}
+\protected\def\sphinxguilabel#1{\emph{#1}}
+\protected\def\sphinxkeyboard#1{\sphinxcode{#1}}
+\protected\def\sphinxaccelerator#1{\underline{#1}}
+\protected\def\sphinxcrossref#1{\emph{#1}}
+\protected\def\sphinxtermref#1{\emph{#1}}
+% \optional is used for ``[, arg]``, i.e. desc_optional nodes.
+\long\protected\def\sphinxoptional#1{%
+  {\textnormal{\Large[}}{#1}\hspace{0.5mm}{\textnormal{\Large]}}}
+
+% additional customizable styling
+\def\sphinxstyleindexentry   #1{\texttt{#1}}
+\def\sphinxstyleindexextra   #1{ (\emph{#1})}
+\def\sphinxstyleindexpageref #1{, \pageref{#1}}
+\def\sphinxstyleindexpagemain#1{\textbf{#1}}
+\protected\def\spxentry#1{#1}% will get \let to \sphinxstyleindexentry in index
+\protected\def\spxextra#1{#1}% will get \let to \sphinxstyleindexextra in index
+\def\sphinxstyleindexlettergroup #1%
+    {{\Large\sffamily#1}\nopagebreak\vspace{1mm}}
+\def\sphinxstyleindexlettergroupDefault #1%
+    {{\Large\sffamily\sphinxnonalphabeticalgroupname}\nopagebreak\vspace{1mm}}
+\protected\def\sphinxstyletopictitle   #1{\textbf{#1}\par\medskip}
+\let\sphinxstylesidebartitle\sphinxstyletopictitle
+\protected\def\sphinxstyleothertitle   #1{\textbf{#1}}
+\protected\def\sphinxstylesidebarsubtitle #1{~\\\textbf{#1} \smallskip}
+% \text.. commands do not allow multiple paragraphs
+\protected\def\sphinxstyletheadfamily    {\sffamily}
+\protected\def\sphinxstyleemphasis     #1{\emph{#1}}
+\protected\def\sphinxstyleliteralemphasis#1{\emph{\sphinxcode{#1}}}
+\protected\def\sphinxstylestrong       #1{\textbf{#1}}
+\protected\def\sphinxstyleliteralstrong#1{\sphinxbfcode{#1}}
+\protected\def\sphinxstyleabbreviation #1{\textsc{#1}}
+\protected\def\sphinxstyleliteralintitle#1{\sphinxcode{#1}}
+\newcommand*\sphinxstylecodecontinued[1]{\footnotesize(#1)}%
+\newcommand*\sphinxstylecodecontinues[1]{\footnotesize(#1)}%
+% figure legend comes after caption and may contain arbitrary body elements
+\newenvironment{sphinxlegend}{\par\small}{\par}
+% reduce hyperref "Token not allowed in a PDF string" warnings on PDF builds
+\AtBeginDocument{\pdfstringdefDisableCommands{%
+% all "protected" macros possibly ending up in section titles should be here
+% TODO: examine if \sphinxhref, \sphinxurl, \sphinnolinkurl should be handled
+    \let\sphinxstyleemphasis        \@firstofone
+    \let\sphinxstyleliteralemphasis \@firstofone
+    \let\sphinxstylestrong          \@firstofone
+    \let\sphinxstyleliteralstrong   \@firstofone
+    \let\sphinxstyleabbreviation    \@firstofone
+    \let\sphinxstyleliteralintitle  \@firstofone
+    \let\sphinxupquote  \@firstofone
+    \let\sphinxstrong   \@firstofone
+    \let\sphinxcode     \@firstofone
+    \let\sphinxbfcode   \@firstofone
+    \let\sphinxemail    \@firstofone
+    \let\sphinxcrossref \@firstofone
+    \let\sphinxtermref  \@firstofone
+    \let\sphinxhyphen\sphinxhyphenforbookmarks
+}}
+
+% Special characters
+%
+% This definition prevents en-dash and em-dash TeX ligatures.
+%
+% It inserts a potential breakpoint after the hyphen. This is to keep in sync
+% with behavior in code-blocks, parsed and inline literals. For a breakpoint
+% before the hyphen use \leavevmode\kern\z@- (within \makeatletter/\makeatother)
+\protected\def\sphinxhyphen#1{-\kern\z@}
+% The {} from texescape mark-up is kept, else -- gives en-dash in PDF bookmark
+\def\sphinxhyphenforbookmarks{-}
+
+% For curly braces inside \index macro
+\def\sphinxleftcurlybrace{\{}
+\def\sphinxrightcurlybrace{\}}
+
+% Declare Unicode characters used by linux tree command to pdflatex utf8/utf8x
+\def\spx@bd#1#2{%
+  \leavevmode
+  \begingroup
+  \ifx\spx@bd@height   \@undefined\def\spx@bd@height{\baselineskip}\fi
+  \ifx\spx@bd@width    \@undefined\setbox0\hbox{0}\def\spx@bd@width{\wd0 }\fi
+  \ifx\spx@bd@thickness\@undefined\def\spx@bd@thickness{.6\p@}\fi
+  \ifx\spx@bd@lower    \@undefined\def\spx@bd@lower{\dp\strutbox}\fi
+  \lower\spx@bd@lower#1{#2}%
+  \endgroup
+}%
+\@namedef{sphinx@u2500}% BOX DRAWINGS LIGHT HORIZONTAL
+  {\spx@bd{\vbox to\spx@bd@height}
+          {\vss\hrule\@height\spx@bd@thickness
+                     \@width\spx@bd@width\vss}}%
+\@namedef{sphinx@u2502}% BOX DRAWINGS LIGHT VERTICAL
+  {\spx@bd{\hb@xt@\spx@bd@width}
+          {\hss\vrule\@height\spx@bd@height
+                     \@width \spx@bd@thickness\hss}}%
+\@namedef{sphinx@u2514}% BOX DRAWINGS LIGHT UP AND RIGHT
+  {\spx@bd{\hb@xt@\spx@bd@width}
+          {\hss\raise.5\spx@bd@height
+           \hb@xt@\z@{\hss\vrule\@height.5\spx@bd@height
+                                \@width \spx@bd@thickness\hss}%
+           \vbox to\spx@bd@height{\vss\hrule\@height\spx@bd@thickness
+                                            \@width.5\spx@bd@width\vss}}}%
+\@namedef{sphinx@u251C}% BOX DRAWINGS LIGHT VERTICAL AND RIGHT
+  {\spx@bd{\hb@xt@\spx@bd@width}
+          {\hss
+           \hb@xt@\z@{\hss\vrule\@height\spx@bd@height
+                                \@width \spx@bd@thickness\hss}%
+           \vbox to\spx@bd@height{\vss\hrule\@height\spx@bd@thickness
+                                            \@width.5\spx@bd@width\vss}}}%
+\protected\def\sphinxunichar#1{\@nameuse{sphinx@u#1}}%
+
+% Tell TeX about pathological hyphenation cases:
+\hyphenation{Base-HTTP-Re-quest-Hand-ler}
+
+\endinput

From 5e814594866d57d6491cd62ab69526ba01c17428 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 27 Jan 2021 16:08:51 +0100
Subject: [PATCH 113/305] Refactor LaTeX [2/2]: renamings of auxiliary Sphinx
 LaTeX packages

sphinxcyrillic -> sphinxpackagecyrillic
sphinxmulticell -> sphinxpackagemulticell
footnotehyper-sphinx -> sphinxpackagefootnote
---
 sphinx/builders/latex/__init__.py                  |  6 ++++--
 sphinx/texinputs/sphinxlatexenvliteral.sty         |  2 +-
 sphinx/texinputs/sphinxlatexrequirepackages.sty    |  7 ++++---
 ...phinxcyrillic.sty => sphinxpackagecyrillic.sty} |  2 +-
 ...ehyper-sphinx.sty => sphinxpackagefootnote.sty} | 14 +++++++-------
 ...inxmulticell.sty => sphinxpackagemulticell.sty} |  7 ++++---
 6 files changed, 21 insertions(+), 17 deletions(-)
 rename sphinx/texinputs/{sphinxcyrillic.sty => sphinxpackagecyrillic.sty} (98%)
 rename sphinx/texinputs/{footnotehyper-sphinx.sty => sphinxpackagefootnote.sty} (95%)
 rename sphinx/texinputs/{sphinxmulticell.sty => sphinxpackagemulticell.sty} (98%)

diff --git a/sphinx/builders/latex/__init__.py b/sphinx/builders/latex/__init__.py
index efe922fa58e..dc533b48635 100644
--- a/sphinx/builders/latex/__init__.py
+++ b/sphinx/builders/latex/__init__.py
@@ -216,10 +216,12 @@ def init_multilingual(self) -> None:
             if not self.babel.uses_cyrillic():
                 if 'X2' in self.context['fontenc']:
                     self.context['substitutefont'] = '\\usepackage{substitutefont}'
-                    self.context['textcyrillic'] = '\\usepackage[Xtwo]{sphinxcyrillic}'
+                    self.context['textcyrillic'] = ('\\usepackage[Xtwo]'
+                                                    '{sphinxpackagecyrillic}')
                 elif 'T2A' in self.context['fontenc']:
                     self.context['substitutefont'] = '\\usepackage{substitutefont}'
-                    self.context['textcyrillic'] = '\\usepackage[TtwoA]{sphinxcyrillic}'
+                    self.context['textcyrillic'] = ('\\usepackage[TtwoA]'
+                                                    '{sphinxpackagecyrillic}')
             if 'LGR' in self.context['fontenc']:
                 self.context['substitutefont'] = '\\usepackage{substitutefont}'
             else:
diff --git a/sphinx/texinputs/sphinxlatexenvliteral.sty b/sphinx/texinputs/sphinxlatexenvliteral.sty
index 8f5533c0d9f..079914c22c7 100644
--- a/sphinx/texinputs/sphinxlatexenvliteral.sty
+++ b/sphinx/texinputs/sphinxlatexenvliteral.sty
@@ -7,7 +7,7 @@
 % - with framing allowing page breaks ("framed.sty")
 % - with breaking of long lines (exploits Pygments mark-up),
 % - with possibly of a top caption, non-separable by pagebreak.
-% - and usable inside tables or footnotes ("footnotehyper-sphinx").
+% - and usable inside tables or footnotes ("sphinxpackagefootnote.sty").
 
 % Prior to Sphinx 1.5, \Verbatim and \endVerbatim were modified by Sphinx.
 % The aliases defined here are used in sphinxVerbatim environment and can
diff --git a/sphinx/texinputs/sphinxlatexrequirepackages.sty b/sphinx/texinputs/sphinxlatexrequirepackages.sty
index 5b5052a67d3..63f926cba14 100644
--- a/sphinx/texinputs/sphinxlatexrequirepackages.sty
+++ b/sphinx/texinputs/sphinxlatexrequirepackages.sty
@@ -36,7 +36,8 @@
 \RequirePackage{tabulary}
 % tabulary has a bug with its re-definition of \multicolumn in its first pass
 % which is not \long. But now Sphinx does not use LaTeX's \multicolumn but its
-% own macro. Hence we don't even need to patch tabulary. See sphinxmulticell.sty
+% own macro. Hence we don't even need to patch tabulary. See
+% sphinxpackagemulticell.sty
 % X or S (Sphinx) may have meanings if some table package is loaded hence
 % \X was chosen to avoid possibility of conflict
 \newcolumntype{\X}[2]{p{\dimexpr
@@ -164,7 +165,7 @@
       \unexpanded\expandafter{\@vwid@setup}}%
 }%
 % Homemade package to handle merged cells
-\RequirePackage{sphinxmulticell}
+\RequirePackage{sphinxpackagemulticell}
 \RequirePackage{makeidx}
 % For framing code-blocks and warning type notices, and shadowing topics
 \RequirePackage{framed}
@@ -182,7 +183,7 @@
 \sphinxresetverbatimhllines
 % For hyperlinked footnotes in tables; also for gathering footnotes from
 % topic and warning blocks. Also to allow code-blocks in footnotes.
-\RequirePackage{footnotehyper-sphinx}
+\RequirePackage{sphinxpackagefootnote}
 % For the H specifier. Do not \restylefloat{figure}, it breaks Sphinx code
 % for allowing figures in tables.
 \RequirePackage{float}
diff --git a/sphinx/texinputs/sphinxcyrillic.sty b/sphinx/texinputs/sphinxpackagecyrillic.sty
similarity index 98%
rename from sphinx/texinputs/sphinxcyrillic.sty
rename to sphinx/texinputs/sphinxpackagecyrillic.sty
index 6747b5ec64b..9aa62fc22ba 100644
--- a/sphinx/texinputs/sphinxcyrillic.sty
+++ b/sphinx/texinputs/sphinxpackagecyrillic.sty
@@ -1,7 +1,7 @@
 %% CYRILLIC IN NON-CYRILLIC DOCUMENTS (pdflatex only)
 %
 % refs: https://tex.stackexchange.com/q/460271/
-\ProvidesPackage{sphinxcyrillic}%
+\ProvidesPackage{sphinxpackagecyrillic}%
   [2018/11/21 v2.0 support for Cyrillic in non-Cyrillic documents]
 \RequirePackage{kvoptions}
 \SetupKeyvalOptions{prefix=spx@cyropt@} % use \spx@cyropt@ prefix
diff --git a/sphinx/texinputs/footnotehyper-sphinx.sty b/sphinx/texinputs/sphinxpackagefootnote.sty
similarity index 95%
rename from sphinx/texinputs/footnotehyper-sphinx.sty
rename to sphinx/texinputs/sphinxpackagefootnote.sty
index b6692cfb859..3d0b2268b68 100644
--- a/sphinx/texinputs/footnotehyper-sphinx.sty
+++ b/sphinx/texinputs/sphinxpackagefootnote.sty
@@ -1,8 +1,8 @@
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{footnotehyper-sphinx}%
- [2017/10/27 v1.7 hyperref aware footnote.sty for sphinx (JFB)]
+\ProvidesPackage{sphinxpackagefootnote}%
+ [2017/10/27 v1.7 footnotehyper adapted to sphinx (Sphinx team)]
 %%
-%% Package: footnotehyper-sphinx
+%% Package: sphinxpackagefootnote
 %% Version: based on footnotehyper.sty 2017/03/07 v1.0
 %% as available at https://www.ctan.org/pkg/footnotehyper
 %% License: the one applying to Sphinx
@@ -17,7 +17,7 @@
 %% 4. macro definition \sphinxfootnotemark,
 %% 5. macro definition \sphinxlongtablepatch
 %% 6. replaced an \undefined by \@undefined
-\DeclareOption*{\PackageWarning{footnotehyper-sphinx}{Option `\CurrentOption' is unknown}}%
+\DeclareOption*{\PackageWarning{sphinxpackagefootnote}{Option `\CurrentOption' is unknown}}%
 \ProcessOptions\relax
 \newbox\FNH@notes
 \newdimen\FNH@width
@@ -220,7 +220,7 @@
 }%
 % slight reformulation for Sphinx
 \def\FNH@bad@makefntext@alert{%
-  \PackageWarningNoLine{footnotehyper-sphinx}%
+  \PackageWarningNoLine{sphinxpackagefootnote}%
     {Footnotes will be sub-optimal, sorry. This is due to the document class or^^J
   some package modifying macro \string\@makefntext.^^J
   You can try to report this incompatibility at^^J
@@ -250,7 +250,7 @@
     \noexpand\if@endpe\noexpand\@endpetrue\noexpand\fi
   }%
 }%
-% end of footnotehyper 2017/02/16 v0.99
+%
 % some extras for Sphinx :
 % \sphinxfootnotemark: usable in section titles and silently removed from TOCs.
 \def\sphinxfootnotemark [#1]%
@@ -266,4 +266,4 @@
 }%
 \endinput
 %%
-%% End of file `footnotehyper-sphinx.sty'.
+%% End of file `sphinxpackagefootnote.sty'.
diff --git a/sphinx/texinputs/sphinxmulticell.sty b/sphinx/texinputs/sphinxpackagemulticell.sty
similarity index 98%
rename from sphinx/texinputs/sphinxmulticell.sty
rename to sphinx/texinputs/sphinxpackagemulticell.sty
index a6454918f3f..aed5219d3e7 100644
--- a/sphinx/texinputs/sphinxmulticell.sty
+++ b/sphinx/texinputs/sphinxpackagemulticell.sty
@@ -1,7 +1,8 @@
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{sphinxmulticell}%
+\ProvidesPackage{sphinxpackagemulticell}%
     [2017/02/23 v1.6 better span rows and columns of a table (Sphinx team)]%
-\DeclareOption*{\PackageWarning{sphinxmulticell}{Option `\CurrentOption' is unknown}}%
+\DeclareOption*{\PackageWarning{sphinxpackagemulticell}%
+               {Option `\CurrentOption' is unknown}}%
 \ProcessOptions\relax
 %
 % --- MULTICOLUMN ---
@@ -314,4 +315,4 @@
 }%
 \endinput
 %%
-%% End of file `sphinxmulticell.sty'.
+%% End of file `sphinxpackagemulticell.sty'.

From a327be4a77a69d064904dd7fadb01eb61a78bbab Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 27 Jan 2021 17:04:47 +0100
Subject: [PATCH 114/305] Update CHANGES for PR #8769

---
 CHANGES | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGES b/CHANGES
index 9b777a51c21..82bd96d5ac5 100644
--- a/CHANGES
+++ b/CHANGES
@@ -36,6 +36,8 @@ Incompatible changes
   cross-references
 * #4550: The ``align`` attribute of ``figure`` and ``table`` nodes becomes
   ``None`` by default instead of ``'default'``
+* #8769: LaTeX refactoring: split sphinx.sty into multiple files and rename
+  some auxiliary files created in ``latex`` build output repertory
 
 Deprecated
 ----------

From 953f4511a2956b2535e8e32e3c70d634aa76ed58 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 27 Jan 2021 17:28:36 +0100
Subject: [PATCH 115/305] Refactor LaTeX [3/2]: Add all missing .sty in the
 \ProvidesFile

Sorry for oversight
---
 sphinx/texinputs/sphinxlatexenvadmonitions.sty  | 2 +-
 sphinx/texinputs/sphinxlatexenvdocs.sty         | 2 +-
 sphinx/texinputs/sphinxlatexenvindbibtoc.sty    | 2 +-
 sphinx/texinputs/sphinxlatexenvliteral.sty      | 2 +-
 sphinx/texinputs/sphinxlatexenvshadowbox.sty    | 2 +-
 sphinx/texinputs/sphinxlatexgraphics.sty        | 2 +-
 sphinx/texinputs/sphinxlatexmiscfixme.sty       | 2 +-
 sphinx/texinputs/sphinxlatexmisclists.sty       | 2 +-
 sphinx/texinputs/sphinxlatexmiscnumbering.sty   | 2 +-
 sphinx/texinputs/sphinxlatexoptionhandling.sty  | 2 +-
 sphinx/texinputs/sphinxlatexrequirepackages.sty | 2 +-
 sphinx/texinputs/sphinxlatexstyleheadings.sty   | 2 +-
 sphinx/texinputs/sphinxlatexstylepage.sty       | 2 +-
 sphinx/texinputs/sphinxlatexstyletext.sty       | 2 +-
 14 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/sphinx/texinputs/sphinxlatexenvadmonitions.sty b/sphinx/texinputs/sphinxlatexenvadmonitions.sty
index c7d37bc2fdc..b23f29ef89b 100644
--- a/sphinx/texinputs/sphinxlatexenvadmonitions.sty
+++ b/sphinx/texinputs/sphinxlatexenvadmonitions.sty
@@ -1,7 +1,7 @@
 %% NOTICES AND ADMONITIONS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvadmonitions}[2021/01/27 admonitions]
+\ProvidesFile{sphinxlatexenvadmonitions.sty}[2021/01/27 admonitions]
 
 % Some are quite plain
 % the spx@notice@bordercolor etc are set in the sphinxadmonition environment
diff --git a/sphinx/texinputs/sphinxlatexenvdocs.sty b/sphinx/texinputs/sphinxlatexenvdocs.sty
index a05d30f2711..a95f97b6d86 100644
--- a/sphinx/texinputs/sphinxlatexenvdocs.sty
+++ b/sphinx/texinputs/sphinxlatexenvdocs.sty
@@ -1,7 +1,7 @@
 %% PYTHON DOCS MACROS AND ENVIRONMENTS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvdocs}[2021/01/27 documentation environments]
+\ProvidesFile{sphinxlatexenvdocs.sty}[2021/01/27 documentation environments]
 
 %  (some macros here used by \maketitle in sphinxmanual.cls and sphinxhowto.cls)
 
diff --git a/sphinx/texinputs/sphinxlatexenvindbibtoc.sty b/sphinx/texinputs/sphinxlatexenvindbibtoc.sty
index 61ed66897d5..5e58fb69bdf 100644
--- a/sphinx/texinputs/sphinxlatexenvindbibtoc.sty
+++ b/sphinx/texinputs/sphinxlatexenvindbibtoc.sty
@@ -1,7 +1,7 @@
 %% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvindbibtoc}[2021/01/27 index, bib., toc]
+\ProvidesFile{sphinxlatexenvindbibtoc.sty}[2021/01/27 index, bib., toc]
 
 % fix the double index and bibliography on the table of contents
 % in jsclasses (Japanese standard document classes)
diff --git a/sphinx/texinputs/sphinxlatexenvliteral.sty b/sphinx/texinputs/sphinxlatexenvliteral.sty
index 079914c22c7..c1e2a5d2843 100644
--- a/sphinx/texinputs/sphinxlatexenvliteral.sty
+++ b/sphinx/texinputs/sphinxlatexenvliteral.sty
@@ -1,7 +1,7 @@
 %% LITERAL BLOCKS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvliteral}[2021/01/27 code-blocks and parsed literals]
+\ProvidesFile{sphinxlatexenvliteral.sty}[2021/01/27 code-blocks and parsed literals]
 
 % Based on use of "fancyvrb.sty"'s Verbatim.
 % - with framing allowing page breaks ("framed.sty")
diff --git a/sphinx/texinputs/sphinxlatexenvshadowbox.sty b/sphinx/texinputs/sphinxlatexenvshadowbox.sty
index dbc080039bf..12fb3b7b8a2 100644
--- a/sphinx/texinputs/sphinxlatexenvshadowbox.sty
+++ b/sphinx/texinputs/sphinxlatexenvshadowbox.sty
@@ -1,7 +1,7 @@
 %% TOPIC AND CONTENTS BOXES
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvshadowbox}[2021/01/27 topic and contents boxes]
+\ProvidesFile{sphinxlatexenvshadowbox.sty}[2021/01/27 topic and contents boxes]
 
 % Again based on use of "framed.sty", this allows breakable framed boxes.
 \long\def\spx@ShadowFBox#1{%
diff --git a/sphinx/texinputs/sphinxlatexgraphics.sty b/sphinx/texinputs/sphinxlatexgraphics.sty
index c2f7cc783aa..4a16fe990dd 100644
--- a/sphinx/texinputs/sphinxlatexgraphics.sty
+++ b/sphinx/texinputs/sphinxlatexgraphics.sty
@@ -1,7 +1,7 @@
 %% GRAPHICS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexgraphics}[2021/01/27 graphics]
+\ProvidesFile{sphinxlatexgraphics.sty}[2021/01/27 graphics]
 
 % \sphinxincludegraphics resizes images larger than the TeX \linewidth (which
 % is adjusted in indented environments), or taller than a certain maximal
diff --git a/sphinx/texinputs/sphinxlatexmiscfixme.sty b/sphinx/texinputs/sphinxlatexmiscfixme.sty
index 2c086ae0a3e..9ee905ed7b5 100644
--- a/sphinx/texinputs/sphinxlatexmiscfixme.sty
+++ b/sphinx/texinputs/sphinxlatexmiscfixme.sty
@@ -1,7 +1,7 @@
 %% FIXME STUFF attention, changes here may necessitate changes elsewhere
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexmiscfixme}[2021/01/27 latex to be removed at some point]
+\ProvidesFile{sphinxlatexmiscfixme.sty}[2021/01/27 latex to be removed at some point]
 
 %% COLOR (general)
 %
diff --git a/sphinx/texinputs/sphinxlatexmisclists.sty b/sphinx/texinputs/sphinxlatexmisclists.sty
index 8a0dc72e981..a7691b9b990 100644
--- a/sphinx/texinputs/sphinxlatexmisclists.sty
+++ b/sphinx/texinputs/sphinxlatexmisclists.sty
@@ -1,7 +1,7 @@
 %% ALPHANUMERIC LIST ITEMS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexmisclists}[2021/01/27 lists]
+\ProvidesFile{sphinxlatexmisclists.sty}[2021/01/27 lists]
 
 \newcommand\sphinxsetlistlabels[5]
 {% #1 = style, #2 = enum, #3 = enumnext, #4 = prefix, #5 = suffix
diff --git a/sphinx/texinputs/sphinxlatexmiscnumbering.sty b/sphinx/texinputs/sphinxlatexmiscnumbering.sty
index acd9243fe9e..a5c524ab308 100644
--- a/sphinx/texinputs/sphinxlatexmiscnumbering.sty
+++ b/sphinx/texinputs/sphinxlatexmiscnumbering.sty
@@ -1,7 +1,7 @@
 %% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexmiscnumbering}[2021/01/27 numbering]
+\ProvidesFile{sphinxlatexmiscnumbering.sty}[2021/01/27 numbering]
 
 % Everything is delayed to \begin{document} to allow hyperref patches into
 %   \newcounter to solve duplicate label problems for internal hyperlinks to
diff --git a/sphinx/texinputs/sphinxlatexoptionhandling.sty b/sphinx/texinputs/sphinxlatexoptionhandling.sty
index ad8cd75c74d..d71be4f81b0 100644
--- a/sphinx/texinputs/sphinxlatexoptionhandling.sty
+++ b/sphinx/texinputs/sphinxlatexoptionhandling.sty
@@ -1,7 +1,7 @@
 %% OPTION HANDLING
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexoptionhandling}[2021/01/27 option handling]
+\ProvidesFile{sphinxlatexoptionhandling.sty}[2021/01/27 option handling]
 
 % Handle options via "kvoptions" (later loaded by hyperref anyhow)
 \RequirePackage{kvoptions}
diff --git a/sphinx/texinputs/sphinxlatexrequirepackages.sty b/sphinx/texinputs/sphinxlatexrequirepackages.sty
index 63f926cba14..765e61e8c57 100644
--- a/sphinx/texinputs/sphinxlatexrequirepackages.sty
+++ b/sphinx/texinputs/sphinxlatexrequirepackages.sty
@@ -1,7 +1,7 @@
 %% PACKAGES
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexrequirepackages}[2021/01/27 packages]
+\ProvidesFile{sphinxlatexrequirepackages.sty}[2021/01/27 packages]
 
 \RequirePackage{graphicx}
 \@ifclassloaded{memoir}{}{\RequirePackage{fancyhdr}}
diff --git a/sphinx/texinputs/sphinxlatexstyleheadings.sty b/sphinx/texinputs/sphinxlatexstyleheadings.sty
index 4e99655563a..177fe8c1f37 100644
--- a/sphinx/texinputs/sphinxlatexstyleheadings.sty
+++ b/sphinx/texinputs/sphinxlatexstyleheadings.sty
@@ -1,7 +1,7 @@
 % change this info string if making any custom modification
 %% TITLES
 %
-\ProvidesFile{sphinxlatexstyleheadings}[2021/01/27 headings]
+\ProvidesFile{sphinxlatexstyleheadings.sty}[2021/01/27 headings]
 
 % Since Sphinx 1.5, users should use HeaderFamily key to 'sphinxsetup' rather
 % than defining their own \py@HeaderFamily command (which is still possible).
diff --git a/sphinx/texinputs/sphinxlatexstylepage.sty b/sphinx/texinputs/sphinxlatexstylepage.sty
index b259741e394..d9b993c7678 100644
--- a/sphinx/texinputs/sphinxlatexstylepage.sty
+++ b/sphinx/texinputs/sphinxlatexstylepage.sty
@@ -1,7 +1,7 @@
 %% PAGE STYLING
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexstylepage}[2021/01/27 page styling]
+\ProvidesFile{sphinxlatexstylepage.sty}[2021/01/27 page styling]
 
 % Style parameters and macros used by most documents here
 \raggedbottom
diff --git a/sphinx/texinputs/sphinxlatexstyletext.sty b/sphinx/texinputs/sphinxlatexstyletext.sty
index cfb8714e37b..08d7a693517 100644
--- a/sphinx/texinputs/sphinxlatexstyletext.sty
+++ b/sphinx/texinputs/sphinxlatexstyletext.sty
@@ -1,7 +1,7 @@
 %% TEXT STYLING
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexstyletext}[2021/01/27 text styling]
+\ProvidesFile{sphinxlatexstyletext.sty}[2021/01/27 text styling]
 
 % to obtain straight quotes we execute \@noligs as patched by upquote, and
 % \scantokens is needed in cases where it would be too late for the macro to

From b25948590d487ab85acc735e0f2d4a98c88f3bdd Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 27 Jan 2021 17:32:31 +0100
Subject: [PATCH 116/305] Refactor LaTeX [4/2]: suppress extra bracket from bad
 latex merge :(

---
 sphinx/texinputs/sphinxpackagefootnote.sty | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/texinputs/sphinxpackagefootnote.sty b/sphinx/texinputs/sphinxpackagefootnote.sty
index 520efd33d58..02c729c96aa 100644
--- a/sphinx/texinputs/sphinxpackagefootnote.sty
+++ b/sphinx/texinputs/sphinxpackagefootnote.sty
@@ -1,6 +1,6 @@
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{sphinxpackagefootnote}%
- [2021/01/26 v1.1b footnotehyper adapted to sphinx (Sphinx team)]]
+ [2021/01/26 v1.1b footnotehyper adapted to sphinx (Sphinx team)]
 %%
 %% Package: sphinxpackagefootnote
 %% Version: based on footnotehyper.sty 2021/01/26 v1.1b

From 365ae80cc403cc3c6c57227110876f549bc08904 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 27 Jan 2021 18:44:56 +0100
Subject: [PATCH 117/305] Revert alteration at c9480f994 merge of 3.x of
 doc/conf.py

Compare doc/conf.py after merge at c9480f994 to what it was at 2ee033838.

It loses the modification from #8716 (merged at 38c614347) and thus
reverts doc/conf.py to former font config using mathpazo.
---
 doc/conf.py | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index 53f036d3e2f..45ce52f9664 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -58,17 +58,6 @@
 latex_logo = '_static/sphinx.png'
 latex_elements = {
     'fontenc': r'\usepackage[LGR,X2,T1]{fontenc}',
-    'fontpkg': r'''
-\usepackage[sc]{mathpazo}
-\usepackage[scaled]{helvet}
-\usepackage{courier}
-\substitutefont{LGR}{\rmdefault}{cmr}
-\substitutefont{LGR}{\sfdefault}{cmss}
-\substitutefont{LGR}{\ttdefault}{cmtt}
-\substitutefont{X2}{\rmdefault}{cmr}
-\substitutefont{X2}{\sfdefault}{cmss}
-\substitutefont{X2}{\ttdefault}{cmtt}
-''',
     'passoptionstopackages': r'''
 \PassOptionsToPackage{svgnames}{xcolor}
 \PassOptionsToPackage{bookmarksdepth=3}{hyperref}% depth of pdf bookmarks
@@ -78,7 +67,6 @@
 \setcounter{tocdepth}{3}%    depth of what is kept from toc file
 \setcounter{secnumdepth}{1}% depth of section numbering
 ''',
-    'fvset': '\\fvset{fontsize=auto}',
     # fix missing index entry due to RTD doing only once pdflatex after makeindex
     'printindex': r'''
 \IfFileExists{\jobname.ind}

From 0c0be64ece1cfca1f20d4918bb9af67089ca8c4d Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 27 Jan 2021 18:20:11 +0100
Subject: [PATCH 118/305] Refactor LaTeX style files

This is a (continuation and) re-work of #8769 (e6bf9145dc)

I have reintegrated option handling and most package loading into the
original file sphinx.sty and reorganized completely the filenames of
secondary style files.

sphinx.sty had become too big and first #8769 now this more definitive
refactoring is necessary to clarify structure, dependencies, and ease up
future maintenance.

Unfortunately this means a lot of moving around hunks of latex code with
some alterations.  I tried to carefully check everything is defined in
right order (as LaTeX being a macro expansion language, often one can
manipulate things before them being defined, nevertheless I checked
things are done in order).

Only simple thing is to review is that I added missing EOLs at last
lines of the extracted files...
---
 sphinx/texinputs/sphinx.sty                   | 298 ++++++++++++++----
 ...nitions.sty => sphinxlatexadmonitions.sty} |   4 +-
 ...indbibtoc.sty => sphinxlatexindbibtoc.sty} |   9 +-
 ...atexmisclists.sty => sphinxlatexlists.sty} |   2 +-
 ...envliteral.sty => sphinxlatexliterals.sty} |  64 +++-
 sphinx/texinputs/sphinxlatexmiscfixme.sty     |  18 --
 ...iscnumbering.sty => sphinxlatexnumfig.sty} |   6 +-
 ...atexenvdocs.sty => sphinxlatexobjects.sty} |   4 +-
 .../texinputs/sphinxlatexoptionhandling.sty   | 139 --------
 .../texinputs/sphinxlatexrequirepackages.sty  | 242 --------------
 ...shadowbox.sty => sphinxlatexshadowbox.sty} |   2 +-
 sphinx/texinputs/sphinxlatexstyleheadings.sty |  29 +-
 sphinx/texinputs/sphinxlatexstylepage.sty     |  60 +---
 sphinx/texinputs/sphinxlatexstyletext.sty     |  43 ---
 ...agemulticell.sty => sphinxlatextables.sty} | 153 ++++++++-
 sphinx/texinputs/sphinxoptionsgeometry.sty    |  54 ++++
 sphinx/texinputs/sphinxoptionshyperref.sty    |  35 ++
 17 files changed, 594 insertions(+), 568 deletions(-)
 rename sphinx/texinputs/{sphinxlatexenvadmonitions.sty => sphinxlatexadmonitions.sty} (98%)
 rename sphinx/texinputs/{sphinxlatexenvindbibtoc.sty => sphinxlatexindbibtoc.sty} (91%)
 rename sphinx/texinputs/{sphinxlatexmisclists.sty => sphinxlatexlists.sty} (98%)
 rename sphinx/texinputs/{sphinxlatexenvliteral.sty => sphinxlatexliterals.sty} (88%)
 delete mode 100644 sphinx/texinputs/sphinxlatexmiscfixme.sty
 rename sphinx/texinputs/{sphinxlatexmiscnumbering.sty => sphinxlatexnumfig.sty} (95%)
 rename sphinx/texinputs/{sphinxlatexenvdocs.sty => sphinxlatexobjects.sty} (97%)
 delete mode 100644 sphinx/texinputs/sphinxlatexoptionhandling.sty
 delete mode 100644 sphinx/texinputs/sphinxlatexrequirepackages.sty
 rename sphinx/texinputs/{sphinxlatexenvshadowbox.sty => sphinxlatexshadowbox.sty} (97%)
 rename sphinx/texinputs/{sphinxpackagemulticell.sty => sphinxlatextables.sty} (68%)
 create mode 100644 sphinx/texinputs/sphinxoptionsgeometry.sty
 create mode 100644 sphinx/texinputs/sphinxoptionshyperref.sty

diff --git a/sphinx/texinputs/sphinx.sty b/sphinx/texinputs/sphinx.sty
index 00722a52afe..39ca85611ef 100644
--- a/sphinx/texinputs/sphinx.sty
+++ b/sphinx/texinputs/sphinx.sty
@@ -31,105 +31,293 @@
   }}
 
 
-%% PACKAGES
+%% OPTION HANDLING
 %
-% we delay handling of options to after having loaded packages, because
-% of the need to use \definecolor.
-\input{sphinxlatexrequirepackages.sty}
 
+% We first handle options then load packages, but we need \definecolor from
+% xcolor/color.
 
-%% PYGMENTS
-% stylesheet for highlighting with pygments
-\RequirePackage{sphinxhighlight}
-% fix baseline increase from Pygments latex formatter in case of error tokens
-% and keep \fboxsep's scope local via added braces
-\def\PYG@tok@err{%
-    \def\PYG@bc##1{{\setlength{\fboxsep}{-\fboxrule}%
-                    \fcolorbox[rgb]{1.00,0.00,0.00}{1,1,1}{\strut ##1}}}%
+% FIXME: we should \RequirePackage{xcolor} always now
+% The xcolor package draws better fcolorboxes around verbatim code
+\IfFileExists{xcolor.sty}{
+    \RequirePackage{xcolor}
+}{
+    \RequirePackage{color}
 }
-\def\PYG@tok@cs{%
-    \def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}%
-    \def\PYG@bc##1{{\setlength{\fboxsep}{0pt}%
-                    \colorbox[rgb]{1.00,0.94,0.94}{\strut ##1}}}%
-}%
-
 
-%% OPTION HANDLING
+% Handle options via "kvoptions" (later loaded by hyperref anyhow)
+\RequirePackage{kvoptions}
+\SetupKeyvalOptions{prefix=spx@opt@} % use \spx@opt@ prefix
+
+% Sphinx legacy text layout: 1in margins on all four sides
+\ifx\@jsc@uplatextrue\@undefined
+\DeclareStringOption[1in]{hmargin}
+\DeclareStringOption[1in]{vmargin}
+\DeclareStringOption[.5in]{marginpar}
+\else
+% Japanese standard document classes handle \mag in a special way
+\DeclareStringOption[\inv@mag in]{hmargin}
+\DeclareStringOption[\inv@mag in]{vmargin}
+\DeclareStringOption[.5\dimexpr\inv@mag in\relax]{marginpar}
+\fi
+
+\DeclareStringOption[0]{maxlistdepth}% \newcommand*\spx@opt@maxlistdepth{0}
+\DeclareStringOption[-1]{numfigreset}
+\DeclareBoolOption[false]{nonumfigreset}
+\DeclareBoolOption[false]{mathnumfig}
+% \DeclareBoolOption[false]{usespart}% not used
+% dimensions, we declare the \dimen registers here.
+\newdimen\sphinxverbatimsep
+\newdimen\sphinxverbatimborder
+\newdimen\sphinxshadowsep
+\newdimen\sphinxshadowsize
+\newdimen\sphinxshadowrule
+% \DeclareStringOption is not convenient for the handling of these dimensions
+% because we want to assign the values to the corresponding registers. Even if
+% we added the code to the key handler it would be too late for the initial
+% set-up and we would need to do initial assignments explicitely. We end up
+% using \define@key directly.
+% verbatim
+\sphinxverbatimsep=\fboxsep
+  \define@key{sphinx}{verbatimsep}{\sphinxverbatimsep\dimexpr #1\relax}
+\sphinxverbatimborder=\fboxrule
+  \define@key{sphinx}{verbatimborder}{\sphinxverbatimborder\dimexpr #1\relax}
+% topic boxes
+\sphinxshadowsep =5pt
+  \define@key{sphinx}{shadowsep}{\sphinxshadowsep\dimexpr #1\relax}
+\sphinxshadowsize=4pt
+  \define@key{sphinx}{shadowsize}{\sphinxshadowsize\dimexpr #1\relax}
+\sphinxshadowrule=\fboxrule
+  \define@key{sphinx}{shadowrule}{\sphinxshadowrule\dimexpr #1\relax}
+% verbatim
+\DeclareBoolOption[true]{verbatimwithframe}
+\DeclareBoolOption[true]{verbatimwrapslines}
+\DeclareBoolOption[true]{verbatimhintsturnover}
+\DeclareBoolOption[true]{inlineliteralwraps}
+\DeclareStringOption[t]{literalblockcappos}
+\DeclareStringOption[r]{verbatimcontinuedalign}
+\DeclareStringOption[r]{verbatimcontinuesalign}
+% parsed literal
+\DeclareBoolOption[true]{parsedliteralwraps}
+% \textvisiblespace for compatibility with fontspec+XeTeX/LuaTeX
+\DeclareStringOption[\textcolor{red}{\textvisiblespace}]{verbatimvisiblespace}
+\DeclareStringOption % must use braces to hide the brackets
+  [{\makebox[2\fontcharwd\font`\x][r]{\textcolor{red}{\tiny$\m@th\hookrightarrow$}}}]%
+  {verbatimcontinued}
+% notices/admonitions
+% the dimensions for notices/admonitions are kept as macros and assigned to
+% \spx@notice@border at time of use, hence \DeclareStringOption is ok for this
+\newdimen\spx@notice@border
+\DeclareStringOption[0.5pt]{noteborder}
+\DeclareStringOption[0.5pt]{hintborder}
+\DeclareStringOption[0.5pt]{importantborder}
+\DeclareStringOption[0.5pt]{tipborder}
+\DeclareStringOption[1pt]{warningborder}
+\DeclareStringOption[1pt]{cautionborder}
+\DeclareStringOption[1pt]{attentionborder}
+\DeclareStringOption[1pt]{dangerborder}
+\DeclareStringOption[1pt]{errorborder}
+% footnotes
+\DeclareStringOption[\mbox{ }]{AtStartFootnote}
+% we need a public macro name for direct use in latex file
+\newcommand*{\sphinxAtStartFootnote}{\spx@opt@AtStartFootnote}
+% no such need for this one, as it is used inside other macros
+\DeclareStringOption[\leavevmode\unskip]{BeforeFootnote}
+% some font styling.
+\DeclareStringOption[\sffamily\bfseries]{HeaderFamily}
+% colours
+% same problems as for dimensions: we want the key handler to use \definecolor.
+% first, some colours with no prefix, for backwards compatibility
+\newcommand*{\sphinxDeclareColorOption}[2]{%
+   \definecolor{#1}#2%
+   \define@key{sphinx}{#1}{\definecolor{#1}##1}%
+}%
+\sphinxDeclareColorOption{TitleColor}{{rgb}{0.126,0.263,0.361}}
+\sphinxDeclareColorOption{InnerLinkColor}{{rgb}{0.208,0.374,0.486}}
+\sphinxDeclareColorOption{OuterLinkColor}{{rgb}{0.216,0.439,0.388}}
+\sphinxDeclareColorOption{VerbatimColor}{{rgb}{1,1,1}}
+\sphinxDeclareColorOption{VerbatimBorderColor}{{rgb}{0,0,0}}
+% now the colours defined with "sphinx" prefix in their names
+\newcommand*{\sphinxDeclareSphinxColorOption}[2]{%
+   % set the initial default
+   \definecolor{sphinx#1}#2%
+   % set the key handler. The "value" ##1 must be acceptable by \definecolor.
+   \define@key{sphinx}{#1}{\definecolor{sphinx#1}##1}%
+}%
+% Default color chosen to be as in minted.sty LaTeX package!
+\sphinxDeclareSphinxColorOption{VerbatimHighlightColor}{{rgb}{0.878,1,1}}
+% admonition boxes, "light" style
+\sphinxDeclareSphinxColorOption{noteBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{hintBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{importantBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{tipBorderColor}{{rgb}{0,0,0}}
+% admonition boxes, "heavy" style
+\sphinxDeclareSphinxColorOption{warningBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{cautionBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{attentionBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{dangerBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{errorBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{warningBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{cautionBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{attentionBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{dangerBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{errorBgColor}{{rgb}{1,1,1}}
+
+\DeclareDefaultOption{\@unknownoptionerror}
+\ProcessKeyvalOptions*
+% don't allow use of maxlistdepth via \sphinxsetup.
+\DisableKeyvalOption{sphinx}{maxlistdepth}
+\DisableKeyvalOption{sphinx}{numfigreset}
+\DisableKeyvalOption{sphinx}{nonumfigreset}
+\DisableKeyvalOption{sphinx}{mathnumfig}
+% FIXME: this is unrelated to an option, move this elsewhere
+% To allow hyphenation of first word in narrow contexts; no option,
+% customization to be done via 'preamble' key
+\newcommand*\sphinxAtStartPar{\nobreak\hskip\z@skip}
+% No need for the \hspace{0pt} trick (\hskip\z@skip) with luatex
+\ifdefined\directlua\let\sphinxAtStartPar\@empty\fi
+% user interface: options can be changed midway in a document!
+\newcommand\sphinxsetup[1]{\setkeys{sphinx}{#1}}
+
+
+%% PASS OPTIONS
 %
-\input{sphinxlatexoptionhandling.sty}
+% pass options to hyperref; it must not have been loaded already
+\input{sphinxoptionshyperref.sty}
+% pass options to geometry; it must not have been loaded already
+\input{sphinxoptionsgeometry.sty}
 
 
-%% LISTS
+%% COLOR (general)
 %
-\input{sphinxlatexmisclists.sty}
-
-
-%% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS
+% FIXME: these two should be deprecated
 %
-\input{sphinxlatexenvindbibtoc.sty}
+% FIXME: \normalcolor should be used and \py@NormalColor never defined
+\def\py@NormalColor{\color{black}}
+% FIXME: \color{TitleColor} should be used directly and \py@TitleColor
+% should never get defined.
+\def\py@TitleColor{\color{TitleColor}}
 
 
-%% FIXME STUFF
-%
-\input{sphinxlatexmiscfixme.sty}
-
-
-%% PAGE STYLING
+%% PACKAGES
 %
-\input{sphinxlatexstylepage.sty}
-
-
-%% TITLES
+% as will be indicated below, secondary style files load some more packages
 %
-\input{sphinxlatexstyleheadings.sty}
+% for \text macro and \iffirstchoice@ conditional even if amsmath not loaded
+\RequirePackage{amstext}
+% it was passed "warn" option from latex template
+\RequirePackage{textcomp}
+% For the H specifier. Do not \restylefloat{figure}, it breaks Sphinx code
+% for allowing figures in tables.
+\RequirePackage{float}
+% For floating figures in the text. Better to load after float.
+\RequirePackage{wrapfig}
+% control caption around literal-block
+\RequirePackage{capt-of}
+\RequirePackage{needspace}
+% support hlist directive
+\RequirePackage{multicol}
 
 
 %% GRAPHICS
 %
+\RequirePackage{graphicx}
 \input{sphinxlatexgraphics.sty}
 
 
-%% CITATIONS
+%% FRAMED ENVIRONMENTS
+% For framing code-blocks and warning type notices, and shadowing topics
+\RequirePackage{framed}
 %
-\protected\def\sphinxcite{\cite}
+% macros and environment for display literals (sphinxVerbatim, sphinxalltt)
+% and inline literals (\sphinxupquote); also defines \sphinxhref.
+% Requires: fancyvrb, alltt, upquote
+\input{sphinxlatexliterals.sty}
+%
+% topic and contents boxes: sphinxShadowBox uses framed.sty
+\input{sphinxlatexshadowbox.sty}
+%
+% notices and admonitions: sphinxheavybox uses again framed.sty
+\input{sphinxlatexadmonitions.sty}
 
 
-%% FOOTNOTES
+%% PYGMENTS
+% stylesheet for highlighting with pygments
+\RequirePackage{sphinxhighlight}
+% fix baseline increase from Pygments latex formatter in case of error tokens
+% and keep \fboxsep's scope local via added braces
+\def\PYG@tok@err{%
+    \def\PYG@bc##1{{\setlength{\fboxsep}{-\fboxrule}%
+                    \fcolorbox[rgb]{1.00,0.00,0.00}{1,1,1}{\strut ##1}}}%
+}
+\def\PYG@tok@cs{%
+    \def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}%
+    \def\PYG@bc##1{{\setlength{\fboxsep}{0pt}%
+                    \colorbox[rgb]{1.00,0.94,0.94}{\strut ##1}}}%
+}%
+
+
+%% TABLES
 %
-% Support large numbered footnotes in minipage
-% But now obsolete due to systematic use of \savenotes/\spewnotes
-% when minipages are in use in the various macro definitions next.
-\def\thempfootnote{\arabic{mpfootnote}}
+% Requires: tabulary, longtable, varwidth
+% extends tabulary and longtable via patches and custom macros to support
+% merged cells possibly containing code-blocks in complex tables
+\input{sphinxlatextables.sty}
 
 
 %% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS
 %
-\input{sphinxlatexmiscnumbering.sty}
+% Requires: remreset (old LaTeX only)
+% relates to numfig and numfig_secnum_depth configuration variables
+\input{sphinxlatexnumfig.sty}
 
 
-%% LITERAL BLOCKS
+%% LISTS
 %
-\input{sphinxlatexenvliteral.sty}
+% optionally extends LaTeX maximal list nesting depth and provides
+% \sphinxsetlistlabels macro used in mark-up
+\input{sphinxlatexlists.sty}
 
 
-%% TOPIC AND CONTENTS BOXES
+%% FOOTNOTES
 %
-\input{sphinxlatexenvshadowbox.sty}
+% support large numbered footnotes in minipage; but this is now obsolete
+% from systematic use of savenotes environment around minipages
+\def\thempfootnote{\arabic{mpfootnote}}
+% this package provides savenotes environment (aka \savenotes/spewnotes)
+% For hyperlinked footnotes in tables; also for gathering footnotes from
+% topic and warning blocks. Also to allow code-blocks in footnotes.
+% Based on footnotehyper, extended to support tabulary multipass system
+\RequirePackage{sphinxpackagefootnote}
 
 
-%% NOTICES AND ADMONITIONS
+%% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS
 %
-\input{sphinxlatexenvadmonitions.sty}
+% requires makeidx
+\input{sphinxlatexindbibtoc.sty}
 
 
-%% PYTHON DOCS MACROS AND ENVIRONMENTS
+%% STYLING
 %
-\input{sphinxlatexenvdocs.sty}
+% page
+% requires parskip (legacy version) and, except if memoir class, fancyhdr
+\input{sphinxlatexstylepage.sty}
+% headings
+% requires titlesec and, if it is at 2.10.1, etoolbox to patch it
+\input{sphinxlatexstyleheadings.sty}
+% many \sphinx... prefixed commands to style text
+\input{sphinxlatexstyletext.sty}
 
 
-%% TEXT STYLING
+%% MODULE RELEASE DATA AND OBJECT DESCRIPTIONS
 %
-\input{sphinxlatexstyletext.sty}
+% this legacy code has remained very stable over the years
+% (fulllineitems was updated to support multiline signatures)
+\input{sphinxlatexobjects.sty}
+
+
+% FIXME: this line should be dropped, as "9" is default anyhow.
+\ifdefined\pdfcompresslevel\pdfcompresslevel = 9 \fi
 
 
 \endinput
diff --git a/sphinx/texinputs/sphinxlatexenvadmonitions.sty b/sphinx/texinputs/sphinxlatexadmonitions.sty
similarity index 98%
rename from sphinx/texinputs/sphinxlatexenvadmonitions.sty
rename to sphinx/texinputs/sphinxlatexadmonitions.sty
index b23f29ef89b..c9307754885 100644
--- a/sphinx/texinputs/sphinxlatexenvadmonitions.sty
+++ b/sphinx/texinputs/sphinxlatexadmonitions.sty
@@ -1,7 +1,7 @@
 %% NOTICES AND ADMONITIONS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvadmonitions.sty}[2021/01/27 admonitions]
+\ProvidesFile{sphinxlatexadmonitions.sty}[2021/01/27 admonitions]
 
 % Some are quite plain
 % the spx@notice@bordercolor etc are set in the sphinxadmonition environment
@@ -119,4 +119,4 @@
   % workaround some LaTeX "feature" of \end command
  {\edef\spx@temp{\noexpand\end{sphinx\spx@noticetype}}\spx@temp}
 
-\endinput
\ No newline at end of file
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexenvindbibtoc.sty b/sphinx/texinputs/sphinxlatexindbibtoc.sty
similarity index 91%
rename from sphinx/texinputs/sphinxlatexenvindbibtoc.sty
rename to sphinx/texinputs/sphinxlatexindbibtoc.sty
index 5e58fb69bdf..b5f7ab94452 100644
--- a/sphinx/texinputs/sphinxlatexenvindbibtoc.sty
+++ b/sphinx/texinputs/sphinxlatexindbibtoc.sty
@@ -1,7 +1,9 @@
 %% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvindbibtoc.sty}[2021/01/27 index, bib., toc]
+\ProvidesFile{sphinxlatexindbibtoc.sty}[2021/01/27 index, bib., toc]
+
+\RequirePackage{makeidx}
 
 % fix the double index and bibliography on the table of contents
 % in jsclasses (Japanese standard document classes)
@@ -44,4 +46,7 @@
 \newcommand*{\sphinxsymbolsname}{}
 \newcommand*{\sphinxnumbersname}{}
 
-\endinput
\ No newline at end of file
+\protected\def\sphinxcite{\cite}
+
+
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexmisclists.sty b/sphinx/texinputs/sphinxlatexlists.sty
similarity index 98%
rename from sphinx/texinputs/sphinxlatexmisclists.sty
rename to sphinx/texinputs/sphinxlatexlists.sty
index a7691b9b990..dd474f9a8b6 100644
--- a/sphinx/texinputs/sphinxlatexmisclists.sty
+++ b/sphinx/texinputs/sphinxlatexlists.sty
@@ -1,7 +1,7 @@
 %% ALPHANUMERIC LIST ITEMS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexmisclists.sty}[2021/01/27 lists]
+\ProvidesFile{sphinxlatexlists.sty}[2021/01/27 lists]
 
 \newcommand\sphinxsetlistlabels[5]
 {% #1 = style, #2 = enum, #3 = enumnext, #4 = prefix, #5 = suffix
diff --git a/sphinx/texinputs/sphinxlatexenvliteral.sty b/sphinx/texinputs/sphinxlatexliterals.sty
similarity index 88%
rename from sphinx/texinputs/sphinxlatexenvliteral.sty
rename to sphinx/texinputs/sphinxlatexliterals.sty
index c1e2a5d2843..1238a9e92f1 100644
--- a/sphinx/texinputs/sphinxlatexenvliteral.sty
+++ b/sphinx/texinputs/sphinxlatexliterals.sty
@@ -1,7 +1,18 @@
 %% LITERAL BLOCKS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvliteral.sty}[2021/01/27 code-blocks and parsed literals]
+\ProvidesFile{sphinxlatexliterals.sty}[2021/01/27 code-blocks and parsed literals]
+
+% For highlighted code.
+\RequirePackage{fancyvrb}
+\define@key{FV}{hllines}{\def\sphinx@verbatim@checkifhl##1{\in@{, ##1,}{#1}}}
+% sphinxVerbatim must be usable by third party without requiring hllines set-up
+\def\sphinxresetverbatimhllines{\def\sphinx@verbatim@checkifhl##1{\in@false}}
+\sphinxresetverbatimhllines
+% For parsed-literal blocks.
+\RequirePackage{alltt}
+% Display "real" single quotes in literal blocks.
+\RequirePackage{upquote}
 
 % Based on use of "fancyvrb.sty"'s Verbatim.
 % - with framing allowing page breaks ("framed.sty")
@@ -459,6 +470,10 @@
  \fi }
 {\end{alltt}}
 
+
+%% INLINE MARK-UP
+%
+
 % Protect \href's first argument in contexts such as sphinxalltt (or
 % \sphinxcode). Sphinx uses \#, \%, \& ... always inside \sphinxhref.
 \protected\def\sphinxhref#1#2{{%
@@ -477,4 +492,49 @@
     \endlinechar\m@ne\scantokens{\nolinkurl{#1}}%
 }}
 
-\endinput
\ No newline at end of file
+% \sphinxupquote
+% to obtain straight quotes we execute \@noligs as patched by upquote, and
+% \scantokens is needed in cases where it would be too late for the macro to
+% first set catcodes and then fetch its argument. We also make the contents
+% breakable at non-escaped . , ; ? ! / using \sphinxbreaksviaactive,
+% and also at \ character (which is escaped to \textbackslash{}).
+\protected\def\sphinxtextbackslashbreakbefore
+ {\discretionary{}{\sphinxafterbreak\sphinx@textbackslash}{\sphinx@textbackslash}}
+\protected\def\sphinxtextbackslashbreakafter
+ {\discretionary{\sphinx@textbackslash}{\sphinxafterbreak}{\sphinx@textbackslash}}
+\let\sphinxtextbackslash\sphinxtextbackslashbreakafter
+% the macro must be protected if it ends up used in moving arguments,
+% in 'alltt' \@noligs is done already, and the \scantokens must be avoided.
+\protected\def\sphinxupquote#1{{\def\@tempa{alltt}%
+  \ifx\@tempa\@currenvir\else
+   \ifspx@opt@inlineliteralwraps
+      % break at . , ; ? ! /
+      \sphinxbreaksviaactive
+      % break also at \
+      \let\sphinx@textbackslash\textbackslash
+      \let\textbackslash\sphinxtextbackslash
+      % by default, no continuation symbol on next line but may be added
+      \let\sphinxafterbreak\sphinxafterbreakofinlineliteral
+      % do not overwrite the comma set-up
+      \let\verbatim@nolig@list\sphinx@literal@nolig@list
+   \fi
+   % fix a space-gobbling issue due to LaTeX's original \do@noligs
+% TODO: using \@noligs as patched by upquote.sty is now unneeded because
+% either ` and ' are escaped (non-unicode engines) or they don't build
+% ligatures (unicode engines). Thus remove this and unify handling of `, <, >,
+% ' and - with the characters . , ; ? ! / as handled via
+% \sphinxbreaksviaactive.
+% Hence \sphinx@do@noligs will be removed, or rather replaced  with code
+% inserting discretionaries, as they allow a continuation symbol on start of
+% next line to achieve common design with code-blocks.
+   \let\do@noligs\sphinx@do@noligs
+   \@noligs\endlinechar\m@ne\everyeof{}% (<- in case inside \sphinxhref)
+   \expandafter\scantokens
+  \fi {{#1}}}}% extra brace pair to fix end-space gobbling issue...
+\def\sphinx@do@noligs #1{\catcode`#1\active\begingroup\lccode`\~`#1\relax
+    \lowercase{\endgroup\def~{\leavevmode\kern\z@\char`#1 }}}
+\def\sphinx@literal@nolig@list {\do\`\do\<\do\>\do\'\do\-}%
+\let\sphinxafterbreakofinlineliteral\empty
+
+
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexmiscfixme.sty b/sphinx/texinputs/sphinxlatexmiscfixme.sty
deleted file mode 100644
index 9ee905ed7b5..00000000000
--- a/sphinx/texinputs/sphinxlatexmiscfixme.sty
+++ /dev/null
@@ -1,18 +0,0 @@
-%% FIXME STUFF attention, changes here may necessitate changes elsewhere
-%
-% change this info string if making any custom modification
-\ProvidesFile{sphinxlatexmiscfixme.sty}[2021/01/27 latex to be removed at some point]
-
-%% COLOR (general)
-%
-% FIXME: \normalcolor should probably be used in place of \py@NormalColor
-% elsewhere, and \py@NormalColor should never be defined. \normalcolor
-% switches to the colour from last \color call in preamble.
-\def\py@NormalColor{\color{black}}
-% FIXME: it is probably better to use \color{TitleColor}, as TitleColor
-% can be customized from 'sphinxsetup', and drop usage of \py@TitleColor
-\def\py@TitleColor{\color{TitleColor}}
-% FIXME: this line should be dropped, as "9" is default anyhow.
-\ifdefined\pdfcompresslevel\pdfcompresslevel = 9 \fi
-
-\endinput
\ No newline at end of file
diff --git a/sphinx/texinputs/sphinxlatexmiscnumbering.sty b/sphinx/texinputs/sphinxlatexnumfig.sty
similarity index 95%
rename from sphinx/texinputs/sphinxlatexmiscnumbering.sty
rename to sphinx/texinputs/sphinxlatexnumfig.sty
index a5c524ab308..fa6e674659e 100644
--- a/sphinx/texinputs/sphinxlatexmiscnumbering.sty
+++ b/sphinx/texinputs/sphinxlatexnumfig.sty
@@ -1,8 +1,12 @@
 %% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexmiscnumbering.sty}[2021/01/27 numbering]
+\ProvidesFile{sphinxlatexnumfig.sty}[2021/01/27 numbering]
 
+% LaTeX 2018-04-01 and later provides \@removefromreset
+\ltx@ifundefined{@removefromreset}
+    {\RequirePackage{remreset}}
+    {}% avoid warning
 % Everything is delayed to \begin{document} to allow hyperref patches into
 %   \newcounter to solve duplicate label problems for internal hyperlinks to
 %   code listings (literalblock counter).  User or extension re-definitions of
diff --git a/sphinx/texinputs/sphinxlatexenvdocs.sty b/sphinx/texinputs/sphinxlatexobjects.sty
similarity index 97%
rename from sphinx/texinputs/sphinxlatexenvdocs.sty
rename to sphinx/texinputs/sphinxlatexobjects.sty
index a95f97b6d86..c0e4ddc0ec7 100644
--- a/sphinx/texinputs/sphinxlatexenvdocs.sty
+++ b/sphinx/texinputs/sphinxlatexobjects.sty
@@ -1,7 +1,7 @@
-%% PYTHON DOCS MACROS AND ENVIRONMENTS
+%% MODULE RELEASE DATA AND OBJECT DESCRIPTIONS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvdocs.sty}[2021/01/27 documentation environments]
+\ProvidesFile{sphinxlatexobjects.sty}[2021/01/27 documentation environments]
 
 %  (some macros here used by \maketitle in sphinxmanual.cls and sphinxhowto.cls)
 
diff --git a/sphinx/texinputs/sphinxlatexoptionhandling.sty b/sphinx/texinputs/sphinxlatexoptionhandling.sty
deleted file mode 100644
index 61362ff0b39..00000000000
--- a/sphinx/texinputs/sphinxlatexoptionhandling.sty
+++ /dev/null
@@ -1,139 +0,0 @@
-%% OPTION HANDLING
-%
-% change this info string if making any custom modification
-\ProvidesFile{sphinxlatexoptionhandling.sty}[2021/01/27 option handling]
-
-% Handle options via "kvoptions" (later loaded by hyperref anyhow)
-\RequirePackage{kvoptions}
-\SetupKeyvalOptions{prefix=spx@opt@} % use \spx@opt@ prefix
-
-% Sphinx legacy text layout: 1in margins on all four sides
-\ifx\@jsc@uplatextrue\@undefined
-\DeclareStringOption[1in]{hmargin}
-\DeclareStringOption[1in]{vmargin}
-\DeclareStringOption[.5in]{marginpar}
-\else
-% Japanese standard document classes handle \mag in a special way
-\DeclareStringOption[\inv@mag in]{hmargin}
-\DeclareStringOption[\inv@mag in]{vmargin}
-\DeclareStringOption[.5\dimexpr\inv@mag in\relax]{marginpar}
-\fi
-
-\DeclareStringOption[0]{maxlistdepth}% \newcommand*\spx@opt@maxlistdepth{0}
-\DeclareStringOption[-1]{numfigreset}
-\DeclareBoolOption[false]{nonumfigreset}
-\DeclareBoolOption[false]{mathnumfig}
-% \DeclareBoolOption[false]{usespart}% not used
-% dimensions, we declare the \dimen registers here.
-\newdimen\sphinxverbatimsep
-\newdimen\sphinxverbatimborder
-\newdimen\sphinxshadowsep
-\newdimen\sphinxshadowsize
-\newdimen\sphinxshadowrule
-% \DeclareStringOption is not convenient for the handling of these dimensions
-% because we want to assign the values to the corresponding registers. Even if
-% we added the code to the key handler it would be too late for the initial
-% set-up and we would need to do initial assignments explicitely. We end up
-% using \define@key directly.
-% verbatim
-\sphinxverbatimsep=\fboxsep
-  \define@key{sphinx}{verbatimsep}{\sphinxverbatimsep\dimexpr #1\relax}
-\sphinxverbatimborder=\fboxrule
-  \define@key{sphinx}{verbatimborder}{\sphinxverbatimborder\dimexpr #1\relax}
-% topic boxes
-\sphinxshadowsep =5pt
-  \define@key{sphinx}{shadowsep}{\sphinxshadowsep\dimexpr #1\relax}
-\sphinxshadowsize=4pt
-  \define@key{sphinx}{shadowsize}{\sphinxshadowsize\dimexpr #1\relax}
-\sphinxshadowrule=\fboxrule
-  \define@key{sphinx}{shadowrule}{\sphinxshadowrule\dimexpr #1\relax}
-% verbatim
-\DeclareBoolOption[true]{verbatimwithframe}
-\DeclareBoolOption[true]{verbatimwrapslines}
-\DeclareBoolOption[true]{verbatimhintsturnover}
-\DeclareBoolOption[true]{inlineliteralwraps}
-\DeclareStringOption[t]{literalblockcappos}
-\DeclareStringOption[r]{verbatimcontinuedalign}
-\DeclareStringOption[r]{verbatimcontinuesalign}
-% parsed literal
-\DeclareBoolOption[true]{parsedliteralwraps}
-% \textvisiblespace for compatibility with fontspec+XeTeX/LuaTeX
-\DeclareStringOption[\textcolor{red}{\textvisiblespace}]{verbatimvisiblespace}
-\DeclareStringOption % must use braces to hide the brackets
-  [{\makebox[2\fontcharwd\font`\x][r]{\textcolor{red}{\tiny$\m@th\hookrightarrow$}}}]%
-  {verbatimcontinued}
-% notices/admonitions
-% the dimensions for notices/admonitions are kept as macros and assigned to
-% \spx@notice@border at time of use, hence \DeclareStringOption is ok for this
-\newdimen\spx@notice@border
-\DeclareStringOption[0.5pt]{noteborder}
-\DeclareStringOption[0.5pt]{hintborder}
-\DeclareStringOption[0.5pt]{importantborder}
-\DeclareStringOption[0.5pt]{tipborder}
-\DeclareStringOption[1pt]{warningborder}
-\DeclareStringOption[1pt]{cautionborder}
-\DeclareStringOption[1pt]{attentionborder}
-\DeclareStringOption[1pt]{dangerborder}
-\DeclareStringOption[1pt]{errorborder}
-% footnotes
-\DeclareStringOption[\mbox{ }]{AtStartFootnote}
-% we need a public macro name for direct use in latex file
-\newcommand*{\sphinxAtStartFootnote}{\spx@opt@AtStartFootnote}
-% no such need for this one, as it is used inside other macros
-\DeclareStringOption[\leavevmode\unskip]{BeforeFootnote}
-% some font styling.
-\DeclareStringOption[\sffamily\bfseries]{HeaderFamily}
-% colours
-% same problems as for dimensions: we want the key handler to use \definecolor.
-% first, some colours with no prefix, for backwards compatibility
-\newcommand*{\sphinxDeclareColorOption}[2]{%
-   \definecolor{#1}#2%
-   \define@key{sphinx}{#1}{\definecolor{#1}##1}%
-}%
-\sphinxDeclareColorOption{TitleColor}{{rgb}{0.126,0.263,0.361}}
-\sphinxDeclareColorOption{InnerLinkColor}{{rgb}{0.208,0.374,0.486}}
-\sphinxDeclareColorOption{OuterLinkColor}{{rgb}{0.216,0.439,0.388}}
-\sphinxDeclareColorOption{VerbatimColor}{{rgb}{1,1,1}}
-\sphinxDeclareColorOption{VerbatimBorderColor}{{rgb}{0,0,0}}
-% now the colours defined with "sphinx" prefix in their names
-\newcommand*{\sphinxDeclareSphinxColorOption}[2]{%
-   % set the initial default
-   \definecolor{sphinx#1}#2%
-   % set the key handler. The "value" ##1 must be acceptable by \definecolor.
-   \define@key{sphinx}{#1}{\definecolor{sphinx#1}##1}%
-}%
-% Default color chosen to be as in minted.sty LaTeX package!
-\sphinxDeclareSphinxColorOption{VerbatimHighlightColor}{{rgb}{0.878,1,1}}
-% admonition boxes, "light" style
-\sphinxDeclareSphinxColorOption{noteBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{hintBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{importantBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{tipBorderColor}{{rgb}{0,0,0}}
-% admonition boxes, "heavy" style
-\sphinxDeclareSphinxColorOption{warningBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{cautionBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{attentionBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{dangerBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{errorBorderColor}{{rgb}{0,0,0}}
-\sphinxDeclareSphinxColorOption{warningBgColor}{{rgb}{1,1,1}}
-\sphinxDeclareSphinxColorOption{cautionBgColor}{{rgb}{1,1,1}}
-\sphinxDeclareSphinxColorOption{attentionBgColor}{{rgb}{1,1,1}}
-\sphinxDeclareSphinxColorOption{dangerBgColor}{{rgb}{1,1,1}}
-\sphinxDeclareSphinxColorOption{errorBgColor}{{rgb}{1,1,1}}
-
-\DeclareDefaultOption{\@unknownoptionerror}
-\ProcessKeyvalOptions*
-% don't allow use of maxlistdepth via \sphinxsetup.
-\DisableKeyvalOption{sphinx}{maxlistdepth}
-\DisableKeyvalOption{sphinx}{numfigreset}
-\DisableKeyvalOption{sphinx}{nonumfigreset}
-\DisableKeyvalOption{sphinx}{mathnumfig}
-% To allow hyphenation of first word in narrow contexts; no option,
-% customization to be done via 'preamble' key
-\newcommand*\sphinxAtStartPar{\nobreak\hskip\z@skip}
-% No need for the \hspace{0pt} trick (\hskip\z@skip) with luatex
-\ifdefined\directlua\let\sphinxAtStartPar\@empty\fi
-% user interface: options can be changed midway in a document!
-\newcommand\sphinxsetup[1]{\setkeys{sphinx}{#1}}
-
-\endinput
diff --git a/sphinx/texinputs/sphinxlatexrequirepackages.sty b/sphinx/texinputs/sphinxlatexrequirepackages.sty
deleted file mode 100644
index c54fd2a6703..00000000000
--- a/sphinx/texinputs/sphinxlatexrequirepackages.sty
+++ /dev/null
@@ -1,242 +0,0 @@
-%% PACKAGES
-%
-% change this info string if making any custom modification
-\ProvidesFile{sphinxlatexrequirepackages.sty}[2021/01/27 packages]
-
-\RequirePackage{graphicx}
-\@ifclassloaded{memoir}{}{\RequirePackage{fancyhdr}}
-% for \text macro and \iffirstchoice@ conditional even if amsmath not loaded
-\RequirePackage{amstext}
-\RequirePackage{textcomp}% "warn" option issued from template
-\RequirePackage[nobottomtitles*]{titlesec}
-\@ifpackagelater{titlesec}{2016/03/15}%
- {\@ifpackagelater{titlesec}{2016/03/21}%
-  {}%
-  {\newif\ifsphinx@ttlpatch@ok
-   \IfFileExists{etoolbox.sty}{%
-     \RequirePackage{etoolbox}%
-     \patchcmd{\ttlh@hang}{\parindent\z@}{\parindent\z@\leavevmode}%
-                                {\sphinx@ttlpatch@oktrue}{}%
-     \ifsphinx@ttlpatch@ok
-     \patchcmd{\ttlh@hang}{\noindent}{}{}{\sphinx@ttlpatch@okfalse}%
-     \fi
-   }{}%
-   \ifsphinx@ttlpatch@ok
-     \typeout{^^J Package Sphinx Info: ^^J
-              **** titlesec 2.10.1 successfully patched for bugfix ****^^J}%
-   \else
-     \AtEndDocument{\PackageWarningNoLine{sphinx}{^^J%
-******** titlesec 2.10.1 has a bug, (section numbers disappear) ......|^^J%
-******** and Sphinx could not patch it, perhaps because your local ...|^^J%
-******** copy is already fixed without a changed release date. .......|^^J%
-******** If not, you must update titlesec! ...........................|}}%
-   \fi
-  }%
- }{}
-\RequirePackage{tabulary}
-% tabulary has a bug with its re-definition of \multicolumn in its first pass
-% which is not \long. But now Sphinx does not use LaTeX's \multicolumn but its
-% own macro. Hence we don't even need to patch tabulary. See
-% sphinxpackagemulticell.sty
-% X or S (Sphinx) may have meanings if some table package is loaded hence
-% \X was chosen to avoid possibility of conflict
-\newcolumntype{\X}[2]{p{\dimexpr
-      (\linewidth-\arrayrulewidth)*#1/#2-\tw@\tabcolsep-\arrayrulewidth\relax}}
-\newcolumntype{\Y}[1]{p{\dimexpr
-      #1\dimexpr\linewidth-\arrayrulewidth\relax-\tw@\tabcolsep-\arrayrulewidth\relax}}
-% using here T (for Tabulary) feels less of a problem than the X could be
-\newcolumntype{T}{J}%
-% For tables allowing pagebreaks
-\RequirePackage{longtable}
-% User interface to set-up whitespace before and after tables:
-\newcommand*\sphinxtablepre {0pt}%
-\newcommand*\sphinxtablepost{\medskipamount}%
-% Space from caption baseline to top of table or frame of literal-block
-\newcommand*\sphinxbelowcaptionspace{.5\sphinxbaselineskip}%
-% as one can not use \baselineskip from inside longtable (it is zero there)
-% we need \sphinxbaselineskip, which defaults to \baselineskip
-\def\sphinxbaselineskip{\baselineskip}%
-% The following is to ensure that, whether tabular(y) or longtable:
-% - if a caption is on top of table:
-%   a) the space between its last baseline and the top rule of table is
-%      exactly \sphinxbelowcaptionspace
-%   b) the space from last baseline of previous text to first baseline of
-%      caption is exactly \parskip+\baselineskip+ height of a strut.
-%   c) the caption text will wrap at width \LTcapwidth (4in)
-% - make sure this works also if "caption" package is loaded by user
-%   (with its width or margin option taking place of \LTcapwidth role)
-% TODO: obtain same for caption of literal block: a) & c) DONE, b) TO BE DONE
-%
-% To modify space below such top caption, adjust \sphinxbelowcaptionspace
-% To add or remove space above such top caption, adjust \sphinxtablepre:
-%   notice that \abovecaptionskip, \belowcaptionskip, \LTpre are **ignored**
-% A. Table with longtable
-\def\sphinxatlongtablestart
-   {\par
-    \vskip\parskip
-    \vskip\dimexpr\sphinxtablepre\relax % adjust vertical position
-    \vbox{}% get correct baseline from above
-    \LTpre\z@skip\LTpost\z@skip % set to zero longtable's own skips
-    \edef\sphinxbaselineskip{\dimexpr\the\dimexpr\baselineskip\relax\relax}%
-   }%
-% Compatibility with caption package
-\def\sphinxthelongtablecaptionisattop{%
-    \spx@ifcaptionpackage{\noalign{\vskip-\belowcaptionskip}}{}%
-}%
-% Achieves exactly \sphinxbelowcaptionspace below longtable caption
-\def\sphinxlongtablecapskipadjust
-   {\dimexpr-\dp\strutbox
-            -\spx@ifcaptionpackage{\abovecaptionskip}{\sphinxbaselineskip}%
-            +\sphinxbelowcaptionspace\relax}%
-\def\sphinxatlongtableend{\@nobreakfalse % latex3/latex2e#173
-    \prevdepth\z@\vskip\sphinxtablepost\relax}%
-% B. Table with tabular or tabulary
-\def\sphinxattablestart{\par\vskip\dimexpr\sphinxtablepre\relax}%
-\let\sphinxattableend\sphinxatlongtableend
-% This is used by tabular and tabulary templates
-\newcommand*\sphinxcapstartof[1]{%
-   \vskip\parskip
-   \vbox{}% force baselineskip for good positioning by capstart of hyperanchor
-   % hyperref puts the anchor 6pt above this baseline; in case of caption
-   % this baseline will be \ht\strutbox above first baseline of caption
-   \def\@captype{#1}%
-   \capstart
-% move back vertically, as tabular (or its caption) will compensate
-   \vskip-\baselineskip\vskip-\parskip
-}%
-\def\sphinxthecaptionisattop{% locate it after \sphinxcapstartof
-    \spx@ifcaptionpackage
-      {\caption@setposition{t}%
-       \vskip\baselineskip\vskip\parskip % undo those from \sphinxcapstartof
-       \vskip-\belowcaptionskip          % anticipate caption package skip
-       % caption package uses a \vbox, not a \vtop, so "single line" case
-       % gives different result from "multi-line" without this:
-       \nointerlineskip
-      }%
-      {}%
-}%
-\def\sphinxthecaptionisatbottom{% (not finalized; for template usage)
-    \spx@ifcaptionpackage{\caption@setposition{b}}{}%
-}%
-% The aim of \sphinxcaption is to apply to tabular(y) the maximal width
-% of caption as done by longtable
-\def\sphinxtablecapwidth{\LTcapwidth}%
-\newcommand\sphinxcaption{\@dblarg\spx@caption}%
-\long\def\spx@caption[#1]#2{%
-   \noindent\hb@xt@\linewidth{\hss
-      \vtop{\@tempdima\dimexpr\sphinxtablecapwidth\relax
-% don't exceed linewidth for the caption width
-            \ifdim\@tempdima>\linewidth\hsize\linewidth\else\hsize\@tempdima\fi
-% longtable ignores \abovecaptionskip/\belowcaptionskip, so do the same here
-            \abovecaptionskip\sphinxabovecaptionskip % \z@skip
-            \belowcaptionskip\sphinxbelowcaptionskip % \z@skip
-            \caption[{#1}]%
-               {\strut\ignorespaces#2\ifhmode\unskip\@finalstrut\strutbox\fi}%
-           }\hss}%
-   \par\prevdepth\dp\strutbox
-}%
-\def\sphinxabovecaptionskip{\z@skip}% Do not use! Flagged for removal
-\def\sphinxbelowcaptionskip{\z@skip}% Do not use! Flagged for removal
-% This wrapper of \abovecaptionskip is used in sphinxVerbatim for top
-% caption, and with another value in sphinxVerbatimintable
-% TODO: To unify space above caption of a code-block with the one above
-%       caption of a table/longtable, \abovecaptionskip must not be used
-%       This auxiliary will get renamed and receive a different meaning
-%       in future.
-\def\spx@abovecaptionskip{\abovecaptionskip}%
-% Achieve \sphinxbelowcaptionspace below a caption located above a tabular
-% or a tabulary
-\newcommand\sphinxaftertopcaption
-{%
-   \spx@ifcaptionpackage
-     {\par\prevdepth\dp\strutbox\nobreak\vskip-\abovecaptionskip}{\nobreak}%
-   \vskip\dimexpr\sphinxbelowcaptionspace\relax
-   \vskip-\baselineskip\vskip-\parskip
-}%
-% varwidth is crucial for our handling of general contents in merged cells
-\RequirePackage{varwidth}
-% but addition of a compatibility patch with hyperref is needed
-% (tested with varwidth v 0.92  Mar 2009)
-\AtBeginDocument {%
-    \let\@@vwid@Hy@raisedlink\Hy@raisedlink
-    \long\def\@vwid@Hy@raisedlink#1{\@vwid@wrap{\@@vwid@Hy@raisedlink{#1}}}%
-    \edef\@vwid@setup{%
-      \let\noexpand\Hy@raisedlink\noexpand\@vwid@Hy@raisedlink % HYPERREF !
-      \unexpanded\expandafter{\@vwid@setup}}%
-}%
-% Homemade package to handle merged cells
-\RequirePackage{sphinxpackagemulticell}
-\RequirePackage{makeidx}
-% For framing code-blocks and warning type notices, and shadowing topics
-\RequirePackage{framed}
-% The xcolor package draws better fcolorboxes around verbatim code
-\IfFileExists{xcolor.sty}{
-    \RequirePackage{xcolor}
-}{
-    \RequirePackage{color}
-}
-% For highlighted code.
-\RequirePackage{fancyvrb}
-\define@key{FV}{hllines}{\def\sphinx@verbatim@checkifhl##1{\in@{, ##1,}{#1}}}
-% sphinxVerbatim must be usable by third party without requiring hllines set-up
-\def\sphinxresetverbatimhllines{\def\sphinx@verbatim@checkifhl##1{\in@false}}
-\sphinxresetverbatimhllines
-% For hyperlinked footnotes in tables; also for gathering footnotes from
-% topic and warning blocks. Also to allow code-blocks in footnotes.
-\RequirePackage{sphinxpackagefootnote}
-% For the H specifier. Do not \restylefloat{figure}, it breaks Sphinx code
-% for allowing figures in tables.
-\RequirePackage{float}
-% For floating figures in the text. Better to load after float.
-\RequirePackage{wrapfig}
-% Separate paragraphs by space by default.
-\IfFileExists{parskip-2001-04-09.sty}% since September 2018 TeXLive update
-% new parskip.sty, but let it rollback to old one.
-% hopefully TeX installation not broken and LaTeX kernel not too old
-   {\RequirePackage{parskip}[=v1]}
-% standard one from 1989. Admittedly \section of article/book gives possibly
-% anomalous spacing, but we can't require September 2018 release for some time.
-   {\RequirePackage{parskip}}
-% For parsed-literal blocks.
-\RequirePackage{alltt}
-% Display "real" single quotes in literal blocks.
-\RequirePackage{upquote}
-% control caption around literal-block
-\RequirePackage{capt-of}
-\RequirePackage{needspace}
-% LaTeX 2018-04-01 and later provides \@removefromreset
-\ltx@ifundefined{@removefromreset}
-    {\RequirePackage{remreset}}
-    {}% avoid warning
-% To support hlist directive
-\RequirePackage{multicol}
-% to make pdf with correct encoded bookmarks in Japanese
-% this should precede the hyperref package
-\ifx\kanjiskip\@undefined
-% for non-Japanese: make sure bookmarks are ok also with lualatex
-  \PassOptionsToPackage{pdfencoding=unicode}{hyperref}
-\else
-  \RequirePackage{atbegshi}
-  \ifx\ucs\@undefined
-    \ifnum 42146=\euc"A4A2
-      \AtBeginShipoutFirst{\special{pdf:tounicode EUC-UCS2}}
-    \else
-      \AtBeginShipoutFirst{\special{pdf:tounicode 90ms-RKSJ-UCS2}}
-    \fi
-  \else
-    \AtBeginShipoutFirst{\special{pdf:tounicode UTF8-UCS2}}
-  \fi
-\fi
-
-\ifx\@jsc@uplatextrue\@undefined\else
-  \PassOptionsToPackage{setpagesize=false}{hyperref}
-\fi
-
-% These options can be overriden inside  'hyperref' key
-% or by later use of \hypersetup.
-\PassOptionsToPackage{colorlinks,breaklinks,%
- linkcolor=InnerLinkColor,filecolor=OuterLinkColor,%
- menucolor=OuterLinkColor,urlcolor=OuterLinkColor,%
- citecolor=InnerLinkColor}{hyperref}
-
-\endinput
diff --git a/sphinx/texinputs/sphinxlatexenvshadowbox.sty b/sphinx/texinputs/sphinxlatexshadowbox.sty
similarity index 97%
rename from sphinx/texinputs/sphinxlatexenvshadowbox.sty
rename to sphinx/texinputs/sphinxlatexshadowbox.sty
index 12fb3b7b8a2..2c6c7a6e2d9 100644
--- a/sphinx/texinputs/sphinxlatexenvshadowbox.sty
+++ b/sphinx/texinputs/sphinxlatexshadowbox.sty
@@ -1,7 +1,7 @@
 %% TOPIC AND CONTENTS BOXES
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexenvshadowbox.sty}[2021/01/27 topic and contents boxes]
+\ProvidesFile{sphinxlatexshadowbox.sty}[2021/01/27 sphinxShadowBox]
 
 % Again based on use of "framed.sty", this allows breakable framed boxes.
 \long\def\spx@ShadowFBox#1{%
diff --git a/sphinx/texinputs/sphinxlatexstyleheadings.sty b/sphinx/texinputs/sphinxlatexstyleheadings.sty
index 6d9f0f68973..e0195597ec9 100644
--- a/sphinx/texinputs/sphinxlatexstyleheadings.sty
+++ b/sphinx/texinputs/sphinxlatexstyleheadings.sty
@@ -1,8 +1,33 @@
-% change this info string if making any custom modification
 %% TITLES
 %
+% change this info string if making any custom modification
 \ProvidesFile{sphinxlatexstyleheadings.sty}[2021/01/27 headings]
 
+\RequirePackage[nobottomtitles*]{titlesec}
+\@ifpackagelater{titlesec}{2016/03/15}%
+ {\@ifpackagelater{titlesec}{2016/03/21}%
+  {}%
+  {\newif\ifsphinx@ttlpatch@ok
+   \IfFileExists{etoolbox.sty}{%
+     \RequirePackage{etoolbox}%
+     \patchcmd{\ttlh@hang}{\parindent\z@}{\parindent\z@\leavevmode}%
+                                {\sphinx@ttlpatch@oktrue}{}%
+     \ifsphinx@ttlpatch@ok
+     \patchcmd{\ttlh@hang}{\noindent}{}{}{\sphinx@ttlpatch@okfalse}%
+     \fi
+   }{}%
+   \ifsphinx@ttlpatch@ok
+     \typeout{^^J Package Sphinx Info: ^^J
+              **** titlesec 2.10.1 successfully patched for bugfix ****^^J}%
+   \else
+     \AtEndDocument{\PackageWarningNoLine{sphinx}{^^J%
+******** titlesec 2.10.1 has a bug, (section numbers disappear) ......|^^J%
+******** and Sphinx could not patch it, perhaps because your local ...|^^J%
+******** copy is already fixed without a changed release date. .......|^^J%
+******** If not, you must update titlesec! ...........................|}}%
+   \fi
+  }%
+ }{}
 % Since Sphinx 1.5, users should use HeaderFamily key to 'sphinxsetup' rather
 % than defining their own \py@HeaderFamily command (which is still possible).
 % Memo: \py@HeaderFamily is also used by \maketitle as defined in
@@ -47,4 +72,4 @@
 \titleformat{\subparagraph}{\py@HeaderFamily}%
             {\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor}
 
-\endinput
\ No newline at end of file
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexstylepage.sty b/sphinx/texinputs/sphinxlatexstylepage.sty
index d9b993c7678..c749c302d8a 100644
--- a/sphinx/texinputs/sphinxlatexstylepage.sty
+++ b/sphinx/texinputs/sphinxlatexstylepage.sty
@@ -3,11 +3,21 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexstylepage.sty}[2021/01/27 page styling]
 
+% Separate paragraphs by space by default.
+\IfFileExists{parskip-2001-04-09.sty}% since September 2018 TeXLive update
+% new parskip.sty, but let it rollback to old one.
+% hopefully TeX installation not broken and LaTeX kernel not too old
+   {\RequirePackage{parskip}[=v1]}
+% standard one from 1989. Admittedly \section of article/book gives possibly
+% anomalous spacing, but we can't require September 2018 release for some time.
+   {\RequirePackage{parskip}}
+
 % Style parameters and macros used by most documents here
 \raggedbottom
 \sloppy
 \hbadness = 5000                % don't print trivial gripes
 
+\@ifclassloaded{memoir}{}{\RequirePackage{fancyhdr}}
 % Use \pagestyle{normal} as the primary pagestyle for text.
 % Redefine the 'normal' header/footer style when using "fancyhdr" package:
 \@ifpackageloaded{fancyhdr}{%
@@ -64,57 +74,9 @@
    % Users of memoir class are invited to redefine 'normal' style in preamble
   }
 
-% geometry
-\ifx\kanjiskip\@undefined
-  \PassOptionsToPackage{%
-     hmargin={\unexpanded{\spx@opt@hmargin}},%
-     vmargin={\unexpanded{\spx@opt@vmargin}},%
-     marginpar=\unexpanded{\spx@opt@marginpar}}
-  {geometry}
-\else
- % set text width for Japanese documents to be integer multiple of 1zw
- % and text height to be integer multiple of \baselineskip
- % the execution is delayed to \sphinxsetup then geometry.sty
- \normalsize\normalfont
- \newcommand*\sphinxtextwidthja[1]{%
-    \if@twocolumn\tw@\fi
-    \dimexpr
-       \numexpr\dimexpr\paperwidth-\tw@\dimexpr#1\relax\relax/
-               \dimexpr\if@twocolumn\tw@\else\@ne\fi zw\relax
-    zw\relax}%
- \newcommand*\sphinxmarginparwidthja[1]{%
-    \dimexpr\numexpr\dimexpr#1\relax/\dimexpr1zw\relax zw\relax}%
- \newcommand*\sphinxtextlinesja[1]{%
-    \numexpr\@ne+\dimexpr\paperheight-\topskip-\tw@\dimexpr#1\relax\relax/
-                 \baselineskip\relax}%
- \ifx\@jsc@uplatextrue\@undefined\else
- % the way we found in order for the papersize special written by
- % geometry in the dvi file to be correct in case of jsbook class
-   \ifnum\mag=\@m\else % do nothing special if nomag class option or 10pt
-     \PassOptionsToPackage{truedimen}{geometry}%
-   \fi
- \fi
- \PassOptionsToPackage{%
-    hmarginratio={1:1},%
-    textwidth=\unexpanded{\sphinxtextwidthja{\spx@opt@hmargin}},%
-    vmarginratio={1:1},%
-    lines=\unexpanded{\sphinxtextlinesja{\spx@opt@vmargin}},%
-    marginpar=\unexpanded{\sphinxmarginparwidthja{\spx@opt@marginpar}},%
-    footskip=2\baselineskip,%
-  }{geometry}%
- \AtBeginDocument
- {% update a dimension used by the jsclasses
-  \ifx\@jsc@uplatextrue\@undefined\else\fullwidth\textwidth\fi
-  % for some reason, jreport normalizes all dimensions with \@settopoint
-  \@ifclassloaded{jreport}
-    {\@settopoint\textwidth\@settopoint\textheight\@settopoint\marginparwidth}
-    {}% <-- "false" clause of \@ifclassloaded
-  }%
-\fi
-
 % fix fncychap's bug which uses prematurely the \textwidth value
 \@ifpackagewith{fncychap}{Bjornstrup}
  {\AtBeginDocument{\mylen\textwidth\advance\mylen-2\myhi}}%
  {}% <-- "false" clause of \@ifpackagewith
 
-\endinput
\ No newline at end of file
+\endinput
diff --git a/sphinx/texinputs/sphinxlatexstyletext.sty b/sphinx/texinputs/sphinxlatexstyletext.sty
index 08d7a693517..f780bf71bc8 100644
--- a/sphinx/texinputs/sphinxlatexstyletext.sty
+++ b/sphinx/texinputs/sphinxlatexstyletext.sty
@@ -3,49 +3,6 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexstyletext.sty}[2021/01/27 text styling]
 
-% to obtain straight quotes we execute \@noligs as patched by upquote, and
-% \scantokens is needed in cases where it would be too late for the macro to
-% first set catcodes and then fetch its argument. We also make the contents
-% breakable at non-escaped . , ; ? ! / using \sphinxbreaksviaactive,
-% and also at \ character (which is escaped to \textbackslash{}).
-\protected\def\sphinxtextbackslashbreakbefore
- {\discretionary{}{\sphinxafterbreak\sphinx@textbackslash}{\sphinx@textbackslash}}
-\protected\def\sphinxtextbackslashbreakafter
- {\discretionary{\sphinx@textbackslash}{\sphinxafterbreak}{\sphinx@textbackslash}}
-\let\sphinxtextbackslash\sphinxtextbackslashbreakafter
-% the macro must be protected if it ends up used in moving arguments,
-% in 'alltt' \@noligs is done already, and the \scantokens must be avoided.
-\protected\def\sphinxupquote#1{{\def\@tempa{alltt}%
-  \ifx\@tempa\@currenvir\else
-   \ifspx@opt@inlineliteralwraps
-      % break at . , ; ? ! /
-      \sphinxbreaksviaactive
-      % break also at \
-      \let\sphinx@textbackslash\textbackslash
-      \let\textbackslash\sphinxtextbackslash
-      % by default, no continuation symbol on next line but may be added
-      \let\sphinxafterbreak\sphinxafterbreakofinlineliteral
-      % do not overwrite the comma set-up
-      \let\verbatim@nolig@list\sphinx@literal@nolig@list
-   \fi
-   % fix a space-gobbling issue due to LaTeX's original \do@noligs
-% TODO: using \@noligs as patched by upquote.sty is now unneeded because
-% either ` and ' are escaped (non-unicode engines) or they don't build
-% ligatures (unicode engines). Thus remove this and unify handling of `, <, >,
-% ' and - with the characters . , ; ? ! / as handled via
-% \sphinxbreaksviaactive.
-% Hence \sphinx@do@noligs will be removed, or rather replaced  with code
-% inserting discretionaries, as they allow a continuation symbol on start of
-% next line to achieve common design with code-blocks.
-   \let\do@noligs\sphinx@do@noligs
-   \@noligs\endlinechar\m@ne\everyeof{}% (<- in case inside \sphinxhref)
-   \expandafter\scantokens
-  \fi {{#1}}}}% extra brace pair to fix end-space gobbling issue...
-\def\sphinx@do@noligs #1{\catcode`#1\active\begingroup\lccode`\~`#1\relax
-    \lowercase{\endgroup\def~{\leavevmode\kern\z@\char`#1 }}}
-\def\sphinx@literal@nolig@list {\do\`\do\<\do\>\do\'\do\-}%
-\let\sphinxafterbreakofinlineliteral\empty
-
 % Some custom font markup commands.
 \protected\def\sphinxstrong#1{\textbf{#1}}
 \protected\def\sphinxcode#1{\texttt{#1}}
diff --git a/sphinx/texinputs/sphinxpackagemulticell.sty b/sphinx/texinputs/sphinxlatextables.sty
similarity index 68%
rename from sphinx/texinputs/sphinxpackagemulticell.sty
rename to sphinx/texinputs/sphinxlatextables.sty
index aed5219d3e7..54691ed3825 100644
--- a/sphinx/texinputs/sphinxpackagemulticell.sty
+++ b/sphinx/texinputs/sphinxlatextables.sty
@@ -1,10 +1,145 @@
-\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{sphinxpackagemulticell}%
-    [2017/02/23 v1.6 better span rows and columns of a table (Sphinx team)]%
-\DeclareOption*{\PackageWarning{sphinxpackagemulticell}%
-               {Option `\CurrentOption' is unknown}}%
-\ProcessOptions\relax
+%% TABLES (WITH SUPPORT FOR MERGED CELLS OF GENERAL CONTENTS)
 %
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatextables.sty}[2021/01/27 tables]%
+
+% IMPORTANT: all this is to be kept in sync with the templates
+% longtable.tex_t, tabular.tex_t, tabulary.tex_t and the actual
+% Sphinx latex writer output.
+
+\RequirePackage{tabulary}
+% tabulary has a bug with its re-definition of \multicolumn in its first pass
+% which is not \long. But now Sphinx does not use LaTeX's \multicolumn but its
+% own macro. Hence we don't even need to patch tabulary. See
+% sphinxpackagemulticell.sty
+% X or S (Sphinx) may have meanings if some table package is loaded hence
+% \X was chosen to avoid possibility of conflict
+\newcolumntype{\X}[2]{p{\dimexpr
+      (\linewidth-\arrayrulewidth)*#1/#2-\tw@\tabcolsep-\arrayrulewidth\relax}}
+\newcolumntype{\Y}[1]{p{\dimexpr
+      #1\dimexpr\linewidth-\arrayrulewidth\relax-\tw@\tabcolsep-\arrayrulewidth\relax}}
+% using here T (for Tabulary) feels less of a problem than the X could be
+\newcolumntype{T}{J}%
+% For tables allowing pagebreaks
+\RequirePackage{longtable}
+% User interface to set-up whitespace before and after tables:
+\newcommand*\sphinxtablepre {0pt}%
+\newcommand*\sphinxtablepost{\medskipamount}%
+% Space from caption baseline to top of table or frame of literal-block
+\newcommand*\sphinxbelowcaptionspace{.5\sphinxbaselineskip}%
+% as one can not use \baselineskip from inside longtable (it is zero there)
+% we need \sphinxbaselineskip, which defaults to \baselineskip
+\def\sphinxbaselineskip{\baselineskip}%
+% The following is to ensure that, whether tabular(y) or longtable:
+% - if a caption is on top of table:
+%   a) the space between its last baseline and the top rule of table is
+%      exactly \sphinxbelowcaptionspace
+%   b) the space from last baseline of previous text to first baseline of
+%      caption is exactly \parskip+\baselineskip+ height of a strut.
+%   c) the caption text will wrap at width \LTcapwidth (4in)
+% - make sure this works also if "caption" package is loaded by user
+%   (with its width or margin option taking place of \LTcapwidth role)
+% TODO: obtain same for caption of literal block: a) & c) DONE, b) TO BE DONE
+%
+% To modify space below such top caption, adjust \sphinxbelowcaptionspace
+% To add or remove space above such top caption, adjust \sphinxtablepre:
+%   notice that \abovecaptionskip, \belowcaptionskip, \LTpre are **ignored**
+% A. Table with longtable
+\def\sphinxatlongtablestart
+   {\par
+    \vskip\parskip
+    \vskip\dimexpr\sphinxtablepre\relax % adjust vertical position
+    \vbox{}% get correct baseline from above
+    \LTpre\z@skip\LTpost\z@skip % set to zero longtable's own skips
+    \edef\sphinxbaselineskip{\dimexpr\the\dimexpr\baselineskip\relax\relax}%
+   }%
+% Compatibility with caption package
+\def\sphinxthelongtablecaptionisattop{%
+    \spx@ifcaptionpackage{\noalign{\vskip-\belowcaptionskip}}{}%
+}%
+% Achieves exactly \sphinxbelowcaptionspace below longtable caption
+\def\sphinxlongtablecapskipadjust
+   {\dimexpr-\dp\strutbox
+            -\spx@ifcaptionpackage{\abovecaptionskip}{\sphinxbaselineskip}%
+            +\sphinxbelowcaptionspace\relax}%
+\def\sphinxatlongtableend{\@nobreakfalse % latex3/latex2e#173
+    \prevdepth\z@\vskip\sphinxtablepost\relax}%
+% B. Table with tabular or tabulary
+\def\sphinxattablestart{\par\vskip\dimexpr\sphinxtablepre\relax}%
+\let\sphinxattableend\sphinxatlongtableend
+% This is used by tabular and tabulary templates
+\newcommand*\sphinxcapstartof[1]{%
+   \vskip\parskip
+   \vbox{}% force baselineskip for good positioning by capstart of hyperanchor
+   % hyperref puts the anchor 6pt above this baseline; in case of caption
+   % this baseline will be \ht\strutbox above first baseline of caption
+   \def\@captype{#1}%
+   \capstart
+% move back vertically, as tabular (or its caption) will compensate
+   \vskip-\baselineskip\vskip-\parskip
+}%
+\def\sphinxthecaptionisattop{% locate it after \sphinxcapstartof
+    \spx@ifcaptionpackage
+      {\caption@setposition{t}%
+       \vskip\baselineskip\vskip\parskip % undo those from \sphinxcapstartof
+       \vskip-\belowcaptionskip          % anticipate caption package skip
+       % caption package uses a \vbox, not a \vtop, so "single line" case
+       % gives different result from "multi-line" without this:
+       \nointerlineskip
+      }%
+      {}%
+}%
+\def\sphinxthecaptionisatbottom{% (not finalized; for template usage)
+    \spx@ifcaptionpackage{\caption@setposition{b}}{}%
+}%
+% The aim of \sphinxcaption is to apply to tabular(y) the maximal width
+% of caption as done by longtable
+\def\sphinxtablecapwidth{\LTcapwidth}%
+\newcommand\sphinxcaption{\@dblarg\spx@caption}%
+\long\def\spx@caption[#1]#2{%
+   \noindent\hb@xt@\linewidth{\hss
+      \vtop{\@tempdima\dimexpr\sphinxtablecapwidth\relax
+% don't exceed linewidth for the caption width
+            \ifdim\@tempdima>\linewidth\hsize\linewidth\else\hsize\@tempdima\fi
+% longtable ignores \abovecaptionskip/\belowcaptionskip, so do the same here
+            \abovecaptionskip\sphinxabovecaptionskip % \z@skip
+            \belowcaptionskip\sphinxbelowcaptionskip % \z@skip
+            \caption[{#1}]%
+               {\strut\ignorespaces#2\ifhmode\unskip\@finalstrut\strutbox\fi}%
+           }\hss}%
+   \par\prevdepth\dp\strutbox
+}%
+\def\sphinxabovecaptionskip{\z@skip}% Do not use! Flagged for removal
+\def\sphinxbelowcaptionskip{\z@skip}% Do not use! Flagged for removal
+% This wrapper of \abovecaptionskip is used in sphinxVerbatim for top
+% caption, and with another value in sphinxVerbatimintable
+% TODO: To unify space above caption of a code-block with the one above
+%       caption of a table/longtable, \abovecaptionskip must not be used
+%       This auxiliary will get renamed and receive a different meaning
+%       in future.
+\def\spx@abovecaptionskip{\abovecaptionskip}%
+% Achieve \sphinxbelowcaptionspace below a caption located above a tabular
+% or a tabulary
+\newcommand\sphinxaftertopcaption
+{%
+   \spx@ifcaptionpackage
+     {\par\prevdepth\dp\strutbox\nobreak\vskip-\abovecaptionskip}{\nobreak}%
+   \vskip\dimexpr\sphinxbelowcaptionspace\relax
+   \vskip-\baselineskip\vskip-\parskip
+}%
+% varwidth is crucial for our handling of general contents in merged cells
+\RequirePackage{varwidth}
+% but addition of a compatibility patch with hyperref is needed
+% (tested with varwidth v 0.92  Mar 2009)
+\AtBeginDocument {%
+    \let\@@vwid@Hy@raisedlink\Hy@raisedlink
+    \long\def\@vwid@Hy@raisedlink#1{\@vwid@wrap{\@@vwid@Hy@raisedlink{#1}}}%
+    \edef\@vwid@setup{%
+      \let\noexpand\Hy@raisedlink\noexpand\@vwid@Hy@raisedlink % HYPERREF !
+      \unexpanded\expandafter{\@vwid@setup}}%
+}%
+
+%%%%%%%%%%%%%%%%%%%%%
 % --- MULTICOLUMN ---
 % standard LaTeX's \multicolumn
 % 1. does not allow verbatim contents,
@@ -206,7 +341,8 @@
 \def\sphinx@multiwidth #1#2{\dimexpr % #1 to gobble the \@gobble (!)
     (\ifx\TY@final\@undefined\linewidth\else\sphinx@TY@tablewidth\fi
      -\arrayrulewidth)*#2-\tw@\tabcolsep-\arrayrulewidth\relax}%
-%
+
+%%%%%%%%%%%%%%%%%%
 % --- MULTIROW ---
 % standard \multirow
 % 1. does not allow verbatim contents,
@@ -313,6 +449,5 @@
   % we need this to avoid colour panels hiding bottom parts of multirow text
   \sphinx@hack@CT
 }%
+
 \endinput
-%%
-%% End of file `sphinxpackagemulticell.sty'.
diff --git a/sphinx/texinputs/sphinxoptionsgeometry.sty b/sphinx/texinputs/sphinxoptionsgeometry.sty
new file mode 100644
index 00000000000..af5a804d593
--- /dev/null
+++ b/sphinx/texinputs/sphinxoptionsgeometry.sty
@@ -0,0 +1,54 @@
+%% OPTIONS FOR GEOMETRY
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxoptionsgeometry.sty}[2021/01/27 geometry]
+
+% geometry
+\ifx\kanjiskip\@undefined
+  \PassOptionsToPackage{%
+     hmargin={\unexpanded{\spx@opt@hmargin}},%
+     vmargin={\unexpanded{\spx@opt@vmargin}},%
+     marginpar=\unexpanded{\spx@opt@marginpar}}
+  {geometry}
+\else
+ % set text width for Japanese documents to be integer multiple of 1zw
+ % and text height to be integer multiple of \baselineskip
+ % the execution is delayed to \sphinxsetup then geometry.sty
+ \normalsize\normalfont
+ \newcommand*\sphinxtextwidthja[1]{%
+    \if@twocolumn\tw@\fi
+    \dimexpr
+       \numexpr\dimexpr\paperwidth-\tw@\dimexpr#1\relax\relax/
+               \dimexpr\if@twocolumn\tw@\else\@ne\fi zw\relax
+    zw\relax}%
+ \newcommand*\sphinxmarginparwidthja[1]{%
+    \dimexpr\numexpr\dimexpr#1\relax/\dimexpr1zw\relax zw\relax}%
+ \newcommand*\sphinxtextlinesja[1]{%
+    \numexpr\@ne+\dimexpr\paperheight-\topskip-\tw@\dimexpr#1\relax\relax/
+                 \baselineskip\relax}%
+ \ifx\@jsc@uplatextrue\@undefined\else
+ % the way we found in order for the papersize special written by
+ % geometry in the dvi file to be correct in case of jsbook class
+   \ifnum\mag=\@m\else % do nothing special if nomag class option or 10pt
+     \PassOptionsToPackage{truedimen}{geometry}%
+   \fi
+ \fi
+ \PassOptionsToPackage{%
+    hmarginratio={1:1},%
+    textwidth=\unexpanded{\sphinxtextwidthja{\spx@opt@hmargin}},%
+    vmarginratio={1:1},%
+    lines=\unexpanded{\sphinxtextlinesja{\spx@opt@vmargin}},%
+    marginpar=\unexpanded{\sphinxmarginparwidthja{\spx@opt@marginpar}},%
+    footskip=2\baselineskip,%
+  }{geometry}%
+ \AtBeginDocument
+ {% update a dimension used by the jsclasses
+  \ifx\@jsc@uplatextrue\@undefined\else\fullwidth\textwidth\fi
+  % for some reason, jreport normalizes all dimensions with \@settopoint
+  \@ifclassloaded{jreport}
+    {\@settopoint\textwidth\@settopoint\textheight\@settopoint\marginparwidth}
+    {}% <-- "false" clause of \@ifclassloaded
+  }%
+\fi
+
+\endinput
diff --git a/sphinx/texinputs/sphinxoptionshyperref.sty b/sphinx/texinputs/sphinxoptionshyperref.sty
new file mode 100644
index 00000000000..6017d897043
--- /dev/null
+++ b/sphinx/texinputs/sphinxoptionshyperref.sty
@@ -0,0 +1,35 @@
+%% Bookmarks and hyperlinks
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxoptionshyperref.sty}[2021/01/27 hyperref]
+
+% to make pdf with correct encoded bookmarks in Japanese
+% this should precede the hyperref package
+\ifx\kanjiskip\@undefined
+% for non-Japanese: make sure bookmarks are ok also with lualatex
+  \PassOptionsToPackage{pdfencoding=unicode}{hyperref}
+\else
+  \RequirePackage{atbegshi}
+  \ifx\ucs\@undefined
+    \ifnum 42146=\euc"A4A2
+      \AtBeginShipoutFirst{\special{pdf:tounicode EUC-UCS2}}
+    \else
+      \AtBeginShipoutFirst{\special{pdf:tounicode 90ms-RKSJ-UCS2}}
+    \fi
+  \else
+    \AtBeginShipoutFirst{\special{pdf:tounicode UTF8-UCS2}}
+  \fi
+\fi
+
+\ifx\@jsc@uplatextrue\@undefined\else
+  \PassOptionsToPackage{setpagesize=false}{hyperref}
+\fi
+
+% These options can be overriden inside  'hyperref' key
+% or by later use of \hypersetup.
+\PassOptionsToPackage{colorlinks,breaklinks,%
+ linkcolor=InnerLinkColor,filecolor=OuterLinkColor,%
+ menucolor=OuterLinkColor,urlcolor=OuterLinkColor,%
+ citecolor=InnerLinkColor}{hyperref}
+
+\endinput

From 6dea091257142565e9fec5aa447055c83af6a06c Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Sat, 30 Jan 2021 21:14:02 +0100
Subject: [PATCH 119/305] Fix markup in docs (from d6e11b89)

---
 doc/latex.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/latex.rst b/doc/latex.rst
index 81706d00fd8..d6ae2fee6cc 100644
--- a/doc/latex.rst
+++ b/doc/latex.rst
@@ -1029,11 +1029,11 @@ Environments
 Miscellany
 ~~~~~~~~~~
 
-- Every text paragraph in document body starts with `\sphinxAtStartPar`.
+- Every text paragraph in document body starts with ``\sphinxAtStartPar``.
   Currently, this is used to insert a zero width horizontal skip which
   is a trick to allow TeX hyphenation of the first word of a paragraph
   in a narrow context (like a table cell). For ``'lualatex'`` which
-  does not need the trick, the `\sphinxAtStartPar` does nothing.
+  does not need the trick, the ``\sphinxAtStartPar`` does nothing.
 
   .. versionadded:: 3.5.0
 

From 54078e8a26ccff63fc6b6319e3fff8d3a0ce0306 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Sun, 31 Jan 2021 13:33:50 +0100
Subject: [PATCH 120/305] LaTeX: document what the style files provide and
 require

---
 sphinx/texinputs/sphinx.sty                   | 75 ++++++++++---------
 sphinx/texinputs/sphinxlatexadmonitions.sty   | 26 +++++++
 sphinx/texinputs/sphinxlatexgraphics.sty      | 39 ++++++----
 sphinx/texinputs/sphinxlatexindbibtoc.sty     | 17 +++++
 sphinx/texinputs/sphinxlatexlists.sty         |  5 ++
 sphinx/texinputs/sphinxlatexliterals.sty      | 68 ++++++++++++++---
 sphinx/texinputs/sphinxlatexnumfig.sty        |  3 +
 sphinx/texinputs/sphinxlatexobjects.sty       | 15 +++-
 sphinx/texinputs/sphinxlatexshadowbox.sty     | 14 ++++
 sphinx/texinputs/sphinxlatexstyleheadings.sty | 36 +++++----
 sphinx/texinputs/sphinxlatexstylepage.sty     |  5 +-
 sphinx/texinputs/sphinxlatexstyletext.sty     |  3 +
 sphinx/texinputs/sphinxlatextables.sty        | 34 ++++++++-
 sphinx/texinputs/sphinxpackagefootnote.sty    |  5 ++
 14 files changed, 263 insertions(+), 82 deletions(-)

diff --git a/sphinx/texinputs/sphinx.sty b/sphinx/texinputs/sphinx.sty
index 39ca85611ef..fa6695ae4f6 100644
--- a/sphinx/texinputs/sphinx.sty
+++ b/sphinx/texinputs/sphinx.sty
@@ -180,6 +180,37 @@
 \newcommand\sphinxsetup[1]{\setkeys{sphinx}{#1}}
 
 
+%% MISCELLANEOUS CONTEXT
+%
+% flag to be set in a framed environment
+% (defined here as currently needed by three sphinxlatex....sty files and
+% even if not needed if such files are replaced, the definition does no harm)
+\newif\ifspx@inframed
+%
+% \spx@ifcaptionpackage (defined at begin document)
+%     is needed currently in macros from:
+%     sphinxlatexliterals.sty (sphinxVerbatim)
+%     sphinxlatextables.sty   (for some macros used in the table templates)
+%
+% \sphinxcaption is mark-up injected by the tabular and tabulary templates
+%     it is defined in sphinxlatextables.sty
+%
+% store the original \caption macro for usage with figures inside longtable
+% and tabulary cells. Make sure we get the final \caption in presence of
+% caption package, whether the latter was loaded before or after sphinx.
+\AtBeginDocument{%
+    \let\spx@originalcaption\caption
+    \@ifpackageloaded{caption}
+      {\let\spx@ifcaptionpackage\@firstoftwo
+       \caption@AtBeginDocument*{\let\spx@originalcaption\caption}%
+% in presence of caption package, drop our own \sphinxcaption whose aim was to
+% ensure same width of caption to all kinds of tables (tabular(y), longtable),
+% because caption package has its own width (or margin) option
+       \def\sphinxcaption{\caption}%
+      }%
+      {\let\spx@ifcaptionpackage\@secondoftwo}%
+}
+
 %% PASS OPTIONS
 %
 % pass options to hyperref; it must not have been loaded already
@@ -203,42 +234,35 @@
 %
 % as will be indicated below, secondary style files load some more packages
 %
-% for \text macro and \iffirstchoice@ conditional even if amsmath not loaded
+% For \text macro (sphinx.util.texescape)
+% also for usage of \firstchoice@true(false) in sphinxlatexgraphics.sty
 \RequirePackage{amstext}
-% it was passed "warn" option from latex template
+% It was passed "warn" option from latex template in case it is already loaded
+% via some other package before \usepackage{sphinx} in preamble
 \RequirePackage{textcomp}
 % For the H specifier. Do not \restylefloat{figure}, it breaks Sphinx code
 % for allowing figures in tables.
 \RequirePackage{float}
 % For floating figures in the text. Better to load after float.
 \RequirePackage{wrapfig}
-% control caption around literal-block
+% Provides \captionof, used once by latex writer (\captionof{figure})
 \RequirePackage{capt-of}
-\RequirePackage{needspace}
-% support hlist directive
+% Support hlist directive
 \RequirePackage{multicol}
 
 
 %% GRAPHICS
 %
+% It will always be needed, so let's load it here
 \RequirePackage{graphicx}
 \input{sphinxlatexgraphics.sty}
 
 
 %% FRAMED ENVIRONMENTS
-% For framing code-blocks and warning type notices, and shadowing topics
-\RequirePackage{framed}
 %
-% macros and environment for display literals (sphinxVerbatim, sphinxalltt)
-% and inline literals (\sphinxupquote); also defines \sphinxhref.
-% Requires: fancyvrb, alltt, upquote
+\input{sphinxlatexadmonitions.sty}
 \input{sphinxlatexliterals.sty}
-%
-% topic and contents boxes: sphinxShadowBox uses framed.sty
 \input{sphinxlatexshadowbox.sty}
-%
-% notices and admonitions: sphinxheavybox uses again framed.sty
-\input{sphinxlatexadmonitions.sty}
 
 
 %% PYGMENTS
@@ -259,23 +283,16 @@
 
 %% TABLES
 %
-% Requires: tabulary, longtable, varwidth
-% extends tabulary and longtable via patches and custom macros to support
-% merged cells possibly containing code-blocks in complex tables
 \input{sphinxlatextables.sty}
 
 
 %% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS
 %
-% Requires: remreset (old LaTeX only)
-% relates to numfig and numfig_secnum_depth configuration variables
 \input{sphinxlatexnumfig.sty}
 
 
 %% LISTS
 %
-% optionally extends LaTeX maximal list nesting depth and provides
-% \sphinxsetlistlabels macro used in mark-up
 \input{sphinxlatexlists.sty}
 
 
@@ -284,35 +301,25 @@
 % support large numbered footnotes in minipage; but this is now obsolete
 % from systematic use of savenotes environment around minipages
 \def\thempfootnote{\arabic{mpfootnote}}
-% this package provides savenotes environment (aka \savenotes/spewnotes)
-% For hyperlinked footnotes in tables; also for gathering footnotes from
-% topic and warning blocks. Also to allow code-blocks in footnotes.
-% Based on footnotehyper, extended to support tabulary multipass system
+% This package is needed to support hyperlinked footnotes in tables and
+% framed contents, and to allow code-blocks in footnotes.
 \RequirePackage{sphinxpackagefootnote}
 
 
 %% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS
 %
-% requires makeidx
 \input{sphinxlatexindbibtoc.sty}
 
 
 %% STYLING
 %
-% page
-% requires parskip (legacy version) and, except if memoir class, fancyhdr
 \input{sphinxlatexstylepage.sty}
-% headings
-% requires titlesec and, if it is at 2.10.1, etoolbox to patch it
 \input{sphinxlatexstyleheadings.sty}
-% many \sphinx... prefixed commands to style text
 \input{sphinxlatexstyletext.sty}
 
 
 %% MODULE RELEASE DATA AND OBJECT DESCRIPTIONS
 %
-% this legacy code has remained very stable over the years
-% (fulllineitems was updated to support multiline signatures)
 \input{sphinxlatexobjects.sty}
 
 
diff --git a/sphinx/texinputs/sphinxlatexadmonitions.sty b/sphinx/texinputs/sphinxlatexadmonitions.sty
index c9307754885..1e418c8c222 100644
--- a/sphinx/texinputs/sphinxlatexadmonitions.sty
+++ b/sphinx/texinputs/sphinxlatexadmonitions.sty
@@ -3,6 +3,32 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexadmonitions.sty}[2021/01/27 admonitions]
 
+% Provides support for this output mark-up from Sphinx latex writer:
+%
+% - sphinxadmonition (environment)
+%   This is a dispatch supporting
+%
+%   - note, hint, important, tip                 (via sphinxlightbox)
+%   - warning, caution, attention, danger, error (via sphinxheavybox)
+%
+%   Each sphinx<notice name> environment can be redefined by user.
+%   The defaults are customizable via various colour and dimension
+%   settings, cf sphinx docs (latex customization).
+%
+% Requires:
+\RequirePackage{framed}% used by sphinxheavybox
+%
+% Dependencies (they do not need to be defined at time of loading):
+% - of course the various colour and dimension options handled via sphinx.sty
+% - \sphinxstrong (for sphinxlightbox and sphinxheavybox)
+% - dimension register \spx@image@maxheight from sphinxlatexgraphics.sty
+% - \savenotes/\spewnotes from sphinxpackagefootnote (for sphinxheavybox)
+
+% Provides: (also in sphinxlatexliterals.sty)
+\providecommand*\sphinxvspacefixafterfrenchlists{%
+   \ifvmode\ifdim\lastskip<\z@ \vskip\parskip\fi\else\par\fi
+}
+
 % Some are quite plain
 % the spx@notice@bordercolor etc are set in the sphinxadmonition environment
 \newenvironment{sphinxlightbox}{%
diff --git a/sphinx/texinputs/sphinxlatexgraphics.sty b/sphinx/texinputs/sphinxlatexgraphics.sty
index 4a16fe990dd..d3e38b02d48 100644
--- a/sphinx/texinputs/sphinxlatexgraphics.sty
+++ b/sphinx/texinputs/sphinxlatexgraphics.sty
@@ -3,6 +3,30 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexgraphics.sty}[2021/01/27 graphics]
 
+% Provides support for this output mark-up from Sphinx latex writer:
+%
+% - macros:
+%
+%   - \sphinxfigcaption
+%   - \sphinxincludegraphics
+%
+% - environments:
+%
+%   - sphinxfigure-in-table
+%
+% May change:
+%
+% - \sphinxcaption (at begin document)
+%
+% Also provides:
+%
+% - \sphinxsafeincludegraphics (default of \sphinxincludegraphics since 2.0)
+% - \spx@image@maxheight dimension (used by sphinxlatexadmonitions.sty)
+%
+% Requires:
+% \RequirePackage{graphicx}% done in sphinx.sty
+\RequirePackage{amstext}% needed for \firstchoice@true(false)
+
 % \sphinxincludegraphics resizes images larger than the TeX \linewidth (which
 % is adjusted in indented environments), or taller than a certain maximal
 % height (usually \textheight and this is reduced in the environments which use
@@ -85,21 +109,6 @@
   \sphinxsetvskipsforfigintablecaption
   \begin{minipage}{#1}%
 }{\end{minipage}}
-% store the original \caption macro for usage with figures inside longtable
-% and tabulary cells. Make sure we get the final \caption in presence of
-% caption package, whether the latter was loaded before or after sphinx.
-\AtBeginDocument{%
-    \let\spx@originalcaption\caption
-    \@ifpackageloaded{caption}
-      {\let\spx@ifcaptionpackage\@firstoftwo
-       \caption@AtBeginDocument*{\let\spx@originalcaption\caption}%
-% in presence of caption package, drop our own \sphinxcaption whose aim was to
-% ensure same width of caption to all kinds of tables (tabular(y), longtable),
-% because caption package has its own width (or margin) option
-       \def\sphinxcaption{\caption}%
-      }%
-      {\let\spx@ifcaptionpackage\@secondoftwo}%
-}
 % tabulary expands twice contents, we need to prevent double counter stepping
 \newcommand*\sphinxfigcaption
   {\ifx\equation$%$% this is trick to identify tabulary first pass
diff --git a/sphinx/texinputs/sphinxlatexindbibtoc.sty b/sphinx/texinputs/sphinxlatexindbibtoc.sty
index b5f7ab94452..79e30a1f199 100644
--- a/sphinx/texinputs/sphinxlatexindbibtoc.sty
+++ b/sphinx/texinputs/sphinxlatexindbibtoc.sty
@@ -3,6 +3,23 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexindbibtoc.sty}[2021/01/27 index, bib., toc]
 
+% Provides support for this output mark-up from Sphinx latex writer:
+%
+% - environments: (backup defaults or get redefined)
+%
+%   - sphinxtheindex (direct mark-up or via python.ist or sphinx.xdy)
+%   - sphinxthebibliography
+%
+% - macros: (defines defaults)
+%
+%   - \sphinxmaketitle
+%   - \sphinxtableofcontents
+%   - \sphinxnonalphabeticalgroupname
+%   - \sphinxsymbolsname
+%   - \sphinxnumbersname
+%   - \sphinxcite
+%
+% Requires:
 \RequirePackage{makeidx}
 
 % fix the double index and bibliography on the table of contents
diff --git a/sphinx/texinputs/sphinxlatexlists.sty b/sphinx/texinputs/sphinxlatexlists.sty
index dd474f9a8b6..3860090c298 100644
--- a/sphinx/texinputs/sphinxlatexlists.sty
+++ b/sphinx/texinputs/sphinxlatexlists.sty
@@ -3,6 +3,11 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexlists.sty}[2021/01/27 lists]
 
+% Provides support for this output mark-up from Sphinx latex writer:
+% - \sphinxsetlistlabels
+
+% Dependencies: the \spx@opt@maxlistdepth from sphinx.sty
+
 \newcommand\sphinxsetlistlabels[5]
 {% #1 = style, #2 = enum, #3 = enumnext, #4 = prefix, #5 = suffix
  % #2 and #3 are counters used by enumerate environement e.g. enumi, enumii.
diff --git a/sphinx/texinputs/sphinxlatexliterals.sty b/sphinx/texinputs/sphinxlatexliterals.sty
index 1238a9e92f1..bda032bca8a 100644
--- a/sphinx/texinputs/sphinxlatexliterals.sty
+++ b/sphinx/texinputs/sphinxlatexliterals.sty
@@ -3,16 +3,62 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexliterals.sty}[2021/01/27 code-blocks and parsed literals]
 
-% For highlighted code.
+% Provides support for this output mark-up from Sphinx latex writer:
+%
+% - macros:
+%   - \sphinxLiteralBlockLabel
+%   - \sphinxSetupCaptionForVerbatim
+%   - \sphinxSetupCodeBlockInFootnote
+%   - \sphinxhref
+%   - \sphinxnolinkurl
+%   - \sphinxresetverbatimhllines
+%   - \sphinxunactivateextrasandspace
+%   - \sphinxupquote
+%   - \sphinxurl
+%
+% - environments:
+%   - sphinxVerbatim
+%   - sphinxVerbatimintable
+%   - sphinxalltt
+%
+% Dependency:
+%
+% - hyperref (for \phantomsection and \capstart) (loaded later)
+%
+% Executes \RequirePackage for:
+%
+% - framed
+% - fancyvrb
+% - alltt
+% - upquote
+% - needspace
+
+% also in sphinxlatexadmonitions.sty:
+% This is a workaround to a "feature" of French lists, when literal block
+% follows immediately; usable generally (does only \par then), a priori...
+\providecommand*\sphinxvspacefixafterfrenchlists{%
+   \ifvmode\ifdim\lastskip<\z@ \vskip\parskip\fi\else\par\fi
+}
+
+% For framing allowing pagebreaks
+\RequirePackage{framed}
+% For source code
+% MEMO: fancyvrb is used mainly to
+% 1- control horizontal and vertical spacing
+% 2- optional line numbering
+% 3- optional line emphasizing
+% 4- while still allowing expansion of Pygments latex mark-up
+% Other aspects such as framing, caption handling, codeline wrapping are
+% added on top of it. We should stop using fancyvrb and implement
+% 1, 2, 3, 4 by own Sphinx fully native Verbatim. This would allow to solve
+% limitations with wrapped long code line not allowing page break.
 \RequirePackage{fancyvrb}
-\define@key{FV}{hllines}{\def\sphinx@verbatim@checkifhl##1{\in@{, ##1,}{#1}}}
-% sphinxVerbatim must be usable by third party without requiring hllines set-up
-\def\sphinxresetverbatimhllines{\def\sphinx@verbatim@checkifhl##1{\in@false}}
-\sphinxresetverbatimhllines
 % For parsed-literal blocks.
 \RequirePackage{alltt}
 % Display "real" single quotes in literal blocks.
 \RequirePackage{upquote}
+% Skip to next page if not enough space at bottom
+\RequirePackage{needspace}
 
 % Based on use of "fancyvrb.sty"'s Verbatim.
 % - with framing allowing page breaks ("framed.sty")
@@ -20,6 +66,12 @@
 % - with possibly of a top caption, non-separable by pagebreak.
 % - and usable inside tables or footnotes ("sphinxpackagefootnote.sty").
 
+% for emphasizing lines
+\define@key{FV}{hllines}{\def\sphinx@verbatim@checkifhl##1{\in@{, ##1,}{#1}}}
+% sphinxVerbatim must be usable by third party without requiring hllines set-up
+\def\sphinxresetverbatimhllines{\def\sphinx@verbatim@checkifhl##1{\in@false}}
+\sphinxresetverbatimhllines
+
 % Prior to Sphinx 1.5, \Verbatim and \endVerbatim were modified by Sphinx.
 % The aliases defined here are used in sphinxVerbatim environment and can
 % serve as hook-points with no need to modify \Verbatim itself.
@@ -36,7 +88,6 @@
 % analogous to \listoffigures, but for the code listings (foo = chosen title.)
 \newcommand*{\ext@literalblock}{lol}
 
-\newif\ifspx@inframed % flag set if we are already in a framed environment
 % if forced use of minipage encapsulation is needed (e.g. table cells)
 \newif\ifsphinxverbatimwithminipage   \sphinxverbatimwithminipagefalse
 
@@ -181,11 +232,6 @@
 % This box to measure contents if nested as inner \MakeFramed requires then
 % minipage encapsulation but too long contents then break outer \MakeFramed
 \newbox\sphinxVerbatim@ContentsBox
-% This is a workaround to a "feature" of French lists, when literal block
-% follows immediately; usable generally (does only \par then), a priori...
-\newcommand*\sphinxvspacefixafterfrenchlists{%
-   \ifvmode\ifdim\lastskip<\z@ \vskip\parskip\fi\else\par\fi
-}
 % Holder macro for labels of literal blocks. Set-up by LaTeX writer.
 \newcommand*\sphinxLiteralBlockLabel {}
 \newcommand*\sphinxSetupCaptionForVerbatim [1]
diff --git a/sphinx/texinputs/sphinxlatexnumfig.sty b/sphinx/texinputs/sphinxlatexnumfig.sty
index fa6e674659e..6d72961051e 100644
--- a/sphinx/texinputs/sphinxlatexnumfig.sty
+++ b/sphinx/texinputs/sphinxlatexnumfig.sty
@@ -3,6 +3,9 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexnumfig.sty}[2021/01/27 numbering]
 
+% Requires: remreset (old LaTeX only)
+% relates to numfig and numfig_secnum_depth configuration variables
+
 % LaTeX 2018-04-01 and later provides \@removefromreset
 \ltx@ifundefined{@removefromreset}
     {\RequirePackage{remreset}}
diff --git a/sphinx/texinputs/sphinxlatexobjects.sty b/sphinx/texinputs/sphinxlatexobjects.sty
index c0e4ddc0ec7..26e2862c116 100644
--- a/sphinx/texinputs/sphinxlatexobjects.sty
+++ b/sphinx/texinputs/sphinxlatexobjects.sty
@@ -3,7 +3,20 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexobjects.sty}[2021/01/27 documentation environments]
 
-%  (some macros here used by \maketitle in sphinxmanual.cls and sphinxhowto.cls)
+% Provides support for this output mark-up from Sphinx latex writer:
+%
+% - environments
+%
+%   - fulllineitems
+%   - productionlist
+%   - optionlist
+%   - DUlineblock (also "lineblock")
+%
+% - macros
+%
+%   - \DUrole
+%   - various legacy support macros related to author and release
+%     data of documented objects and modules.
 
 % \moduleauthor{name}{email}
 \newcommand{\moduleauthor}[2]{}
diff --git a/sphinx/texinputs/sphinxlatexshadowbox.sty b/sphinx/texinputs/sphinxlatexshadowbox.sty
index 2c6c7a6e2d9..8d6c78666cf 100644
--- a/sphinx/texinputs/sphinxlatexshadowbox.sty
+++ b/sphinx/texinputs/sphinxlatexshadowbox.sty
@@ -3,6 +3,20 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexshadowbox.sty}[2021/01/27 sphinxShadowBox]
 
+% Provides support for this output mark-up from Sphinx latex writer:
+%
+% - sphinxShadowBox (environment)
+%
+% Dependencies (they do not need to be defined at time of loading):
+%
+% - of course the various colour and dimension options handled via sphinx.sty
+% - dimension register \spx@image@maxheight from sphinxlatexgraphics.sty
+% - \savenotes/\spewnotes from sphinxpackagefootnote
+% - \ifspx@inframed defined in sphinx.sty
+%
+% Requires:
+\RequirePackage{framed}
+
 % Again based on use of "framed.sty", this allows breakable framed boxes.
 \long\def\spx@ShadowFBox#1{%
   \leavevmode\begingroup
diff --git a/sphinx/texinputs/sphinxlatexstyleheadings.sty b/sphinx/texinputs/sphinxlatexstyleheadings.sty
index e0195597ec9..fa9be82b44d 100644
--- a/sphinx/texinputs/sphinxlatexstyleheadings.sty
+++ b/sphinx/texinputs/sphinxlatexstyleheadings.sty
@@ -28,6 +28,23 @@
    \fi
   }%
  }{}
+
+% Augment the sectioning commands used to get our own font family in place,
+% and reset some internal data items (\titleformat from titlesec package)
+\titleformat{\section}{\Large\py@HeaderFamily}%
+            {\py@TitleColor\thesection}{0.5em}{\py@TitleColor}
+\titleformat{\subsection}{\large\py@HeaderFamily}%
+            {\py@TitleColor\thesubsection}{0.5em}{\py@TitleColor}
+\titleformat{\subsubsection}{\py@HeaderFamily}%
+            {\py@TitleColor\thesubsubsection}{0.5em}{\py@TitleColor}
+% By default paragraphs (and subsubsections) will not be numbered because
+% sphinxmanual.cls and sphinxhowto.cls set secnumdepth to 2
+\titleformat{\paragraph}{\py@HeaderFamily}%
+            {\py@TitleColor\theparagraph}{0.5em}{\py@TitleColor}
+\titleformat{\subparagraph}{\py@HeaderFamily}%
+            {\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor}
+
+
 % Since Sphinx 1.5, users should use HeaderFamily key to 'sphinxsetup' rather
 % than defining their own \py@HeaderFamily command (which is still possible).
 % Memo: \py@HeaderFamily is also used by \maketitle as defined in
@@ -57,19 +74,10 @@
     }}
 }{}% <-- "false" clause of \@ifpackagewith
 
-% Augment the sectioning commands used to get our own font family in place,
-% and reset some internal data items (\titleformat from titlesec package)
-\titleformat{\section}{\Large\py@HeaderFamily}%
-            {\py@TitleColor\thesection}{0.5em}{\py@TitleColor}
-\titleformat{\subsection}{\large\py@HeaderFamily}%
-            {\py@TitleColor\thesubsection}{0.5em}{\py@TitleColor}
-\titleformat{\subsubsection}{\py@HeaderFamily}%
-            {\py@TitleColor\thesubsubsection}{0.5em}{\py@TitleColor}
-% By default paragraphs (and subsubsections) will not be numbered because
-% sphinxmanual.cls and sphinxhowto.cls set secnumdepth to 2
-\titleformat{\paragraph}{\py@HeaderFamily}%
-            {\py@TitleColor\theparagraph}{0.5em}{\py@TitleColor}
-\titleformat{\subparagraph}{\py@HeaderFamily}%
-            {\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor}
+% fix fncychap's bug which uses prematurely the \textwidth value
+\@ifpackagewith{fncychap}{Bjornstrup}
+ {\AtBeginDocument{\mylen\textwidth\advance\mylen-2\myhi}}%
+ {}% <-- "false" clause of \@ifpackagewith
+
 
 \endinput
diff --git a/sphinx/texinputs/sphinxlatexstylepage.sty b/sphinx/texinputs/sphinxlatexstylepage.sty
index c749c302d8a..4066129bf24 100644
--- a/sphinx/texinputs/sphinxlatexstylepage.sty
+++ b/sphinx/texinputs/sphinxlatexstylepage.sty
@@ -17,6 +17,7 @@
 \sloppy
 \hbadness = 5000                % don't print trivial gripes
 
+% Require package fancyhdr except under memoir class
 \@ifclassloaded{memoir}{}{\RequirePackage{fancyhdr}}
 % Use \pagestyle{normal} as the primary pagestyle for text.
 % Redefine the 'normal' header/footer style when using "fancyhdr" package:
@@ -74,9 +75,5 @@
    % Users of memoir class are invited to redefine 'normal' style in preamble
   }
 
-% fix fncychap's bug which uses prematurely the \textwidth value
-\@ifpackagewith{fncychap}{Bjornstrup}
- {\AtBeginDocument{\mylen\textwidth\advance\mylen-2\myhi}}%
- {}% <-- "false" clause of \@ifpackagewith
 
 \endinput
diff --git a/sphinx/texinputs/sphinxlatexstyletext.sty b/sphinx/texinputs/sphinxlatexstyletext.sty
index f780bf71bc8..675eb117847 100644
--- a/sphinx/texinputs/sphinxlatexstyletext.sty
+++ b/sphinx/texinputs/sphinxlatexstyletext.sty
@@ -3,6 +3,9 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatexstyletext.sty}[2021/01/27 text styling]
 
+% Basically everything here consists of macros which are part of the latex
+% markup produced by the Sphinx latex writer
+
 % Some custom font markup commands.
 \protected\def\sphinxstrong#1{\textbf{#1}}
 \protected\def\sphinxcode#1{\texttt{#1}}
diff --git a/sphinx/texinputs/sphinxlatextables.sty b/sphinx/texinputs/sphinxlatextables.sty
index 54691ed3825..c3c1d6ad1ff 100644
--- a/sphinx/texinputs/sphinxlatextables.sty
+++ b/sphinx/texinputs/sphinxlatextables.sty
@@ -3,9 +3,37 @@
 % change this info string if making any custom modification
 \ProvidesFile{sphinxlatextables.sty}[2021/01/27 tables]%
 
-% IMPORTANT: all this is to be kept in sync with the templates
-% longtable.tex_t, tabular.tex_t, tabulary.tex_t and the actual
-% Sphinx latex writer output.
+% Provides support for this output mark-up from Sphinx latex writer
+% and table templates:
+%
+% - the tabulary and longtable environments from the eponymous packages
+% - the varwidth environment
+% - the >{} etc mark-up possible in tabularcolumns is from array package
+%     which is loaded by longtable and tabulary
+% - \X, \Y, T column types; others (L, C, R, J) are from tabulary package
+% - \sphinxaftertopcaption
+% - \sphinxatlongtableend
+% - \sphinxatlongtablestart
+% - \sphinxattableend
+% - \sphinxattablestart
+% - \sphinxcapstartof
+% - \sphinxcolwidth
+% - \sphinxlongtablecapskipadjust
+% - \sphinxmultirow
+% - \sphinxstartmulticolumn
+% - \sphinxstopmulticolumn
+% - \sphinxtablestrut
+% - \sphinxthecaptionisattop
+% - \sphinxthelongtablecaptionisattop
+%
+% Executes \RequirePackage for:
+%
+% - tabulary
+% - longtable
+% - varwidth
+%
+% Extends tabulary and longtable via patches and custom macros to support
+% merged cells possibly containing code-blocks in complex tables
 
 \RequirePackage{tabulary}
 % tabulary has a bug with its re-definition of \multicolumn in its first pass
diff --git a/sphinx/texinputs/sphinxpackagefootnote.sty b/sphinx/texinputs/sphinxpackagefootnote.sty
index 02c729c96aa..1de38867c68 100644
--- a/sphinx/texinputs/sphinxpackagefootnote.sty
+++ b/sphinx/texinputs/sphinxpackagefootnote.sty
@@ -1,6 +1,11 @@
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{sphinxpackagefootnote}%
  [2021/01/26 v1.1b footnotehyper adapted to sphinx (Sphinx team)]
+% Provides support for this output mark-up from Sphinx latex writer:
+% - footnote environment
+% - savenotes environment (table templates)
+% - \sphinxfootnotemark
+%
 %%
 %% Package: sphinxpackagefootnote
 %% Version: based on footnotehyper.sty 2021/01/26 v1.1b

From a5939ea588bd819614e497a569005a844fe8017d Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Sun, 31 Jan 2021 15:47:06 +0100
Subject: [PATCH 121/305] Fix accidental revert of f937facc (#8767) by #8790
 merge

Due to file renaming
---
 sphinx/texinputs/sphinxlatexstyletext.sty | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/sphinx/texinputs/sphinxlatexstyletext.sty b/sphinx/texinputs/sphinxlatexstyletext.sty
index 675eb117847..ab50aed569b 100644
--- a/sphinx/texinputs/sphinxlatexstyletext.sty
+++ b/sphinx/texinputs/sphinxlatexstyletext.sty
@@ -28,8 +28,8 @@
 \def\sphinxstyleindexextra   #1{ (\emph{#1})}
 \def\sphinxstyleindexpageref #1{, \pageref{#1}}
 \def\sphinxstyleindexpagemain#1{\textbf{#1}}
-\protected\def\spxentry#1{#1}% will get \let to \sphinxstyleindexentry in index
-\protected\def\spxextra#1{#1}% will get \let to \sphinxstyleindexextra in index
+\def\spxentry{\@backslashchar spxentry}% let to \sphinxstyleindexentry in index
+\def\spxextra{\@backslashchar spxextra}% let to \sphinxstyleindexextra in index
 \def\sphinxstyleindexlettergroup #1%
     {{\Large\sffamily#1}\nopagebreak\vspace{1mm}}
 \def\sphinxstyleindexlettergroupDefault #1%

From af4015a788469511415fd73cb3ba0857a033a522 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Tue, 2 Feb 2021 19:08:13 +0100
Subject: [PATCH 122/305] Fix lost LaTeX in merge

---
 sphinx/texinputs/sphinxlatexgraphics.sty | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/texinputs/sphinxlatexgraphics.sty b/sphinx/texinputs/sphinxlatexgraphics.sty
index d3e38b02d48..908ca36967f 100644
--- a/sphinx/texinputs/sphinxlatexgraphics.sty
+++ b/sphinx/texinputs/sphinxlatexgraphics.sty
@@ -40,7 +40,7 @@
 \AtBeginDocument{\spx@image@maxheight\textheight}
 
 % box scratch register
-\newdimen\spx@image@box
+\newbox\spx@image@box
 \newcommand*{\sphinxsafeincludegraphics}[2][]{%
     % #1 contains possibly width=, height=, but no scale= since 1.8.4
     \setbox\spx@image@box\hbox{\includegraphics[#1,draft]{#2}}%

From e7b05111bcd500d595fea375d24bca0f0915b793 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 3 Feb 2021 09:42:21 +0100
Subject: [PATCH 123/305] Re-insert if isinstance(node, ast.Constant): into py
 _parse_annotation

As master drop python 3.5 support, conditional

    if sys.version_info >= (3, 6):

not needed anymore.  This hunk had got lost in merge.

	modified:   sphinx/domains/python.py
---
 sphinx/domains/python.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 80028e2b2e2..02a32f47c58 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -143,6 +143,12 @@ def unparse(node: ast.AST) -> List[Node]:
 
             return result
         else:
+            if isinstance(node, ast.Constant):  # type: ignore
+                if node.value is Ellipsis:
+                    return [addnodes.desc_sig_punctuation('', "...")]
+                else:
+                    return [nodes.Text(node.value)]
+
             if sys.version_info < (3, 8):
                 if isinstance(node, ast.Ellipsis):
                     return [addnodes.desc_sig_punctuation('', "...")]

From 8b1bf6dfc9df07fdba9b71fbff96a7ce4d86eff5 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 3 Feb 2021 21:29:53 +0900
Subject: [PATCH 124/305] refactor: py domain: Put if-block for ast.Constant to
 the root level

---
 sphinx/domains/python.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 02a32f47c58..5e430a1d732 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -108,6 +108,11 @@ def unparse(node: ast.AST) -> List[Node]:
             return result
         elif isinstance(node, ast.BitOr):
             return [nodes.Text(' '), addnodes.desc_sig_punctuation('', '|'), nodes.Text(' ')]
+        elif isinstance(node, ast.Constant):  # type: ignore
+            if node.value is Ellipsis:
+                return [addnodes.desc_sig_punctuation('', "...")]
+            else:
+                return [nodes.Text(node.value)]
         elif isinstance(node, ast.Expr):
             return unparse(node.value)
         elif isinstance(node, ast.Index):
@@ -143,12 +148,6 @@ def unparse(node: ast.AST) -> List[Node]:
 
             return result
         else:
-            if isinstance(node, ast.Constant):  # type: ignore
-                if node.value is Ellipsis:
-                    return [addnodes.desc_sig_punctuation('', "...")]
-                else:
-                    return [nodes.Text(node.value)]
-
             if sys.version_info < (3, 8):
                 if isinstance(node, ast.Ellipsis):
                     return [addnodes.desc_sig_punctuation('', "...")]

From 08c2c23bb4b0eb1c3b6a9a889ad488612c33d0e0 Mon Sep 17 00:00:00 2001
From: Harrissou Sant-anna <delazj@gmail.com>
Date: Mon, 8 Feb 2021 13:03:16 +0100
Subject: [PATCH 125/305] Make code block types more visible

---
 doc/usage/restructuredtext/directives.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/doc/usage/restructuredtext/directives.rst b/doc/usage/restructuredtext/directives.rst
index e8b88c21b25..53625ac9e11 100644
--- a/doc/usage/restructuredtext/directives.rst
+++ b/doc/usage/restructuredtext/directives.rst
@@ -404,10 +404,15 @@ Showing code examples
            single: sourcecode
 
 There are multiple ways to show syntax-highlighted literal code blocks in
-Sphinx: using :ref:`reST doctest blocks <rst-doctest-blocks>`; using :ref:`reST
-literal blocks <rst-literal-blocks>`, optionally in combination with the
-:rst:dir:`highlight` directive; using the :rst:dir:`code-block` directive; and
-using the :rst:dir:`literalinclude` directive. Doctest blocks can only be used
+Sphinx:
+
+* using :ref:`reST doctest blocks <rst-doctest-blocks>`;
+* using :ref:`reST literal blocks <rst-literal-blocks>`, optionally in
+  combination with the :rst:dir:`highlight` directive;
+* using the :rst:dir:`code-block` directive;
+* and using the :rst:dir:`literalinclude` directive.
+
+Doctest blocks can only be used
 to show interactive Python sessions, while the remaining three can be used for
 other languages. Of these three, literal blocks are useful when an entire
 document, or at least large sections of it, use code blocks with the same

From d25c3ad2419aa01ab0b64898ebe71bb7139928cb Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 7 Feb 2021 19:29:24 +0900
Subject: [PATCH 126/305] Update type annotations

---
 sphinx/application.py     | 3 +++
 sphinx/deprecation.py     | 2 +-
 sphinx/locale/__init__.py | 8 +++++---
 sphinx/pycode/ast.py      | 4 ++--
 sphinx/util/i18n.py       | 6 +++---
 sphinx/util/images.py     | 4 ++--
 sphinx/util/logging.py    | 6 ++++--
 sphinx/util/matching.py   | 6 +++---
 sphinx/util/tags.py       | 2 +-
 9 files changed, 24 insertions(+), 17 deletions(-)

diff --git a/sphinx/application.py b/sphinx/application.py
index c4fc9c2123c..b5cc4426844 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -130,6 +130,9 @@ class Sphinx:
     :ivar outdir: Directory for storing build documents.
     """
 
+    warningiserror: bool
+    _warncount: int
+
     def __init__(self, srcdir: str, confdir: Optional[str], outdir: str, doctreedir: str,
                  buildername: str, confoverrides: Dict = None,
                  status: IO = sys.stdout, warning: IO = sys.stderr,
diff --git a/sphinx/deprecation.py b/sphinx/deprecation.py
index 1d602fa8262..aeefcc61fc0 100644
--- a/sphinx/deprecation.py
+++ b/sphinx/deprecation.py
@@ -30,7 +30,7 @@ class RemovedInSphinx60Warning(PendingDeprecationWarning):
 
 
 def deprecated_alias(modname: str, objects: Dict[str, object],
-                     warning: "Type[Warning]", names: Dict[str, str] = None) -> None:
+                     warning: "Type[Warning]", names: Dict[str, str] = {}) -> None:
     module = import_module(modname)
     sys.modules[modname] = _ModuleWrapper(  # type: ignore
         module, modname, objects, warning, names)
diff --git a/sphinx/locale/__init__.py b/sphinx/locale/__init__.py
index bedd9e1cba7..28dda2e1a43 100644
--- a/sphinx/locale/__init__.py
+++ b/sphinx/locale/__init__.py
@@ -106,7 +106,7 @@ def __repr__(self) -> str:
 translators = defaultdict(NullTranslations)  # type: Dict[Tuple[str, str], NullTranslations]
 
 
-def init(locale_dirs: List[Optional[str]], language: str,
+def init(locale_dirs: List[Optional[str]], language: Optional[str],
          catalog: str = 'sphinx', namespace: str = 'general') -> Tuple[NullTranslations, bool]:
     """Look for message catalogs in `locale_dirs` and *ensure* that there is at
     least a NullTranslations catalog set in `translators`. If called multiple
@@ -123,9 +123,11 @@ def init(locale_dirs: List[Optional[str]], language: str,
 
     if language and '_' in language:
         # for language having country code (like "de_AT")
-        languages = [language, language.split('_')[0]]
-    else:
+        languages = [language, language.split('_')[0]]  # type: Optional[List[str]]
+    elif language:
         languages = [language]
+    else:
+        languages = None
 
     # loading
     for dir_ in locale_dirs:
diff --git a/sphinx/pycode/ast.py b/sphinx/pycode/ast.py
index b9fbfc83d73..e4e773b2523 100644
--- a/sphinx/pycode/ast.py
+++ b/sphinx/pycode/ast.py
@@ -108,7 +108,7 @@ def _visit_arg_with_default(self, arg: ast.arg, default: Optional[ast.AST]) -> s
         return name
 
     def visit_arguments(self, node: ast.arguments) -> str:
-        defaults = list(node.defaults)
+        defaults = list(node.defaults)  # type: List[Optional[ast.expr]]
         positionals = len(node.args)
         posonlyargs = 0
         if hasattr(node, "posonlyargs"):  # for py38+
@@ -117,7 +117,7 @@ def visit_arguments(self, node: ast.arguments) -> str:
         for _ in range(len(defaults), positionals):
             defaults.insert(0, None)
 
-        kw_defaults = list(node.kw_defaults)
+        kw_defaults = list(node.kw_defaults)  # type: List[Optional[ast.expr]]
         for _ in range(len(kw_defaults), len(node.kwonlyargs)):
             kw_defaults.insert(0, None)
 
diff --git a/sphinx/util/i18n.py b/sphinx/util/i18n.py
index 3a5aca58e61..d647d6d050e 100644
--- a/sphinx/util/i18n.py
+++ b/sphinx/util/i18n.py
@@ -12,7 +12,7 @@
 import re
 from datetime import datetime, timezone
 from os import path
-from typing import TYPE_CHECKING, Callable, Generator, List, NamedTuple, Tuple, Union
+from typing import TYPE_CHECKING, Callable, Generator, List, NamedTuple, Optional, Tuple, Union
 
 import babel.dates
 from babel.messages.mofile import write_mo
@@ -170,7 +170,7 @@ def docname_to_domain(docname: str, compation: Union[bool, str]) -> str:
 date_format_re = re.compile('(%s)' % '|'.join(date_format_mappings))
 
 
-def babel_format_date(date: datetime, format: str, locale: str,
+def babel_format_date(date: datetime, format: str, locale: Optional[str],
                       formatter: Callable = babel.dates.format_date) -> str:
     if locale is None:
         locale = 'en'
@@ -191,7 +191,7 @@ def babel_format_date(date: datetime, format: str, locale: str,
         return format
 
 
-def format_date(format: str, date: datetime = None, language: str = None) -> str:
+def format_date(format: str, date: datetime = None, language: Optional[str] = None) -> str:
     if date is None:
         # If time is not specified, try to use $SOURCE_DATE_EPOCH variable
         # See https://wiki.debian.org/ReproducibleBuilds/TimestampsProposal
diff --git a/sphinx/util/images.py b/sphinx/util/images.py
index 8c32e341408..a2a31f55ba3 100644
--- a/sphinx/util/images.py
+++ b/sphinx/util/images.py
@@ -12,7 +12,7 @@
 import imghdr
 from collections import OrderedDict
 from os import path
-from typing import IO, NamedTuple, Optional, Tuple
+from typing import IO, BinaryIO, NamedTuple, Optional, Tuple
 
 import imagesize
 
@@ -103,7 +103,7 @@ def parse_data_uri(uri: str) -> Optional[DataURI]:
     return DataURI(mimetype, charset, image_data)
 
 
-def test_svg(h: bytes, f: IO) -> Optional[str]:
+def test_svg(h: bytes, f: Optional[BinaryIO]) -> Optional[str]:
     """An additional imghdr library helper; test the header is SVG's or not."""
     try:
         if '<svg' in h.decode().lower():
diff --git a/sphinx/util/logging.py b/sphinx/util/logging.py
index 1c480e01706..dd04b3f238c 100644
--- a/sphinx/util/logging.py
+++ b/sphinx/util/logging.py
@@ -12,7 +12,7 @@
 import logging.handlers
 from collections import defaultdict
 from contextlib import contextmanager
-from typing import IO, TYPE_CHECKING, Any, Dict, Generator, List, Tuple, Type, Union
+from typing import IO, TYPE_CHECKING, Any, Dict, Generator, List, Optional, Tuple, Type, Union
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -353,6 +353,8 @@ def is_suppressed_warning(type: str, subtype: str, suppress_warnings: List[str])
     if type is None:
         return False
 
+    subtarget: Optional[str]
+
     for warning_type in suppress_warnings:
         if '.' in warning_type:
             target, subtarget = warning_type.split('.', 1)
@@ -506,7 +508,7 @@ class WarningLogRecordTranslator(SphinxLogRecordTranslator):
     LogRecordClass = SphinxWarningLogRecord
 
 
-def get_node_location(node: Node) -> str:
+def get_node_location(node: Node) -> Optional[str]:
     (source, line) = get_source_line(node)
     if source and line:
         return "%s:%s" % (source, line)
diff --git a/sphinx/util/matching.py b/sphinx/util/matching.py
index d33ae03336a..2ed8046778f 100644
--- a/sphinx/util/matching.py
+++ b/sphinx/util/matching.py
@@ -9,7 +9,7 @@
 """
 
 import re
-from typing import Callable, Dict, Iterable, List, Match, Pattern
+from typing import Callable, Dict, Iterable, List, Match, Optional, Pattern
 
 from sphinx.util.osutil import canon_path
 
@@ -60,7 +60,7 @@ def _translate_pattern(pat: str) -> str:
     return res + '$'
 
 
-def compile_matchers(patterns: List[str]) -> List[Callable[[str], Match[str]]]:
+def compile_matchers(patterns: List[str]) -> List[Callable[[str], Optional[Match[str]]]]:
     return [re.compile(_translate_pattern(pat)).match for pat in patterns]
 
 
@@ -89,7 +89,7 @@ def match(self, string: str) -> bool:
 _pat_cache = {}  # type: Dict[str, Pattern]
 
 
-def patmatch(name: str, pat: str) -> Match[str]:
+def patmatch(name: str, pat: str) -> Optional[Match[str]]:
     """Return if name matches pat.  Adapted from fnmatch module."""
     if pat not in _pat_cache:
         _pat_cache[pat] = re.compile(_translate_pattern(pat))
diff --git a/sphinx/util/tags.py b/sphinx/util/tags.py
index c502312202b..cf3d5340002 100644
--- a/sphinx/util/tags.py
+++ b/sphinx/util/tags.py
@@ -22,7 +22,7 @@ class BooleanParser(Parser):
     """
 
     def parse_compare(self) -> Node:
-        node = None  # type: Node
+        node: Node
         token = self.stream.current
         if token.type == 'name':
             if token.value in ('true', 'false', 'True', 'False'):

From 8b786382e45f5a6a3a5300ab3d157ea92323c4bd Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 10 Feb 2021 23:09:44 +0100
Subject: [PATCH 127/305] Update latex comment

---
 sphinx/texinputs/sphinxlatexgraphics.sty | 1 +
 1 file changed, 1 insertion(+)

diff --git a/sphinx/texinputs/sphinxlatexgraphics.sty b/sphinx/texinputs/sphinxlatexgraphics.sty
index 908ca36967f..fd0aae6386a 100644
--- a/sphinx/texinputs/sphinxlatexgraphics.sty
+++ b/sphinx/texinputs/sphinxlatexgraphics.sty
@@ -22,6 +22,7 @@
 %
 % - \sphinxsafeincludegraphics (default of \sphinxincludegraphics since 2.0)
 % - \spx@image@maxheight dimension (used by sphinxlatexadmonitions.sty)
+% - \spx@image@box scratch box register (also used by sphinxlatexliterals.sty)
 %
 % Requires:
 % \RequirePackage{graphicx}% done in sphinx.sty

From 473718c4d46f8623785e6dd625c5f7140be1e403 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Sat, 13 Feb 2021 09:40:18 +0100
Subject: [PATCH 128/305] LaTeX, better workaround for a Pygments <= 2.7.4 line
 spacing issue

Closes: #8874

Relates #4249
---
 CHANGES                     |  2 ++
 sphinx/highlighting.py      | 15 +++++++++++++++
 sphinx/texinputs/sphinx.sty | 11 -----------
 3 files changed, 17 insertions(+), 11 deletions(-)

diff --git a/CHANGES b/CHANGES
index 590f0570dbe..065dbb84401 100644
--- a/CHANGES
+++ b/CHANGES
@@ -75,6 +75,8 @@ Bugs fixed
   change) with late TeXLive 2019
 * #8253: LaTeX: Figures with no size defined get overscaled (compared to images
   with size explicitly set in pixels) (fixed for ``'pdflatex'/'lualatex'`` only)
+* #8874: LaTeX: the fix to two minor Pygments LaTeXFormatter output issues ignore
+  Pygments style
 
 Testing
 --------
diff --git a/sphinx/highlighting.py b/sphinx/highlighting.py
index 8425009f78e..18d2f72bd81 100644
--- a/sphinx/highlighting.py
+++ b/sphinx/highlighting.py
@@ -8,10 +8,12 @@
     :license: BSD, see LICENSE for details.
 """
 
+from distutils.version import LooseVersion
 from functools import partial
 from importlib import import_module
 from typing import Any, Dict
 
+from pygments import __version__ as pygmentsversion
 from pygments import highlight
 from pygments.filters import ErrorToken
 from pygments.formatter import Formatter
@@ -50,6 +52,19 @@
 _LATEX_ADD_STYLES = r'''
 \renewcommand\PYGZsq{\textquotesingle}
 '''
+# fix extra space between lines when Pygments highlighting uses \fcolorbox
+# add a {..} to limit \fboxsep scope, and force \fcolorbox use correct value
+# cf pygments #1708 which makes this unneeded for Pygments > 2.7.4
+_LATEX_ADD_STYLES_FIXPYG = r'''
+\makeatletter
+\let\spx@original@fcolorbox\fcolorbox
+\def\spx@fixpyg@fcolorbox{\fboxsep-\fboxrule\spx@original@fcolorbox}
+\def\PYG#1#2{\PYG@reset\PYG@toks#1+\relax+%
+             {\let\fcolorbox\spx@fixpyg@fcolorbox\PYG@do{#2}}}
+\makeatother
+'''
+if tuple(LooseVersion(pygmentsversion).version) <= (2, 7, 4):
+    _LATEX_ADD_STYLES += _LATEX_ADD_STYLES_FIXPYG
 
 
 class PygmentsBridge:
diff --git a/sphinx/texinputs/sphinx.sty b/sphinx/texinputs/sphinx.sty
index a71c64ffca6..322d5971bdb 100644
--- a/sphinx/texinputs/sphinx.sty
+++ b/sphinx/texinputs/sphinx.sty
@@ -271,17 +271,6 @@
 %% PYGMENTS
 % stylesheet for highlighting with pygments
 \RequirePackage{sphinxhighlight}
-% fix baseline increase from Pygments latex formatter in case of error tokens
-% and keep \fboxsep's scope local via added braces
-\def\PYG@tok@err{%
-    \def\PYG@bc##1{{\setlength{\fboxsep}{-\fboxrule}%
-                    \fcolorbox[rgb]{1.00,0.00,0.00}{1,1,1}{\strut ##1}}}%
-}
-\def\PYG@tok@cs{%
-    \def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}%
-    \def\PYG@bc##1{{\setlength{\fboxsep}{0pt}%
-                    \colorbox[rgb]{1.00,0.94,0.94}{\strut ##1}}}%
-}%
 
 
 %% TABLES

From cea87d13acaa963526f8ac67efb101f2cfa53ab3 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Sat, 13 Feb 2021 10:20:05 +0100
Subject: [PATCH 129/305] Mention pygments_style in sphinxhighlight.sty

---
 sphinx/builders/latex/__init__.py | 3 ++-
 sphinx/highlighting.py            | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/sphinx/builders/latex/__init__.py b/sphinx/builders/latex/__init__.py
index dc533b48635..d8dc1aff40b 100644
--- a/sphinx/builders/latex/__init__.py
+++ b/sphinx/builders/latex/__init__.py
@@ -256,7 +256,8 @@ def write_stylesheet(self) -> None:
         with open(stylesheet, 'w') as f:
             f.write('\\NeedsTeXFormat{LaTeX2e}[1995/12/01]\n')
             f.write('\\ProvidesPackage{sphinxhighlight}'
-                    '[2016/05/29 stylesheet for highlighting with pygments]\n\n')
+                    '[2016/05/29 stylesheet for highlighting with pygments]\n')
+            f.write('% Its contents depend on pygments_style configuration variable.\n\n')
             f.write(highlighter.get_stylesheet())
 
     def write(self, *ignored: Any) -> None:
diff --git a/sphinx/highlighting.py b/sphinx/highlighting.py
index 18d2f72bd81..ad010474e58 100644
--- a/sphinx/highlighting.py
+++ b/sphinx/highlighting.py
@@ -57,6 +57,7 @@
 # cf pygments #1708 which makes this unneeded for Pygments > 2.7.4
 _LATEX_ADD_STYLES_FIXPYG = r'''
 \makeatletter
+% fix for Pygments <= 2.7.4
 \let\spx@original@fcolorbox\fcolorbox
 \def\spx@fixpyg@fcolorbox{\fboxsep-\fboxrule\spx@original@fcolorbox}
 \def\PYG#1#2{\PYG@reset\PYG@toks#1+\relax+%

From 6ca568c1d83524bb3e7f620ef84d5dcc43a72e52 Mon Sep 17 00:00:00 2001
From: Merry Bass <79108256+merrybass@users.noreply.github.com>
Date: Mon, 15 Feb 2021 18:59:35 +0000
Subject: [PATCH 130/305] sphinx.ext.extlinks: Allow ``%s`` in link caption
 string

Tweak syntax of extlinks to also allow ``%s`` in the link caption part.
Like for the base URL ``%s`` will be substituted with the content of the
role.  This allows configurations like

    extlinks = {'quarter': ('https://example.org/quaters/%s',
                          '%s. quarter')}

with ``:quarter:`2``` getting replaced by a link titled `2. quarter`.

The requirement for the caption string is to be either None or contain
exactly one ``%s``.  If neither is the case, then we emit a warning and
fall back to the old behaviour which is concatenating the caption string
with the role content.
---
 doc/usage/extensions/extlinks.rst | 17 ++++++++---------
 sphinx/ext/extlinks.py            | 25 ++++++++++++++++---------
 2 files changed, 24 insertions(+), 18 deletions(-)

diff --git a/doc/usage/extensions/extlinks.rst b/doc/usage/extensions/extlinks.rst
index e1d729f5c5b..08a419b6650 100644
--- a/doc/usage/extensions/extlinks.rst
+++ b/doc/usage/extensions/extlinks.rst
@@ -23,29 +23,28 @@ The extension adds a config value:
 .. confval:: extlinks
 
    This config value must be a dictionary of external sites, mapping unique
-   short alias names to a base URL and a *prefix*.  For example, to create an
+   short alias names to a base URL and a *caption*.  For example, to create an
    alias for the above mentioned issues, you would add ::
 
       extlinks = {'issue': ('https://github.com/sphinx-doc/sphinx/issues/%s',
-                            'issue ')}
+                            'issue %s')}
 
    Now, you can use the alias name as a new role, e.g. ``:issue:`123```.  This
    then inserts a link to https://github.com/sphinx-doc/sphinx/issues/123.
    As you can see, the target given in the role is substituted in the base URL
    in the place of ``%s``.
 
-   The link *caption* depends on the second item in the tuple, the *prefix*:
+   The link caption depends on the second item in the tuple, the *caption*:
 
-   - If the prefix is ``None``, the link caption is the full URL.
-   - If the prefix is the empty string, the link caption is the partial URL
-     given in the role content (``123`` in this case.)
-   - If the prefix is a non-empty string, the link caption is the partial URL,
-     prepended by the prefix -- in the above example, the link caption would be
+   - If *caption* is ``None``, the link caption is the full URL.
+   - If *caption* is a string, then it must contain ``%s`` exactly once.  In
+     this case the link caption is *caption* with the partial URL substituted
+     for ``%s`` -- in the above example, the link caption would be
      ``issue 123``.
 
    You can also use the usual "explicit title" syntax supported by other roles
    that generate links, i.e. ``:issue:`this issue <123>```.  In this case, the
-   *prefix* is not relevant.
+   *caption* is not relevant.
 
 .. note::
 
diff --git a/sphinx/ext/extlinks.py b/sphinx/ext/extlinks.py
index d82c0378b2e..e846c66b8de 100644
--- a/sphinx/ext/extlinks.py
+++ b/sphinx/ext/extlinks.py
@@ -7,15 +7,15 @@
 
     This adds a new config value called ``extlinks`` that is created like this::
 
-       extlinks = {'exmpl': ('https://example.invalid/%s.html', prefix), ...}
+       extlinks = {'exmpl': ('https://example.invalid/%s.html', caption), ...}
 
     Now you can use e.g. :exmpl:`foo` in your documents.  This will create a
     link to ``https://example.invalid/foo.html``.  The link caption depends on
-    the *prefix* value given:
+    the *caption* value given:
 
     - If it is ``None``, the caption will be the full URL.
-    - If it is a string (empty or not), the caption will be the prefix prepended
-      to the role content.
+    - If it is a string, it must contain ``%s`` exactly once.  In this case the
+      caption will be *caption* with the role content substituted for ``%s``.
 
     You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`.
 
@@ -35,7 +35,7 @@
 from sphinx.util.typing import RoleFunction
 
 
-def make_link_role(base_url: str, prefix: str) -> RoleFunction:
+def make_link_role(base_url: str, caption: str) -> RoleFunction:
     def role(typ: str, rawtext: str, text: str, lineno: int,
              inliner: Inliner, options: Dict = {}, content: List[str] = []
              ) -> Tuple[List[Node], List[system_message]]:
@@ -50,18 +50,25 @@ def role(typ: str, rawtext: str, text: str, lineno: int,
                 % (typ, base_url), line=lineno)
             full_url = base_url + part
         if not has_explicit_title:
-            if prefix is None:
+            if caption is None:
                 title = full_url
             else:
-                title = prefix + part
+                try:
+                    title = caption % part
+                except (TypeError, ValueError):
+                    inliner.reporter.warning(
+                        'unable to expand %s extlink with caption %r, please make '
+                        'sure the caption contains \'%%s\' exactly once'
+                        % (typ, caption), line=lineno)
+                    title = caption + part
         pnode = nodes.reference(title, title, internal=False, refuri=full_url)
         return [pnode], []
     return role
 
 
 def setup_link_roles(app: Sphinx) -> None:
-    for name, (base_url, prefix) in app.config.extlinks.items():
-        app.add_role(name, make_link_role(base_url, prefix))
+    for name, (base_url, caption) in app.config.extlinks.items():
+        app.add_role(name, make_link_role(base_url, caption))
 
 
 def setup(app: Sphinx) -> Dict[str, Any]:

From 57ae92ce78cc337be78d27b0309cdaed33d39fde Mon Sep 17 00:00:00 2001
From: "Matthias C. M. Troffaes" <matthias.troffaes@gmail.com>
Date: Tue, 16 Feb 2021 09:24:10 +0000
Subject: [PATCH 131/305] fix potential getitem error in resolve_anyref

---
 sphinx/transforms/post_transforms/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/transforms/post_transforms/__init__.py b/sphinx/transforms/post_transforms/__init__.py
index 1c424050ab8..f8b01e81f7c 100644
--- a/sphinx/transforms/post_transforms/__init__.py
+++ b/sphinx/transforms/post_transforms/__init__.py
@@ -125,7 +125,7 @@ def resolve_anyref(self, refdoc: str, node: pending_xref, contnode: Element) ->
                 for role in domain.roles:
                     res = domain.resolve_xref(self.env, refdoc, self.app.builder,
                                               role, target, node, contnode)
-                    if res and isinstance(res[0], nodes.Element):
+                    if res and len(res) > 0 and isinstance(res[0], nodes.Element):
                         results.append(('%s:%s' % (domain.name, role), res))
         # now, see how many matches we got...
         if not results:

From 5dd431437402a334c6e263a1e2c1ac33ef069c53 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 17 Feb 2021 00:32:47 +0900
Subject: [PATCH 132/305] doc: Build PDF document on readthedocs

---
 .readthedocs.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 680a0e3b587..711298232bf 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -1,4 +1,8 @@
 version: 2
+
+formats:
+  - pdf
+
 python:
   version: 3
   install:

From 7caa1c7ec4b946c7295788f5277f515887978e62 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 17 Feb 2021 23:59:55 +0900
Subject: [PATCH 133/305] refactor: Remove meaningless type annotations

---
 sphinx/util/__init__.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index 6ae5e616251..83b2561f2b3 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -47,8 +47,8 @@
 logger = logging.getLogger(__name__)
 
 # Generally useful regular expressions.
-ws_re = re.compile(r'\s+')                      # type: Pattern
-url_re = re.compile(r'(?P<schema>.+)://.*')     # type: Pattern
+ws_re = re.compile(r'\s+')
+url_re = re.compile(r'(?P<schema>.+)://.*')
 
 
 # High-level utility functions.

From 7dacbd96c4fbae237f83682abc99b524f2cc31b3 Mon Sep 17 00:00:00 2001
From: Thomas Grainger <tagrain@gmail.com>
Date: Wed, 17 Feb 2021 14:50:33 +0000
Subject: [PATCH 134/305] migrate html_add_permalinks=None and
 html_add_permalinks=""

The docs list: Set it to None or the empty string to disable permalinks.
---
 sphinx/builders/html/__init__.py | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index c799b017671..fe5438e259e 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1221,15 +1221,26 @@ def validate_html_favicon(app: Sphinx, config: Config) -> None:
         config.html_favicon = None  # type: ignore
 
 
+UNSET = object()
+
+
 def migrate_html_add_permalinks(app: Sphinx, config: Config) -> None:
     """Migrate html_add_permalinks to html_permalinks*."""
-    if config.html_add_permalinks:
-        if (isinstance(config.html_add_permalinks, bool) and
-                config.html_add_permalinks is False):
-            config.html_permalinks = False  # type: ignore
-        else:
-            config.html_permalinks_icon = html.escape(config.html_add_permalinks)  # type: ignore  # NOQA
+    html_add_permalinks = config.html_add_permalinks
+    if html_add_permalinks is UNSET:
+        return
+
+    if (
+        html_add_permalinks is None or
+        html_add_permalinks is False or
+        html_add_permalinks == ""
+    ):
+        config.html_permalinks = False  # type: ignore[attr-defined]
+        return
 
+    config.html_permalinks_icon = html.escape(  # type: ignore[attr-defined]
+        config.html_add_permalinks
+    )
 
 # for compatibility
 import sphinxcontrib.serializinghtml  # NOQA
@@ -1261,7 +1272,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_config_value('html_sidebars', {}, 'html')
     app.add_config_value('html_additional_pages', {}, 'html')
     app.add_config_value('html_domain_indices', True, 'html', [list])
-    app.add_config_value('html_add_permalinks', None, 'html')
+    app.add_config_value('html_add_permalinks', UNSET, 'html')
     app.add_config_value('html_permalinks', True, 'html')
     app.add_config_value('html_permalinks_icon', '¶', 'html')
     app.add_config_value('html_use_index', True, 'html')

From ddef4950ee4dd73035ba29205acf651157a2440f Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Thu, 18 Feb 2021 12:47:14 +0100
Subject: [PATCH 135/305] LaTeX: let bookmarks use high default depth

Add bookmarksdepth key to latex_elements['sphinxsetup']
---
 CHANGES                            |  1 +
 doc/changes.rst                    |  1 -
 doc/conf.py                        |  3 +--
 doc/latex.rst                      | 11 +++++++++++
 sphinx/templates/latex/latex.tex_t |  2 ++
 sphinx/texinputs/sphinx.sty        |  2 ++
 6 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 9dfca4ee3a1..c8b59e9c5a8 100644
--- a/CHANGES
+++ b/CHANGES
@@ -75,6 +75,7 @@ Bugs fixed
   change) with late TeXLive 2019
 * #8253: LaTeX: Figures with no size defined get overscaled (compared to images
   with size explicitly set in pixels) (fixed for ``'pdflatex'/'lualatex'`` only)
+* #8881: LaTeX: The depth of bookmarks panel in PDF is not enough for navigation
 
 Testing
 --------
diff --git a/doc/changes.rst b/doc/changes.rst
index 829c7f7ed4c..3fe90240444 100644
--- a/doc/changes.rst
+++ b/doc/changes.rst
@@ -10,7 +10,6 @@ Changelog
 
 .. raw:: latex
 
-   \hypersetup{bookmarksdepth=1}% pdf bookmarks
    \addtocontents{toc}{\protect\setcounter{tocdepth}{1}}%
 
 .. include:: ../CHANGES
diff --git a/doc/conf.py b/doc/conf.py
index f38d03d6d86..09397c76b48 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -61,11 +61,10 @@
     'fontenc': r'\usepackage[LGR,X2,T1]{fontenc}',
     'passoptionstopackages': r'''
 \PassOptionsToPackage{svgnames}{xcolor}
-\PassOptionsToPackage{bookmarksdepth=3}{hyperref}% depth of pdf bookmarks
 ''',
     'preamble': r'''
 \DeclareUnicodeCharacter{229E}{\ensuremath{\boxplus}}
-\setcounter{tocdepth}{3}%    depth of what is kept from toc file
+\setcounter{tocdepth}{3}%    depth of what main TOC shows (3=subsubsection)
 \setcounter{secnumdepth}{1}% depth of section numbering
 ''',
     # fix missing index entry due to RTD doing only once pdflatex after makeindex
diff --git a/doc/latex.rst b/doc/latex.rst
index b736c56ef02..ff1af928606 100644
--- a/doc/latex.rst
+++ b/doc/latex.rst
@@ -578,6 +578,17 @@ e.g ``'sphinxsetup': "verbatimwrapslines=false"``.  If setting the
 boolean key to ``true``, ``=true`` is optional.
 Spaces around the commas and equal signs are ignored, spaces inside LaTeX
 macros may be significant.
+Do not use quotes to enclose values, whether numerical or strings.
+
+``bookmarksdepth``
+    Controls the depth of the collapsable bookmarks panel in the PDF.
+    May be either a number (e.g. ``3``) or a LaTeX sectioning name (e.g.
+    ``subsubsection``, i.e. without backslash).
+    For details, refer to the ``hyperref`` LaTeX docs.
+
+    Default: ``5``
+
+    .. versionadded:: 4.0.0
 
 .. _latexsphinxsetuphmargin:
 
diff --git a/sphinx/templates/latex/latex.tex_t b/sphinx/templates/latex/latex.tex_t
index 679660fdd73..43ad04b0e14 100644
--- a/sphinx/templates/latex/latex.tex_t
+++ b/sphinx/templates/latex/latex.tex_t
@@ -16,6 +16,8 @@
 \ifdefined\pdfimageresolution
     \pdfimageresolution= \numexpr \dimexpr1in\relax/\sphinxpxdimen\relax
 \fi
+%% let collapsable pdf bookmarks panel have high depth per default
+\PassOptionsToPackage{bookmarksdepth=5}{hyperref}
 <% if use_xindy -%>
 %% turn off hyperref patch of \index as sphinx.xdy xindy module takes care of
 %% suitable \hyperpage mark-up, working around hyperref-xindy incompatibility
diff --git a/sphinx/texinputs/sphinx.sty b/sphinx/texinputs/sphinx.sty
index a71c64ffca6..cb82dc806bd 100644
--- a/sphinx/texinputs/sphinx.sty
+++ b/sphinx/texinputs/sphinx.sty
@@ -65,6 +65,8 @@
 \DeclareStringOption[-1]{numfigreset}
 \DeclareBoolOption[false]{nonumfigreset}
 \DeclareBoolOption[false]{mathnumfig}
+\define@key{sphinx}{bookmarksdepth}{\AtBeginDocument{\hypersetup{bookmarksdepth=#1}}}
+\AtBeginDocument{\define@key{sphinx}{bookmarksdepth}{\hypersetup{bookmarksdepth=#1}}}
 % \DeclareBoolOption[false]{usespart}% not used
 % dimensions, we declare the \dimen registers here.
 \newdimen\sphinxverbatimsep

From 95a872e7450d76bde759ac08de7322e692936da6 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Fri, 19 Feb 2021 14:20:13 +0100
Subject: [PATCH 136/305] C++, cpp_index_common_prefix remove longest

Fixes sphinx-doc/sphinx#8911
---
 CHANGES               | 2 ++
 sphinx/domains/cpp.py | 5 +++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 9dfca4ee3a1..f9f267c3a90 100644
--- a/CHANGES
+++ b/CHANGES
@@ -75,6 +75,8 @@ Bugs fixed
   change) with late TeXLive 2019
 * #8253: LaTeX: Figures with no size defined get overscaled (compared to images
   with size explicitly set in pixels) (fixed for ``'pdflatex'/'lualatex'`` only)
+* #8911: C++: remove the longest matching prefix in
+  :confval:`cpp_index_common_prefix` instead of the first that matches.
 
 Testing
 --------
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index 7ee023d1dc1..cf93681ae86 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -7644,10 +7644,11 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_config_value("cpp_debug_lookup", False, '')
     app.add_config_value("cpp_debug_show_tree", False, '')
 
-    def setDebugFlags(app):
+    def initStuff(app):
         Symbol.debug_lookup = app.config.cpp_debug_lookup
         Symbol.debug_show_tree = app.config.cpp_debug_show_tree
-    app.connect("builder-inited", setDebugFlags)
+        app.config.cpp_index_common_prefix.sort(reverse=True)
+    app.connect("builder-inited", initStuff)
 
     return {
         'version': 'builtin',

From ad3edd924cd0a76747a8f8c713f0f3559053b9da Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 23 Feb 2021 20:37:30 +0900
Subject: [PATCH 137/305] Fix #8915: html theme: The translation of
 sphinx_rtd_theme does not work

Since sphinx_rtd_theme-0.5.0, it supports translations.  But Sphinx core
disallows to enable it because theming framework gives special treatment
for the theme for a long time.

This goes to load it via setuptools at first to enable the translations.

Note: The special treatment for sphinx_rtd_theme (< 0.2.5) is not
removed yet.  But it will be removed in the future release.
---
 CHANGES           |  2 ++
 sphinx/theming.py | 16 +++++++---------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/CHANGES b/CHANGES
index 9dfca4ee3a1..798ddb0fca8 100644
--- a/CHANGES
+++ b/CHANGES
@@ -30,6 +30,7 @@ Incompatible changes
 * html theme: Move a script tag for documentation_options.js in
   basic/layout.html to ``script_files`` variable
 * html theme: Move CSS tags in basic/layout.html to ``css_files`` variable
+* #8915: html theme: Emit a warning for sphinx_rtd_theme-0.2.4 or older
 * #8508: LaTeX: uplatex becomes a default setting of latex_engine for Japanese
   documents
 * #5977: py domain: ``:var:``, ``:cvar:`` and ``:ivar:`` fields do not create
@@ -69,6 +70,7 @@ Bugs fixed
 ----------
 
 * #8380: html search: Paragraphs in search results are not identified as ``<p>``
+* #8915: html theme: The translation of sphinx_rtd_theme does not work
 * #8342: Emit a warning if a unknown domain is given for directive or role (ex.
   ``:unknown:doc:``)
 * #8711: LaTeX: backticks in code-blocks trigger latexpdf build warning (and font
diff --git a/sphinx/theming.py b/sphinx/theming.py
index e84f5ae49fc..bba47b3441d 100644
--- a/sphinx/theming.py
+++ b/sphinx/theming.py
@@ -178,8 +178,6 @@ def load_extra_theme(self, name: str) -> None:
         """Try to load a theme having specifed name."""
         if name == 'alabaster':
             self.load_alabaster_theme()
-        elif name == 'sphinx_rtd_theme':
-            self.load_sphinx_rtd_theme()
         else:
             self.load_external_theme(name)
 
@@ -237,13 +235,13 @@ def create(self, name: str) -> Theme:
         if name not in self.themes:
             self.load_extra_theme(name)
 
+        if name not in self.themes and name == 'sphinx_rtd_theme':
+            # sphinx_rtd_theme (< 0.2.5)  # RemovedInSphinx60Warning
+            logger.warning(__('sphinx_rtd_theme (< 0.3.0) found. '
+                              'It will not be available since Sphinx-6.0'))
+            self.load_sphinx_rtd_theme()
+
         if name not in self.themes:
-            if name == 'sphinx_rtd_theme':
-                raise ThemeError(__('sphinx_rtd_theme is no longer a hard dependency '
-                                    'since version 1.4.0. Please install it manually.'
-                                    '(pip install sphinx_rtd_theme)'))
-            else:
-                raise ThemeError(__('no theme named %r found '
-                                    '(missing theme.conf?)') % name)
+            raise ThemeError(__('no theme named %r found (missing theme.conf?)') % name)
 
         return Theme(name, self.themes[name], factory=self)

From a39cf57717a684bcd7fc81833a73397593a412d7 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 24 Feb 2021 22:51:06 +0900
Subject: [PATCH 138/305] Close #8924: autodoc: Support `bound` argument for
 TypeVar

---
 CHANGES                                        | 1 +
 sphinx/ext/autodoc/__init__.py                 | 2 ++
 tests/roots/test-ext-autodoc/target/typevar.py | 3 +++
 tests/test_ext_autodoc.py                      | 8 ++++++++
 4 files changed, 14 insertions(+)

diff --git a/CHANGES b/CHANGES
index 9dfca4ee3a1..27cef1e6e4c 100644
--- a/CHANGES
+++ b/CHANGES
@@ -55,6 +55,7 @@ Deprecated
 Features added
 --------------
 
+* #8924: autodoc: Support ``bound`` argument for TypeVar
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined
 * #7784: i18n: The alt text for image is translated by default (without
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 2ac24ebff33..8d6781a1a5c 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -1812,6 +1812,8 @@ def update_content(self, more_content: StringList) -> None:
             attrs = [repr(self.object.__name__)]
             for constraint in self.object.__constraints__:
                 attrs.append(stringify_typehint(constraint))
+            if self.object.__bound__:
+                attrs.append(r"bound=\ " + restify(self.object.__bound__))
             if self.object.__covariant__:
                 attrs.append("covariant=True")
             if self.object.__contravariant__:
diff --git a/tests/roots/test-ext-autodoc/target/typevar.py b/tests/roots/test-ext-autodoc/target/typevar.py
index 864fea20ce0..c330e2d885f 100644
--- a/tests/roots/test-ext-autodoc/target/typevar.py
+++ b/tests/roots/test-ext-autodoc/target/typevar.py
@@ -17,6 +17,9 @@
 #: T6
 T6 = NewType("T6", int)
 
+#: T7
+T7 = TypeVar("T7", bound=int)
+
 
 class Class:
     #: T1
diff --git a/tests/test_ext_autodoc.py b/tests/test_ext_autodoc.py
index d657ead609e..d9986e9ca55 100644
--- a/tests/test_ext_autodoc.py
+++ b/tests/test_ext_autodoc.py
@@ -1993,6 +1993,14 @@ def test_autodoc_TypeVar(app):
         '',
         '   alias of :class:`int`',
         '',
+        '',
+        '.. py:data:: T7',
+        '   :module: target.typevar',
+        '',
+        '   T7',
+        '',
+        "   alias of TypeVar('T7', bound=\\ :class:`int`)",
+        '',
     ]
 
 

From 17337a3257927fbd3e8aeeabd73201054e39331b Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sun, 11 Oct 2020 13:57:04 +0200
Subject: [PATCH 139/305] C, properly error on keywords as function parameters

---
 CHANGES                | 2 ++
 sphinx/domains/c.py    | 3 +++
 tests/test_domain_c.py | 3 +++
 3 files changed, 8 insertions(+)

diff --git a/CHANGES b/CHANGES
index f9f267c3a90..0e03a3f0a13 100644
--- a/CHANGES
+++ b/CHANGES
@@ -77,6 +77,8 @@ Bugs fixed
   with size explicitly set in pixels) (fixed for ``'pdflatex'/'lualatex'`` only)
 * #8911: C++: remove the longest matching prefix in
   :confval:`cpp_index_common_prefix` instead of the first that matches.
+* C, properly reject function declarations when a keyword is used
+  as parameter name.
 
 Testing
 --------
diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index 061010d6651..4909844cbd1 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -2703,6 +2703,9 @@ def _parse_declarator_name_suffix(
                 declId = None
         elif named == 'single':
             if self.match(identifier_re):
+                if self.matched_text in _keywords:
+                    self.fail("Expected identifier, "
+                              "got keyword: %s" % self.matched_text)
                 identifier = ASTIdentifier(self.matched_text)
                 declId = ASTNestedName([identifier], rooted=False)
             else:
diff --git a/tests/test_domain_c.py b/tests/test_domain_c.py
index 2cfcf74faf4..999c99f4d8c 100644
--- a/tests/test_domain_c.py
+++ b/tests/test_domain_c.py
@@ -417,6 +417,9 @@ def test_function_definitions():
     check('function', 'void f(int arr[const static volatile 42])', {1: 'f'},
           output='void f(int arr[static volatile const 42])')
 
+    with pytest.raises(DefinitionError):
+        parse('function', 'void f(int for)')
+
 
 def test_nested_name():
     check('struct', '{key}.A', {1: "A"})

From 40f4db30e8943a1ea3bcb2c1726dbacbf6d419ac Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sun, 11 Oct 2020 14:05:07 +0200
Subject: [PATCH 140/305] C, remove dead code

---
 sphinx/domains/c.py | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)

diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index 4909844cbd1..3693e536ace 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -2693,15 +2693,9 @@ def _parse_decl_specs(self, outer: str, typed: bool = True) -> ASTDeclSpecs:
     def _parse_declarator_name_suffix(
             self, named: Union[bool, str], paramMode: str, typed: bool
     ) -> ASTDeclarator:
+        assert named in (True, False, 'single')
         # now we should parse the name, and then suffixes
-        if named == 'maybe':
-            pos = self.pos
-            try:
-                declId = self._parse_nested_name()
-            except DefinitionError:
-                self.pos = pos
-                declId = None
-        elif named == 'single':
+        if named == 'single':
             if self.match(identifier_re):
                 if self.matched_text in _keywords:
                     self.fail("Expected identifier, "
@@ -2883,8 +2877,8 @@ def parser():
 
     def _parse_type(self, named: Union[bool, str], outer: str = None) -> ASTType:
         """
-        named=False|'maybe'|True: 'maybe' is e.g., for function objects which
-        doesn't need to name the arguments
+        named=False|'single'|True: 'single' is e.g., for function objects which
+        doesn't need to name the arguments, but otherwise is a single name
         """
         if outer:  # always named
             if outer not in ('type', 'member', 'function'):

From 088cef98bcb34522c2ec88c2fb4fd74199e2f10d Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sun, 11 Oct 2020 15:17:32 +0200
Subject: [PATCH 141/305] C, remove more dead code

---
 sphinx/domains/c.py | 26 +-------------------------
 1 file changed, 1 insertion(+), 25 deletions(-)

diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index 3693e536ace..79d4e145c6b 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -387,19 +387,6 @@ def describe_signature(self, signode: TextElement, mode: str,
         signode.append(nodes.Text('--'))
 
 
-class ASTPostfixMember(ASTPostfixOp):
-    def __init__(self, name):
-        self.name = name
-
-    def _stringify(self, transform: StringifyTransform) -> str:
-        return '.' + transform(self.name)
-
-    def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('.'))
-        self.name.describe_signature(signode, 'noneIsName', env, symbol)
-
-
 class ASTPostfixMemberOfPointer(ASTPostfixOp):
     def __init__(self, name):
         self.name = name
@@ -2256,7 +2243,7 @@ def _parse_postfix_expression(self) -> ASTPostfixExpr:
         #  | postfix "[" expression "]"
         #  | postfix "[" braced-init-list [opt] "]"
         #  | postfix "(" expression-list [opt] ")"
-        #  | postfix "." id-expression
+        #  | postfix "." id-expression  // taken care of in primary by nested name
         #  | postfix "->" id-expression
         #  | postfix "++"
         #  | postfix "--"
@@ -2274,17 +2261,6 @@ def _parse_postfix_expression(self) -> ASTPostfixExpr:
                     self.fail("Expected ']' in end of postfix expression.")
                 postFixes.append(ASTPostfixArray(expr))
                 continue
-            if self.skip_string('.'):
-                if self.skip_string('*'):
-                    # don't steal the dot
-                    self.pos -= 2
-                elif self.skip_string('..'):
-                    # don't steal the dot
-                    self.pos -= 3
-                else:
-                    name = self._parse_nested_name()
-                    postFixes.append(ASTPostfixMember(name))
-                    continue
             if self.skip_string('->'):
                 if self.skip_string('*'):
                     # don't steal the arrow

From 71a656498b0c091adf22394a5a004bee759d059c Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sun, 11 Oct 2020 15:23:11 +0200
Subject: [PATCH 142/305] C, simplify tests

---
 tests/roots/test-domain-c/semicolon.rst | 10 --------
 tests/test_domain_c.py                  | 31 +++++++++++++++++++++----
 2 files changed, 26 insertions(+), 15 deletions(-)
 delete mode 100644 tests/roots/test-domain-c/semicolon.rst

diff --git a/tests/roots/test-domain-c/semicolon.rst b/tests/roots/test-domain-c/semicolon.rst
deleted file mode 100644
index 14ba177569d..00000000000
--- a/tests/roots/test-domain-c/semicolon.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-.. c:member:: int member;
-.. c:var:: int var;
-.. c:function:: void f();
-.. .. c:macro:: NO_SEMICOLON;
-.. c:struct:: Struct;
-.. c:union:: Union;
-.. c:enum:: Enum;
-.. c:enumerator:: Enumerator;
-.. c:type:: Type;
-.. c:type:: int TypeDef;
diff --git a/tests/test_domain_c.py b/tests/test_domain_c.py
index 999c99f4d8c..5d2b2c5057f 100644
--- a/tests/test_domain_c.py
+++ b/tests/test_domain_c.py
@@ -526,8 +526,15 @@ def test_attributes():
 #     raise DefinitionError("")
 
 
+def split_warnigns(warning):
+    ws = warning.getvalue().split("\n")
+    assert len(ws) >= 1
+    assert ws[-1] == ""
+    return ws[:-1]
+
+
 def filter_warnings(warning, file):
-    lines = warning.getvalue().split("\n")
+    lines = split_warnigns(warning)
     res = [l for l in lines if "domain-c" in l and "{}.rst".format(file) in l and
            "WARNING: document isn't included in any toctree" not in l]
     print("Filtered warnings for file '{}':".format(file))
@@ -581,10 +588,22 @@ def test_build_domain_c_anon_dup_decl(app, status, warning):
     assert "WARNING: c:identifier reference target not found: @b" in ws[1]
 
 
-@pytest.mark.sphinx(testroot='domain-c', confoverrides={'nitpicky': True})
-def test_build_domain_c_semicolon(app, status, warning):
-    app.builder.build_all()
-    ws = filter_warnings(warning, "semicolon")
+@pytest.mark.sphinx(confoverrides={'nitpicky': True})
+def test_build_domain_c_semicolon(app, warning):
+    text = """
+.. c:member:: int member;
+.. c:var:: int var;
+.. c:function:: void f();
+.. .. c:macro:: NO_SEMICOLON;
+.. c:struct:: Struct;
+.. c:union:: Union;
+.. c:enum:: Enum;
+.. c:enumerator:: Enumerator;
+.. c:type:: Type;
+.. c:type:: int TypeDef;
+"""
+    restructuredtext.parse(app, text)
+    ws = split_warnigns(warning)
     assert len(ws) == 0
 
 
@@ -659,6 +678,8 @@ def test_noindexentry(app):
 
 @pytest.mark.sphinx(testroot='domain-c-intersphinx', confoverrides={'nitpicky': True})
 def test_intersphinx(tempdir, app, status, warning):
+    # a splitting of test_ids_vs_tags0 into the primary directives in a remote project,
+    # and then the references in the test project
     origSource = """\
 .. c:member:: int _member
 .. c:var:: int _var

From 0256daf11281650031c84fff3041aa5ca593fa93 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Wed, 24 Feb 2021 15:27:23 +0100
Subject: [PATCH 143/305] C, test namespace revamp

---
 tests/roots/test-domain-c/anon-dup-decl.rst         | 2 ++
 tests/roots/test-domain-c/function_param_target.rst | 2 ++
 tests/roots/test-domain-c/index.rst                 | 2 ++
 tests/test_domain_c.py                              | 4 ++--
 4 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/tests/roots/test-domain-c/anon-dup-decl.rst b/tests/roots/test-domain-c/anon-dup-decl.rst
index 5f6c3bdfe36..743ae2f6a84 100644
--- a/tests/roots/test-domain-c/anon-dup-decl.rst
+++ b/tests/roots/test-domain-c/anon-dup-decl.rst
@@ -1,3 +1,5 @@
+.. c:namespace:: anon_dup_decl_ns
+
 .. c:struct:: anon_dup_decl
 
 	.. c:struct:: @a.A
diff --git a/tests/roots/test-domain-c/function_param_target.rst b/tests/roots/test-domain-c/function_param_target.rst
index 05de01445d4..d316d7bcd16 100644
--- a/tests/roots/test-domain-c/function_param_target.rst
+++ b/tests/roots/test-domain-c/function_param_target.rst
@@ -1,3 +1,5 @@
+.. c:namespace:: function_param_target
+
 .. c:function:: void f(int i)
 
 	- :c:var:`i`
diff --git a/tests/roots/test-domain-c/index.rst b/tests/roots/test-domain-c/index.rst
index 7e2c18be997..4febd63eff1 100644
--- a/tests/roots/test-domain-c/index.rst
+++ b/tests/roots/test-domain-c/index.rst
@@ -1,3 +1,5 @@
+.. c:namespace:: index
+
 test-domain-c
 =============
 
diff --git a/tests/test_domain_c.py b/tests/test_domain_c.py
index 5d2b2c5057f..38e83a77eaf 100644
--- a/tests/test_domain_c.py
+++ b/tests/test_domain_c.py
@@ -615,8 +615,8 @@ def test_build_function_param_target(app, warning):
     assert len(ws) == 0
     entries = extract_role_links(app, "function_param_target.html")
     assert entries == [
-        ('c.f', 'i', 'i'),
-        ('c.f', 'f.i', 'f.i'),
+        ('c.function_param_target.f', 'i', 'i'),
+        ('c.function_param_target.f', 'f.i', 'f.i'),
     ]
 
 

From 294870ba59b491ad8a854d58710a2c0b65b7efbb Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 24 Feb 2021 12:53:20 +0100
Subject: [PATCH 144/305] LaTeX: let underfull calculation in wrapped code
 lines ignore last line

Closes: #8925
---
 sphinx/texinputs/sphinxlatexliterals.sty | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/sphinx/texinputs/sphinxlatexliterals.sty b/sphinx/texinputs/sphinxlatexliterals.sty
index 4abb3472ab8..a2943b2dc2c 100644
--- a/sphinx/texinputs/sphinxlatexliterals.sty
+++ b/sphinx/texinputs/sphinxlatexliterals.sty
@@ -343,8 +343,21 @@
     \fi\fi
 }%
 % auxiliary paragraph dissector to get max and min widths
+% but minwidth must not take into account the last line
 \newbox\spx@scratchbox
 \def\spx@verb@getwidths {%
+    \unskip\unpenalty
+    \setbox\spx@scratchbox\lastbox
+    \ifvoid\spx@scratchbox
+    \else
+       \setbox\spx@scratchbox\hbox{\unhbox\spx@scratchbox}%
+       \ifdim\spx@verb@maxwidth<\wd\spx@scratchbox
+          \xdef\spx@verb@maxwidth{\number\wd\spx@scratchbox sp}%
+       \fi
+       \expandafter\spx@verb@getwidths@loop
+    \fi
+}%
+\def\spx@verb@getwidths@loop {%
     \unskip\unpenalty
     \setbox\spx@scratchbox\lastbox
     \ifvoid\spx@scratchbox
@@ -356,7 +369,7 @@
        \ifdim\spx@verb@minwidth>\wd\spx@scratchbox
           \xdef\spx@verb@minwidth{\number\wd\spx@scratchbox sp}%
        \fi
-       \expandafter\spx@verb@getwidths
+       \expandafter\spx@verb@getwidths@loop
     \fi
 }%
 % auxiliary macros to implement "cut long line even in middle of word"

From 40b145c7dccd69704543f37f6a256d6cbfe0fe76 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 24 Feb 2021 12:53:51 +0100
Subject: [PATCH 145/305] Update CHANGES

---
 CHANGES | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGES b/CHANGES
index 0e03a3f0a13..bd37f081f2c 100644
--- a/CHANGES
+++ b/CHANGES
@@ -79,6 +79,8 @@ Bugs fixed
   :confval:`cpp_index_common_prefix` instead of the first that matches.
 * C, properly reject function declarations when a keyword is used
   as parameter name.
+* #8925: LaTeX: 3.5.0 ``verbatimmaxunderfull`` setting does not work as
+  expected
 
 Testing
 --------

From c9a1a9bb4f7a72831d214f2f6f48683601e56886 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Wed, 24 Feb 2021 19:01:34 +0100
Subject: [PATCH 146/305] Gather LaTeX items in CHANGES for 4.0.0

---
 CHANGES | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index bd37f081f2c..d90e8981cd6 100644
--- a/CHANGES
+++ b/CHANGES
@@ -75,12 +75,12 @@ Bugs fixed
   change) with late TeXLive 2019
 * #8253: LaTeX: Figures with no size defined get overscaled (compared to images
   with size explicitly set in pixels) (fixed for ``'pdflatex'/'lualatex'`` only)
+* #8925: LaTeX: 3.5.0 ``verbatimmaxunderfull`` setting does not work as
+  expected
 * #8911: C++: remove the longest matching prefix in
   :confval:`cpp_index_common_prefix` instead of the first that matches.
 * C, properly reject function declarations when a keyword is used
   as parameter name.
-* #8925: LaTeX: 3.5.0 ``verbatimmaxunderfull`` setting does not work as
-  expected
 
 Testing
 --------

From 4f072ee5c29faf7d6d636f37216e92e09011409c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 24 Feb 2021 01:32:05 +0900
Subject: [PATCH 147/305] Fix #8917: autodoc: Raises a warning if function has
 wrong __globals__ value

`sphinx.util.inspect:signature()` crashes with AttributeError when
subject has wrong `__globals__` value.  This ignores the error on
building.
---
 CHANGES                |  1 +
 sphinx/util/inspect.py | 15 ++++++++++++---
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index e4b06ae411f..9ddab2294aa 100644
--- a/CHANGES
+++ b/CHANGES
@@ -69,6 +69,7 @@ Features added
 Bugs fixed
 ----------
 
+* #8917: autodoc: Raises a warning if function has wrong __globals__ value
 * #8380: html search: Paragraphs in search results are not identified as ``<p>``
 * #8915: html theme: The translation of sphinx_rtd_theme does not work
 * #8342: Emit a warning if a unknown domain is given for directive or role (ex.
diff --git a/sphinx/util/inspect.py b/sphinx/util/inspect.py
index 3cf1c6824a3..dbeb547b131 100644
--- a/sphinx/util/inspect.py
+++ b/sphinx/util/inspect.py
@@ -166,6 +166,15 @@ def getannotations(obj: Any) -> Mapping[str, Any]:
         return {}
 
 
+def getglobals(obj: Any) -> Mapping[str, Any]:
+    """Get __globals__ from given *obj* safely."""
+    __globals__ = safe_getattr(obj, '__globals__', None)
+    if isinstance(__globals__, Mapping):
+        return __globals__
+    else:
+        return {}
+
+
 def getmro(obj: Any) -> Tuple["Type", ...]:
     """Get __mro__ from given *obj* safely."""
     __mro__ = safe_getattr(obj, '__mro__', None)
@@ -484,9 +493,9 @@ def __repr__(self) -> str:
 
 def _should_unwrap(subject: Callable) -> bool:
     """Check the function should be unwrapped on getting signature."""
-    if (safe_getattr(subject, '__globals__', None) and
-            subject.__globals__.get('__name__') == 'contextlib' and  # type: ignore
-            subject.__globals__.get('__file__') == contextlib.__file__):  # type: ignore
+    __globals__ = getglobals(subject)
+    if (__globals__.get('__name__') == 'contextlib' and
+            __globals__.get('__file__') == contextlib.__file__):
         # contextmanger should be unwrapped
         return True
 

From 255b4aee051e3318eb8fe42e606f321183736f8c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 26 Feb 2021 01:51:01 +0900
Subject: [PATCH 148/305] Fix #8933: viewcode: Failed to create back-links on
 parallel build

On parallel build mode, viewcode losts the back-links information on
gathering results from each process.  As a result, some back-links are
missing in the generated viewcode pages.

This fixes the merging back-links process for parallel builds.
---
 CHANGES                | 1 +
 sphinx/ext/viewcode.py | 9 ++++++++-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index e4b06ae411f..6c3821417cc 100644
--- a/CHANGES
+++ b/CHANGES
@@ -83,6 +83,7 @@ Bugs fixed
   :confval:`cpp_index_common_prefix` instead of the first that matches.
 * C, properly reject function declarations when a keyword is used
   as parameter name.
+* #8933: viewcode: Failed to create back-links on parallel build
 
 Testing
 --------
diff --git a/sphinx/ext/viewcode.py b/sphinx/ext/viewcode.py
index 6bedf2e1c5b..c98ff0c88fd 100644
--- a/sphinx/ext/viewcode.py
+++ b/sphinx/ext/viewcode.py
@@ -146,7 +146,14 @@ def env_merge_info(app: Sphinx, env: BuildEnvironment, docnames: Iterable[str],
     if not hasattr(env, '_viewcode_modules'):
         env._viewcode_modules = {}  # type: ignore
     # now merge in the information from the subprocess
-    env._viewcode_modules.update(other._viewcode_modules)  # type: ignore
+    for modname, entry in other._viewcode_modules.items():  # type: ignore
+        if modname not in env._viewcode_modules:  # type: ignore
+            env._viewcode_modules[modname] = entry  # type: ignore
+        else:
+            used = env._viewcode_modules[modname][2]  # type: ignore
+            for fullname, docname in entry[2].items():
+                if fullname not in used:
+                    used[fullname] = docname
 
 
 def env_purge_doc(app: Sphinx, env: BuildEnvironment, docname: str) -> None:

From 20884bb0c9f76834972b52e28f24df989a10eb68 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 13 Feb 2021 00:59:57 +0900
Subject: [PATCH 149/305] refactor: LaTeX: Use raw strings for LaTeX macros

---
 sphinx/writers/latex.py | 366 ++++++++++++++++++++--------------------
 1 file changed, 181 insertions(+), 185 deletions(-)

diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py
index 91585e402a2..93f97d028ef 100644
--- a/sphinx/writers/latex.py
+++ b/sphinx/writers/latex.py
@@ -164,15 +164,15 @@ def get_colspec(self) -> str:
             return self.colspec
         elif self.colwidths and 'colwidths-given' in self.classes:
             total = sum(self.colwidths)
-            colspecs = ['\\X{%d}{%d}' % (width, total) for width in self.colwidths]
+            colspecs = [r'\X{%d}{%d}' % (width, total) for width in self.colwidths]
             return '{|%s|}' % '|'.join(colspecs) + CR
         elif self.has_problematic:
-            return '{|*{%d}{\\X{1}{%d}|}}' % (self.colcount, self.colcount) + CR
+            return r'{|*{%d}{\X{1}{%d}|}}' % (self.colcount, self.colcount) + CR
         elif self.get_table_type() == 'tabulary':
             # sphinx.sty sets T to be J by default.
             return '{|' + ('T|' * self.colcount) + '}' + CR
         elif self.has_oldproblematic:
-            return '{|*{%d}{\\X{1}{%d}|}}' % (self.colcount, self.colcount) + CR
+            return r'{|*{%d}{\X{1}{%d}|}}' % (self.colcount, self.colcount) + CR
         else:
             return '{|' + ('l|' * self.colcount) + '}' + CR
 
@@ -253,19 +253,19 @@ def rstdim_to_latexdim(width_str: str, scale: int = 100) -> str:
     if scale == 100:
         float(amount)  # validate amount is float
         if unit in ('', "px"):
-            res = "%s\\sphinxpxdimen" % amount
+            res = r"%s\sphinxpxdimen" % amount
         elif unit == 'pt':
             res = '%sbp' % amount  # convert to 'bp'
         elif unit == "%":
-            res = "%.3f\\linewidth" % (float(amount) / 100.0)
+            res = r"%.3f\linewidth" % (float(amount) / 100.0)
     else:
         amount_float = float(amount) * scale / 100.0
         if unit in ('', "px"):
-            res = "%.5f\\sphinxpxdimen" % amount_float
+            res = r"%.5f\sphinxpxdimen" % amount_float
         elif unit == 'pt':
             res = '%.5fbp' % amount_float
         elif unit == "%":
-            res = "%.5f\\linewidth" % (amount_float / 100.0)
+            res = r"%.5f\linewidth" % (amount_float / 100.0)
         else:
             res = "%.5f%s" % (amount_float, unit)
     return res
@@ -373,9 +373,9 @@ def __init__(self, document: nodes.document, builder: "LaTeXBuilder",
         if (self.config.language not in {None, 'en', 'ja'} and
                 'fncychap' not in self.config.latex_elements):
             # use Sonny style if any language specified (except English)
-            self.elements['fncychap'] = ('\\usepackage[Sonny]{fncychap}' + CR +
-                                         '\\ChNameVar{\\Large\\normalfont\\sffamily}' + CR +
-                                         '\\ChTitleVar{\\Large\\normalfont\\sffamily}')
+            self.elements['fncychap'] = (r'\usepackage[Sonny]{fncychap}' + CR +
+                                         r'\ChNameVar{\Large\normalfont\sffamily}' + CR +
+                                         r'\ChTitleVar{\Large\normalfont\sffamily}')
 
         self.babel = self.builder.babel
         if self.config.language and not self.babel.is_supported_language():
@@ -400,19 +400,19 @@ def __init__(self, document: nodes.document, builder: "LaTeXBuilder",
                 logger.warning(__('too large :maxdepth:, ignored.'))
                 tocdepth = len(LATEXSECTIONNAMES) - 2
 
-            self.elements['tocdepth'] = '\\setcounter{tocdepth}{%d}' % tocdepth
+            self.elements['tocdepth'] = r'\setcounter{tocdepth}{%d}' % tocdepth
             minsecnumdepth = max(minsecnumdepth, tocdepth)
 
         if self.config.numfig and (self.config.numfig_secnum_depth > 0):
             minsecnumdepth = max(minsecnumdepth, self.numfig_secnum_depth - 1)
 
         if minsecnumdepth > self.secnumdepth:
-            self.elements['secnumdepth'] = '\\setcounter{secnumdepth}{%d}' %\
+            self.elements['secnumdepth'] = r'\setcounter{secnumdepth}{%d}' %\
                                            minsecnumdepth
 
         contentsname = document.get('contentsname')
         if contentsname:
-            self.elements['contentsname'] = self.babel_renewcommand('\\contentsname',
+            self.elements['contentsname'] = self.babel_renewcommand(r'\contentsname',
                                                                     contentsname)
 
         if self.elements['maxlistdepth']:
@@ -420,8 +420,7 @@ def __init__(self, document: nodes.document, builder: "LaTeXBuilder",
         if sphinxpkgoptions:
             self.elements['sphinxpkgoptions'] = '[,%s]' % ','.join(sphinxpkgoptions)
         if self.elements['sphinxsetup']:
-            self.elements['sphinxsetup'] = ('\\sphinxsetup{%s}' %
-                                            self.elements['sphinxsetup'])
+            self.elements['sphinxsetup'] = (r'\sphinxsetup{%s}' % self.elements['sphinxsetup'])
         if self.elements['extraclassoptions']:
             self.elements['classoptions'] += ',' + \
                                              self.elements['extraclassoptions']
@@ -466,8 +465,7 @@ def astext(self) -> str:
     def hypertarget(self, id: str, withdoc: bool = True, anchor: bool = True) -> str:
         if withdoc:
             id = self.curfilestack[-1] + ':' + id
-        return ('\\phantomsection' if anchor else '') + \
-            '\\label{%s}' % self.idescape(id)
+        return (r'\phantomsection' if anchor else '') + r'\label{%s}' % self.idescape(id)
 
     def hypertarget_to(self, node: Element, anchor: bool = False) -> str:
         labels = ''.join(self.hypertarget(node_id, anchor=False) for node_id in node['ids'])
@@ -477,48 +475,48 @@ def hypertarget_to(self, node: Element, anchor: bool = False) -> str:
             return labels
 
     def hyperlink(self, id: str) -> str:
-        return '{\\hyperref[%s]{' % self.idescape(id)
+        return r'{\hyperref[%s]{' % self.idescape(id)
 
     def hyperpageref(self, id: str) -> str:
-        return '\\autopageref*{%s}' % self.idescape(id)
+        return r'\autopageref*{%s}' % self.idescape(id)
 
     def escape(self, s: str) -> str:
         return texescape.escape(s, self.config.latex_engine)
 
     def idescape(self, id: str) -> str:
-        return '\\detokenize{%s}' % str(id).translate(tex_replace_map).\
+        return r'\detokenize{%s}' % str(id).translate(tex_replace_map).\
             encode('ascii', 'backslashreplace').decode('ascii').\
             replace('\\', '_')
 
     def babel_renewcommand(self, command: str, definition: str) -> str:
         if self.elements['multilingual']:
-            prefix = '\\addto\\captions%s{' % self.babel.get_language()
+            prefix = r'\addto\captions%s{' % self.babel.get_language()
             suffix = '}'
         else:  # babel is disabled (mainly for Japanese environment)
             prefix = ''
             suffix = ''
 
-        return '%s\\renewcommand{%s}{%s}%s' % (prefix, command, definition, suffix) + CR
+        return r'%s\renewcommand{%s}{%s}%s' % (prefix, command, definition, suffix) + CR
 
     def generate_indices(self) -> str:
         def generate(content: List[Tuple[str, List[IndexEntry]]], collapsed: bool) -> None:
-            ret.append('\\begin{sphinxtheindex}' + CR)
-            ret.append('\\let\\bigletter\\sphinxstyleindexlettergroup' + CR)
+            ret.append(r'\begin{sphinxtheindex}' + CR)
+            ret.append(r'\let\bigletter\sphinxstyleindexlettergroup' + CR)
             for i, (letter, entries) in enumerate(content):
                 if i > 0:
-                    ret.append('\\indexspace' + CR)
-                ret.append('\\bigletter{%s}' % self.escape(letter) + CR)
+                    ret.append(r'\indexspace' + CR)
+                ret.append(r'\bigletter{%s}' % self.escape(letter) + CR)
                 for entry in entries:
                     if not entry[3]:
                         continue
-                    ret.append('\\item\\relax\\sphinxstyleindexentry{%s}' %
+                    ret.append(r'\item\relax\sphinxstyleindexentry{%s}' %
                                self.encode(entry[0]))
                     if entry[4]:
                         # add "extra" info
-                        ret.append('\\sphinxstyleindexextra{%s}' % self.encode(entry[4]))
-                    ret.append('\\sphinxstyleindexpageref{%s:%s}' %
+                        ret.append(r'\sphinxstyleindexextra{%s}' % self.encode(entry[4]))
+                    ret.append(r'\sphinxstyleindexpageref{%s:%s}' %
                                (entry[2], self.idescape(entry[3])) + CR)
-            ret.append('\\end{sphinxtheindex}' + CR)
+            ret.append(r'\end{sphinxtheindex}' + CR)
 
         ret = []
         # latex_domain_indices can be False/True or a list of index names
@@ -534,7 +532,7 @@ def generate(content: List[Tuple[str, List[IndexEntry]]], collapsed: bool) -> No
                         self.builder.docnames)
                     if not content:
                         continue
-                    ret.append('\\renewcommand{\\indexname}{%s}' % indexcls.localname + CR)
+                    ret.append(r'\renewcommand{\indexname}{%s}' % indexcls.localname + CR)
                     generate(content, collapsed)
 
         return ''.join(ret)
@@ -564,7 +562,7 @@ def visit_document(self, node: Element) -> None:
             self.first_document = 0
         elif self.first_document == 0:
             # ... and all others are the appendices
-            self.body.append(CR + '\\appendix' + CR)
+            self.body.append(CR + r'\appendix' + CR)
             self.first_document = -1
         if 'docname' in node:
             self.body.append(self.hypertarget(':doc'))
@@ -597,11 +595,11 @@ def depart_problematic(self, node: Element) -> None:
 
     def visit_topic(self, node: Element) -> None:
         self.in_minipage = 1
-        self.body.append(CR + '\\begin{sphinxShadowBox}' + CR)
+        self.body.append(CR + r'\begin{sphinxShadowBox}' + CR)
 
     def depart_topic(self, node: Element) -> None:
         self.in_minipage = 0
-        self.body.append('\\end{sphinxShadowBox}' + CR)
+        self.body.append(r'\end{sphinxShadowBox}' + CR)
     visit_sidebar = visit_topic
     depart_sidebar = depart_topic
 
@@ -613,20 +611,20 @@ def depart_glossary(self, node: Element) -> None:
 
     def visit_productionlist(self, node: Element) -> None:
         self.body.append(BLANKLINE)
-        self.body.append('\\begin{productionlist}' + CR)
+        self.body.append(r'\begin{productionlist}' + CR)
         self.in_production_list = 1
 
     def depart_productionlist(self, node: Element) -> None:
-        self.body.append('\\end{productionlist}' + BLANKLINE)
+        self.body.append(r'\end{productionlist}' + BLANKLINE)
         self.in_production_list = 0
 
     def visit_production(self, node: Element) -> None:
         if node['tokenname']:
             tn = node['tokenname']
             self.body.append(self.hypertarget('grammar-token-' + tn))
-            self.body.append('\\production{%s}{' % self.encode(tn))
+            self.body.append(r'\production{%s}{' % self.encode(tn))
         else:
-            self.body.append('\\productioncont{')
+            self.body.append(r'\productioncont{')
 
     def depart_production(self, node: Element) -> None:
         self.body.append('}' + CR)
@@ -681,7 +679,7 @@ def visit_title(self, node: Element) -> None:
             logger.warning(__('encountered title node not in section, topic, table, '
                               'admonition or sidebar'),
                            location=node)
-            self.body.append('\\sphinxstyleothertitle{')
+            self.body.append(r'\sphinxstyleothertitle{')
             self.context.append('}' + CR)
         self.in_title = 1
 
@@ -694,7 +692,7 @@ def depart_title(self, node: Element) -> None:
 
     def visit_subtitle(self, node: Element) -> None:
         if isinstance(node.parent, nodes.sidebar):
-            self.body.append('\\sphinxstylesidebarsubtitle{')
+            self.body.append(r'\sphinxstylesidebarsubtitle{')
             self.context.append('}' + CR)
         else:
             self.context.append('')
@@ -705,18 +703,18 @@ def depart_subtitle(self, node: Element) -> None:
     def visit_desc(self, node: Element) -> None:
         if self.config.latex_show_urls == 'footnote':
             self.body.append(BLANKLINE)
-            self.body.append('\\begin{savenotes}\\begin{fulllineitems}' + CR)
+            self.body.append(r'\begin{savenotes}\begin{fulllineitems}' + CR)
         else:
             self.body.append(BLANKLINE)
-            self.body.append('\\begin{fulllineitems}' + CR)
+            self.body.append(r'\begin{fulllineitems}' + CR)
         if self.table:
             self.table.has_problematic = True
 
     def depart_desc(self, node: Element) -> None:
         if self.config.latex_show_urls == 'footnote':
-            self.body.append(CR + '\\end{fulllineitems}\\end{savenotes}' + BLANKLINE)
+            self.body.append(CR + r'\end{fulllineitems}\end{savenotes}' + BLANKLINE)
         else:
-            self.body.append(CR + '\\end{fulllineitems}' + BLANKLINE)
+            self.body.append(CR + r'\end{fulllineitems}' + BLANKLINE)
 
     def _visit_signature_line(self, node: Element) -> None:
         for child in node:
@@ -739,14 +737,14 @@ def visit_desc_signature(self, node: Element) -> None:
             self._visit_signature_line(node)
         else:
             self.body.append('%' + CR)
-            self.body.append('\\pysigstartmultiline' + CR)
+            self.body.append(r'\pysigstartmultiline' + CR)
 
     def depart_desc_signature(self, node: Element) -> None:
         if not node.get('is_multiline'):
             self._depart_signature_line(node)
         else:
             self.body.append('%' + CR)
-            self.body.append('\\pysigstopmultiline')
+            self.body.append(r'\pysigstopmultiline')
 
     def visit_desc_signature_line(self, node: Element) -> None:
         self._visit_signature_line(node)
@@ -825,8 +823,8 @@ def depart_desc_content(self, node: Element) -> None:
 
     def visit_seealso(self, node: Element) -> None:
         self.body.append(BLANKLINE)
-        self.body.append('\\sphinxstrong{%s:}' % admonitionlabels['seealso'] + CR)
-        self.body.append('\\nopagebreak' + BLANKLINE)
+        self.body.append(r'\sphinxstrong{%s:}' % admonitionlabels['seealso'] + CR)
+        self.body.append(r'\nopagebreak' + BLANKLINE)
 
     def depart_seealso(self, node: Element) -> None:
         self.body.append(BLANKLINE)
@@ -834,7 +832,7 @@ def depart_seealso(self, node: Element) -> None:
     def visit_rubric(self, node: Element) -> None:
         if len(node) == 1 and node.astext() in ('Footnotes', _('Footnotes')):
             raise nodes.SkipNode
-        self.body.append('\\subsubsection*{')
+        self.body.append(r'\subsubsection*{')
         self.context.append('}' + CR)
         self.in_title = 1
 
@@ -846,23 +844,23 @@ def visit_footnote(self, node: Element) -> None:
         self.in_footnote += 1
         label = cast(nodes.label, node[0])
         if 'auto' not in node:
-            self.body.append('\\sphinxstepexplicit ')
+            self.body.append(r'\sphinxstepexplicit ')
         if self.in_parsed_literal:
-            self.body.append('\\begin{footnote}[%s]' % label.astext())
+            self.body.append(r'\begin{footnote}[%s]' % label.astext())
         else:
             self.body.append('%' + CR)
-            self.body.append('\\begin{footnote}[%s]' % label.astext())
+            self.body.append(r'\begin{footnote}[%s]' % label.astext())
         if 'auto' not in node:
-            self.body.append('\\phantomsection'
-                             '\\label{\\thesphinxscope.%s}%%' % label.astext() + CR)
-        self.body.append('\\sphinxAtStartFootnote' + CR)
+            self.body.append(r'\phantomsection'
+                             r'\label{\thesphinxscope.%s}%%' % label.astext() + CR)
+        self.body.append(r'\sphinxAtStartFootnote' + CR)
 
     def depart_footnote(self, node: Element) -> None:
         if self.in_parsed_literal:
-            self.body.append('\\end{footnote}')
+            self.body.append(r'\end{footnote}')
         else:
             self.body.append('%' + CR)
-            self.body.append('\\end{footnote}')
+            self.body.append(r'\end{footnote}')
         self.in_footnote -= 1
 
     def visit_label(self, node: Element) -> None:
@@ -950,25 +948,24 @@ def visit_row(self, node: Element) -> None:
                     self.body.append('&')
                 if cell.width == 1:
                     # insert suitable strut for equalizing row heights in given multirow
-                    self.body.append('\\sphinxtablestrut{%d}' % cell.cell_id)
+                    self.body.append(r'\sphinxtablestrut{%d}' % cell.cell_id)
                 else:  # use \multicolumn for wide multirow cell
-                    self.body.append('\\multicolumn{%d}{|l|}'
-                                     '{\\sphinxtablestrut{%d}}' %
+                    self.body.append(r'\multicolumn{%d}{|l|}\sphinxtablestrut{%d}}' %
                                      (cell.width, cell.cell_id))
 
     def depart_row(self, node: Element) -> None:
-        self.body.append('\\\\' + CR)
+        self.body.append(r'\\' + CR)
         cells = [self.table.cell(self.table.row, i) for i in range(self.table.colcount)]
         underlined = [cell.row + cell.height == self.table.row + 1 for cell in cells]
         if all(underlined):
-            self.body.append('\\hline')
+            self.body.append(r'\hline')
         else:
             i = 0
             underlined.extend([False])  # sentinel
             while i < len(underlined):
                 if underlined[i] is True:
                     j = underlined[i:].index(False)
-                    self.body.append('\\cline{%d-%d}' % (i + 1, i + j))
+                    self.body.append(r'\cline{%d-%d}' % (i + 1, i + j))
                     i += j
                 i += 1
         self.table.row += 1
@@ -982,22 +979,22 @@ def visit_entry(self, node: Element) -> None:
         if cell.width > 1:
             if self.config.latex_use_latex_multicolumn:
                 if self.table.col == 0:
-                    self.body.append('\\multicolumn{%d}{|l|}{%%' % cell.width + CR)
+                    self.body.append(r'\multicolumn{%d}{|l|}{%%' % cell.width + CR)
                 else:
-                    self.body.append('\\multicolumn{%d}{l|}{%%' % cell.width + CR)
+                    self.body.append(r'\multicolumn{%d}{l|}{%%' % cell.width + CR)
                 context = '}%' + CR
             else:
-                self.body.append('\\sphinxstartmulticolumn{%d}%%' % cell.width + CR)
-                context = '\\sphinxstopmulticolumn' + CR
+                self.body.append(r'\sphinxstartmulticolumn{%d}%%' % cell.width + CR)
+                context = r'\sphinxstopmulticolumn' + CR
         if cell.height > 1:
             # \sphinxmultirow 2nd arg "cell_id" will serve as id for LaTeX macros as well
-            self.body.append('\\sphinxmultirow{%d}{%d}{%%' % (cell.height, cell.cell_id) + CR)
+            self.body.append(r'\sphinxmultirow{%d}{%d}{%%' % (cell.height, cell.cell_id) + CR)
             context = '}%' + CR + context
         if cell.width > 1 or cell.height > 1:
-            self.body.append('\\begin{varwidth}[t]{\\sphinxcolwidth{%d}{%d}}'
+            self.body.append(r'\begin{varwidth}[t]{\sphinxcolwidth{%d}{%d}}'
                              % (cell.width, self.table.colcount) + CR)
-            context = ('\\par' + CR + '\\vskip-\\baselineskip'
-                       '\\vbox{\\hbox{\\strut}}\\end{varwidth}%' + CR + context)
+            context = (r'\par' + CR + r'\vskip-\baselineskip'
+                       r'\vbox{\hbox{\strut}}\end{varwidth}%' + CR + context)
             self.needs_linetrimming = 1
         if len(node.traverse(nodes.paragraph)) >= 2:
             self.table.has_oldproblematic = True
@@ -1005,7 +1002,7 @@ def visit_entry(self, node: Element) -> None:
             if len(node) == 1 and isinstance(node[0], nodes.paragraph) and node.astext() == '':
                 pass
             else:
-                self.body.append('\\sphinxstyletheadfamily ')
+                self.body.append(r'\sphinxstyletheadfamily ')
         if self.needs_linetrimming:
             self.pushbody([])
         self.context.append(context)
@@ -1036,11 +1033,10 @@ def depart_entry(self, node: Element) -> None:
                 if nextcell.width == 1:
                     # insert suitable strut for equalizing row heights in multirow
                     # they also serve to clear colour panels which would hide the text
-                    self.body.append('\\sphinxtablestrut{%d}' % nextcell.cell_id)
+                    self.body.append(r'\sphinxtablestrut{%d}' % nextcell.cell_id)
                 else:
                     # use \multicolumn for wide multirow cell
-                    self.body.append('\\multicolumn{%d}{l|}'
-                                     '{\\sphinxtablestrut{%d}}' %
+                    self.body.append(r'\multicolumn{%d}{l|}{\sphinxtablestrut{%d}}' %
                                      (nextcell.width, nextcell.cell_id))
 
     def visit_acks(self, node: Element) -> None:
@@ -1055,13 +1051,13 @@ def visit_acks(self, node: Element) -> None:
 
     def visit_bullet_list(self, node: Element) -> None:
         if not self.compact_list:
-            self.body.append('\\begin{itemize}' + CR)
+            self.body.append(r'\begin{itemize}' + CR)
         if self.table:
             self.table.has_problematic = True
 
     def depart_bullet_list(self, node: Element) -> None:
         if not self.compact_list:
-            self.body.append('\\end{itemize}' + CR)
+            self.body.append(r'\end{itemize}' + CR)
 
     def visit_enumerated_list(self, node: Element) -> None:
         def get_enumtype(node: Element) -> str:
@@ -1086,16 +1082,16 @@ def get_nested_level(node: Element) -> int:
         prefix = node.get('prefix', '')
         suffix = node.get('suffix', '.')
 
-        self.body.append('\\begin{enumerate}' + CR)
-        self.body.append('\\sphinxsetlistlabels{%s}{%s}{%s}{%s}{%s}%%' %
+        self.body.append(r'\begin{enumerate}' + CR)
+        self.body.append(r'\sphinxsetlistlabels{%s}{%s}{%s}{%s}{%s}%%' %
                          (style, enum, enumnext, prefix, suffix) + CR)
         if 'start' in node:
-            self.body.append('\\setcounter{%s}{%d}' % (enum, node['start'] - 1) + CR)
+            self.body.append(r'\setcounter{%s}{%d}' % (enum, node['start'] - 1) + CR)
         if self.table:
             self.table.has_problematic = True
 
     def depart_enumerated_list(self, node: Element) -> None:
-        self.body.append('\\end{enumerate}' + CR)
+        self.body.append(r'\end{enumerate}' + CR)
 
     def visit_list_item(self, node: Element) -> None:
         # Append "{}" in case the next character is "[", which would break
@@ -1106,12 +1102,12 @@ def depart_list_item(self, node: Element) -> None:
         self.body.append(CR)
 
     def visit_definition_list(self, node: Element) -> None:
-        self.body.append('\\begin{description}' + CR)
+        self.body.append(r'\begin{description}' + CR)
         if self.table:
             self.table.has_problematic = True
 
     def depart_definition_list(self, node: Element) -> None:
-        self.body.append('\\end{description}' + CR)
+        self.body.append(r'\end{description}' + CR)
 
     def visit_definition_list_item(self, node: Element) -> None:
         pass
@@ -1123,11 +1119,11 @@ def visit_term(self, node: Element) -> None:
         self.in_term += 1
         ctx = ''
         if node.get('ids'):
-            ctx = '\\phantomsection'
+            ctx = r'\phantomsection'
             for node_id in node['ids']:
                 ctx += self.hypertarget(node_id, anchor=False)
-        ctx += '}] \\leavevmode'
-        self.body.append('\\item[{')
+        ctx += r'}] \leavevmode'
+        self.body.append(r'\item[{')
         self.context.append(ctx)
 
     def depart_term(self, node: Element) -> None:
@@ -1147,12 +1143,12 @@ def depart_definition(self, node: Element) -> None:
         self.body.append(CR)
 
     def visit_field_list(self, node: Element) -> None:
-        self.body.append('\\begin{quote}\\begin{description}' + CR)
+        self.body.append(r'\begin{quote}\begin{description}' + CR)
         if self.table:
             self.table.has_problematic = True
 
     def depart_field_list(self, node: Element) -> None:
-        self.body.append('\\end{description}\\end{quote}' + CR)
+        self.body.append(r'\end{description}\end{quote}' + CR)
 
     def visit_field(self, node: Element) -> None:
         pass
@@ -1172,7 +1168,7 @@ def visit_paragraph(self, node: Element) -> None:
                 not isinstance(node.parent[index - 1], nodes.paragraph) and
                 not isinstance(node.parent[index - 1], nodes.compound)):
             # insert blank line, if the paragraph follows a non-paragraph node in a compound
-            self.body.append('\\noindent' + CR)
+            self.body.append(r'\noindent' + CR)
         elif index == 1 and isinstance(node.parent, (nodes.footnote, footnotetext)):
             # don't insert blank line, if the paragraph is second child of a footnote
             # (first one is label node)
@@ -1181,33 +1177,33 @@ def visit_paragraph(self, node: Element) -> None:
             # the \sphinxAtStartPar is to allow hyphenation of first word of
             # a paragraph in narrow contexts such as in a table cell
             # added as two items (cf. line trimming in depart_entry())
-            self.body.extend([CR, '\\sphinxAtStartPar' + CR])
+            self.body.extend([CR, r'\sphinxAtStartPar' + CR])
 
     def depart_paragraph(self, node: Element) -> None:
         self.body.append(CR)
 
     def visit_centered(self, node: Element) -> None:
-        self.body.append(CR + '\\begin{center}')
+        self.body.append(CR + r'\begin{center}')
         if self.table:
             self.table.has_problematic = True
 
     def depart_centered(self, node: Element) -> None:
-        self.body.append(CR + '\\end{center}')
+        self.body.append(CR + r'\end{center}')
 
     def visit_hlist(self, node: Element) -> None:
         self.compact_list += 1
         ncolumns = node['ncolumns']
         if self.compact_list > 1:
-            self.body.append('\\setlength{\\multicolsep}{0pt}' + CR)
-        self.body.append('\\begin{multicols}{' + ncolumns + '}\\raggedright' + CR)
-        self.body.append('\\begin{itemize}\\setlength{\\itemsep}{0pt}'
-                         '\\setlength{\\parskip}{0pt}' + CR)
+            self.body.append(r'\setlength{\multicolsep}{0pt}' + CR)
+        self.body.append(r'\begin{multicols}{' + ncolumns + '}\raggedright' + CR)
+        self.body.append(r'\begin{itemize}\setlength{\itemsep}{0pt}'
+                         r'\setlength{\parskip}{0pt}' + CR)
         if self.table:
             self.table.has_problematic = True
 
     def depart_hlist(self, node: Element) -> None:
         self.compact_list -= 1
-        self.body.append('\\end{itemize}\\raggedcolumns\\end{multicols}' + CR)
+        self.body.append(r'\end{itemize}\raggedcolumns\end{multicols}' + CR)
 
     def visit_hlistcol(self, node: Element) -> None:
         pass
@@ -1217,7 +1213,7 @@ def depart_hlistcol(self, node: Element) -> None:
         # some testing with long items showed that columns may be too uneven.
         # And in case only of short items, the automatic column breaks should
         # match the ones pre-computed by the hlist() directive.
-        # self.body.append('\\columnbreak\n')
+        # self.body.append(r'\columnbreak\n')
         pass
 
     def latex_image_length(self, width_str: str, scale: int = 100) -> str:
@@ -1265,14 +1261,14 @@ def visit_image(self, node: Element) -> None:
             align_prepost = {
                 # By default latex aligns the top of an image.
                 (1, 'top'): ('', ''),
-                (1, 'middle'): ('\\raisebox{-0.5\\height}{', '}'),
-                (1, 'bottom'): ('\\raisebox{-\\height}{', '}'),
-                (0, 'center'): ('{\\hspace*{\\fill}', '\\hspace*{\\fill}}'),
+                (1, 'middle'): (r'\raisebox{-0.5\height}{', '}'),
+                (1, 'bottom'): (r'\raisebox{-\height}{', '}'),
+                (0, 'center'): (r'{\hspace*{\fill}', r'\hspace*{\fill}}'),
                 # These 2 don't exactly do the right thing.  The image should
                 # be floated alongside the paragraph.  See
                 # https://www.w3.org/TR/html4/struct/objects.html#adef-align-IMG
-                (0, 'left'): ('{', '\\hspace*{\\fill}}'),
-                (0, 'right'): ('{\\hspace*{\\fill}', '}'),
+                (0, 'left'): ('{', r'\hspace*{\fill}}'),
+                (0, 'right'): (r'{\hspace*{\fill}', '}'),
             }
             try:
                 pre.append(align_prepost[is_inline, node['align']][0])
@@ -1280,10 +1276,10 @@ def visit_image(self, node: Element) -> None:
             except KeyError:
                 pass
         if self.in_parsed_literal:
-            pre.append('{\\sphinxunactivateextrasandspace ')
+            pre.append(r'{\sphinxunactivateextrasandspace ')
             post.append('}')
         if not is_inline and not has_hyperlink:
-            pre.append(CR + '\\noindent')
+            pre.append(CR + r'\noindent')
             post.append(CR)
         pre.reverse()
         if node['uri'] in self.builder.images:
@@ -1304,10 +1300,10 @@ def visit_image(self, node: Element) -> None:
         if self.in_title and base:
             # Lowercase tokens forcely because some fncychap themes capitalize
             # the options of \sphinxincludegraphics unexpectly (ex. WIDTH=...).
-            self.body.append('\\lowercase{\\sphinxincludegraphics%s}{{%s}%s}' %
+            self.body.append(r'\lowercase{\sphinxincludegraphics%s}{{%s}%s}' %
                              (options, base, ext))
         else:
-            self.body.append('\\sphinxincludegraphics%s{{%s}%s}' %
+            self.body.append(r'\sphinxincludegraphics%s{{%s}%s}' %
                              (options, base, ext))
         self.body.extend(post)
 
@@ -1323,14 +1319,14 @@ def visit_figure(self, node: Element) -> None:
             if 'width' in node:
                 length = self.latex_image_length(node['width'])
                 if length:
-                    self.body.append('\\begin{sphinxfigure-in-table}[%s]' % length + CR)
-                    self.body.append('\\centering' + CR)
+                    self.body.append(r'\begin{sphinxfigure-in-table}[%s]' % length + CR)
+                    self.body.append(r'\centering' + CR)
             else:
-                self.body.append('\\begin{sphinxfigure-in-table}' + CR)
-                self.body.append('\\centering' + CR)
+                self.body.append(r'\begin{sphinxfigure-in-table}' + CR)
+                self.body.append(r'\centering' + CR)
             if any(isinstance(child, nodes.caption) for child in node):
-                self.body.append('\\capstart')
-            self.context.append('\\end{sphinxfigure-in-table}\\relax' + CR)
+                self.body.append(r'\capstart')
+            self.context.append(r'\end{sphinxfigure-in-table}\relax' + CR)
         elif node.get('align', '') in ('left', 'right'):
             length = None
             if 'width' in node:
@@ -1339,19 +1335,19 @@ def visit_figure(self, node: Element) -> None:
                 length = self.latex_image_length(node[0]['width'])
             self.body.append(BLANKLINE)     # Insert a blank line to prevent infinite loop
                                             # https://github.com/sphinx-doc/sphinx/issues/7059
-            self.body.append('\\begin{wrapfigure}{%s}{%s}' %
+            self.body.append(r'\begin{wrapfigure}{%s}{%s}' %
                              ('r' if node['align'] == 'right' else 'l', length or '0pt') + CR)
-            self.body.append('\\centering')
-            self.context.append('\\end{wrapfigure}' + CR)
+            self.body.append(r'\centering')
+            self.context.append(r'\end{wrapfigure}' + CR)
         elif self.in_minipage:
-            self.body.append(CR + '\\begin{center}')
-            self.context.append('\\end{center}' + CR)
+            self.body.append(CR + r'\begin{center}')
+            self.context.append(r'\end{center}' + CR)
         else:
-            self.body.append(CR + '\\begin{figure}[%s]' % align + CR)
-            self.body.append('\\centering' + CR)
+            self.body.append(CR + r'\begin{figure}[%s]' % align + CR)
+            self.body.append(r'\centering' + CR)
             if any(isinstance(child, nodes.caption) for child in node):
-                self.body.append('\\capstart' + CR)
-            self.context.append('\\end{figure}' + CR)
+                self.body.append(r'\capstart' + CR)
+            self.context.append(r'\end{figure}' + CR)
 
     def depart_figure(self, node: Element) -> None:
         self.body.append(self.context.pop())
@@ -1359,13 +1355,13 @@ def depart_figure(self, node: Element) -> None:
     def visit_caption(self, node: Element) -> None:
         self.in_caption += 1
         if isinstance(node.parent, captioned_literal_block):
-            self.body.append('\\sphinxSetupCaptionForVerbatim{')
+            self.body.append(r'\sphinxSetupCaptionForVerbatim{')
         elif self.in_minipage and isinstance(node.parent, nodes.figure):
-            self.body.append('\\captionof{figure}{')
+            self.body.append(r'\captionof{figure}{')
         elif self.table and node.parent.tagname == 'figure':
-            self.body.append('\\sphinxfigcaption{')
+            self.body.append(r'\sphinxfigcaption{')
         else:
-            self.body.append('\\caption{')
+            self.body.append(r'\caption{')
 
     def depart_caption(self, node: Element) -> None:
         self.body.append('}')
@@ -1375,27 +1371,27 @@ def depart_caption(self, node: Element) -> None:
         self.in_caption -= 1
 
     def visit_legend(self, node: Element) -> None:
-        self.body.append(CR + '\\begin{sphinxlegend}')
+        self.body.append(CR + r'\begin{sphinxlegend}')
 
     def depart_legend(self, node: Element) -> None:
-        self.body.append('\\end{sphinxlegend}' + CR)
+        self.body.append(r'\end{sphinxlegend}' + CR)
 
     def visit_admonition(self, node: Element) -> None:
-        self.body.append(CR + '\\begin{sphinxadmonition}{note}')
+        self.body.append(CR + r'\begin{sphinxadmonition}{note}')
         self.no_latex_floats += 1
 
     def depart_admonition(self, node: Element) -> None:
-        self.body.append('\\end{sphinxadmonition}' + CR)
+        self.body.append(r'\end{sphinxadmonition}' + CR)
         self.no_latex_floats -= 1
 
     def _visit_named_admonition(self, node: Element) -> None:
         label = admonitionlabels[node.tagname]
-        self.body.append(CR + '\\begin{sphinxadmonition}{%s}{%s:}' %
+        self.body.append(CR + r'\begin{sphinxadmonition}{%s}{%s:}' %
                          (node.tagname, label))
         self.no_latex_floats += 1
 
     def _depart_named_admonition(self, node: Element) -> None:
-        self.body.append('\\end{sphinxadmonition}' + CR)
+        self.body.append(r'\end{sphinxadmonition}' + CR)
         self.no_latex_floats -= 1
 
     visit_attention = _visit_named_admonition
@@ -1473,11 +1469,11 @@ def depart_target(self, node: Element) -> None:
         pass
 
     def visit_attribution(self, node: Element) -> None:
-        self.body.append(CR + '\\begin{flushright}' + CR)
+        self.body.append(CR + r'\begin{flushright}' + CR)
         self.body.append('---')
 
     def depart_attribution(self, node: Element) -> None:
-        self.body.append(CR + '\\end{flushright}' + CR)
+        self.body.append(CR + r'\end{flushright}' + CR)
 
     def visit_index(self, node: Element) -> None:
         def escape(value: str) -> str:
@@ -1495,7 +1491,7 @@ def style(string: str) -> str:
             if match:
                 return match.expand(r'\\spxentry{\1}\\spxextra{\2}')
             else:
-                return '\\spxentry{%s}' % string
+                return r'\spxentry{%s}' % string
 
         if not node.get('inline', True):
             self.body.append(CR)
@@ -1542,7 +1538,7 @@ def style(string: str) -> str:
             except ValueError as err:
                 logger.warning(str(err))
         if not node.get('inline', True):
-            self.body.append('\\ignorespaces ')
+            self.body.append(r'\ignorespaces ')
         raise nodes.SkipNode
 
     def visit_raw(self, node: Element) -> None:
@@ -1602,12 +1598,12 @@ def visit_reference(self, node: Element) -> None:
         else:
             if len(node) == 1 and uri == node[0]:
                 if node.get('nolinkurl'):
-                    self.body.append('\\sphinxnolinkurl{%s}' % self.encode_uri(uri))
+                    self.body.append(r'\sphinxnolinkurl{%s}' % self.encode_uri(uri))
                 else:
-                    self.body.append('\\sphinxurl{%s}' % self.encode_uri(uri))
+                    self.body.append(r'\sphinxurl{%s}' % self.encode_uri(uri))
                 raise nodes.SkipNode
             else:
-                self.body.append('\\sphinxhref{%s}{' % self.encode_uri(uri))
+                self.body.append(r'\sphinxhref{%s}{' % self.encode_uri(uri))
                 self.context.append('}')
 
     def depart_reference(self, node: Element) -> None:
@@ -1621,16 +1617,16 @@ def visit_number_reference(self, node: Element) -> None:
         else:
             id = node.get('refuri', '')[1:].replace('#', ':')
 
-        title = self.escape(node.get('title', '%s')).replace('\\%s', '%s')
-        if '\\{name\\}' in title or '\\{number\\}' in title:
+        title = self.escape(node.get('title', '%s')).replace(r'\%s', '%s')
+        if r'\{name\}' in title or r'\{number\}' in title:
             # new style format (cf. "Fig.%{number}")
-            title = title.replace('\\{name\\}', '{name}').replace('\\{number\\}', '{number}')
-            text = escape_abbr(title).format(name='\\nameref{%s}' % self.idescape(id),
-                                             number='\\ref{%s}' % self.idescape(id))
+            title = title.replace(r'\{name\}', '{name}').replace(r'\{number\}', '{number}')
+            text = escape_abbr(title).format(name=r'\nameref{%s}' % self.idescape(id),
+                                             number=r'\ref{%s}' % self.idescape(id))
         else:
             # old style format (cf. "Fig.%{number}")
-            text = escape_abbr(title) % ('\\ref{%s}' % self.idescape(id))
-        hyperref = '\\hyperref[%s]{%s}' % (self.idescape(id), text)
+            text = escape_abbr(title) % (r'\ref{%s}' % self.idescape(id))
+        hyperref = r'\hyperref[%s]{%s}' % (self.idescape(id), text)
         self.body.append(hyperref)
 
         raise nodes.SkipNode
@@ -1704,15 +1700,15 @@ def visit_thebibliography(self, node: Element) -> None:
             # adjust max width of citation labels not to break the layout
             longest_label = longest_label[:MAX_CITATION_LABEL_LENGTH]
 
-        self.body.append(CR + '\\begin{sphinxthebibliography}{%s}' %
+        self.body.append(CR + r'\begin{sphinxthebibliography}{%s}' %
                          self.encode(longest_label) + CR)
 
     def depart_thebibliography(self, node: Element) -> None:
-        self.body.append('\\end{sphinxthebibliography}' + CR)
+        self.body.append(r'\end{sphinxthebibliography}' + CR)
 
     def visit_citation(self, node: Element) -> None:
         label = cast(nodes.label, node[0])
-        self.body.append('\\bibitem[%s]{%s:%s}' % (self.encode(label.astext()),
+        self.body.append(r'\bibitem[%s]{%s:%s}' % (self.encode(label.astext()),
                                                    node['docname'], node['ids'][0]))
 
     def depart_citation(self, node: Element) -> None:
@@ -1722,7 +1718,7 @@ def visit_citation_reference(self, node: Element) -> None:
         if self.in_title:
             pass
         else:
-            self.body.append('\\sphinxcite{%s:%s}' % (node['docname'], node['refname']))
+            self.body.append(r'\sphinxcite{%s:%s}' % (node['docname'], node['refname']))
             raise nodes.SkipNode
 
     def depart_citation_reference(self, node: Element) -> None:
@@ -1743,7 +1739,7 @@ def visit_footnote_reference(self, node: Element) -> None:
         raise nodes.SkipNode
 
     def visit_footnotemark(self, node: Element) -> None:
-        self.body.append('\\sphinxfootnotemark[')
+        self.body.append(r'\sphinxfootnotemark[')
 
     def depart_footnotemark(self, node: Element) -> None:
         self.body.append(']')
@@ -1751,15 +1747,15 @@ def depart_footnotemark(self, node: Element) -> None:
     def visit_footnotetext(self, node: Element) -> None:
         label = cast(nodes.label, node[0])
         self.body.append('%' + CR)
-        self.body.append('\\begin{footnotetext}[%s]'
-                         '\\phantomsection\\label{\\thesphinxscope.%s}%%'
+        self.body.append(r'\begin{footnotetext}[%s]'
+                         r'\phantomsection\label{\thesphinxscope.%s}%%'
                          % (label.astext(), label.astext()) + CR)
-        self.body.append('\\sphinxAtStartFootnote' + CR)
+        self.body.append(r'\sphinxAtStartFootnote' + CR)
 
     def depart_footnotetext(self, node: Element) -> None:
         # the \ignorespaces in particular for after table header use
         self.body.append('%' + CR)
-        self.body.append('\\end{footnotetext}\\ignorespaces ')
+        self.body.append(r'\end{footnotetext}\ignorespaces ')
 
     def visit_captioned_literal_block(self, node: Element) -> None:
         pass
@@ -1771,13 +1767,13 @@ def visit_literal_block(self, node: Element) -> None:
         if node.rawsource != node.astext():
             # most probably a parsed-literal block -- don't highlight
             self.in_parsed_literal += 1
-            self.body.append('\\begin{sphinxalltt}' + CR)
+            self.body.append(r'\begin{sphinxalltt}' + CR)
         else:
             labels = self.hypertarget_to(node)
             if isinstance(node.parent, captioned_literal_block):
                 labels += self.hypertarget_to(node.parent)
             if labels and not self.in_footnote:
-                self.body.append(CR + '\\def\\sphinxLiteralBlockLabel{' + labels + '}')
+                self.body.append(CR + r'\def\sphinxLiteralBlockLabel{' + labels + '}')
 
             lang = node.get('language', 'default')
             linenos = node.get('linenos', False)
@@ -1790,57 +1786,57 @@ def visit_literal_block(self, node: Element) -> None:
                 location=node, **highlight_args
             )
             if self.in_footnote:
-                self.body.append(CR + '\\sphinxSetupCodeBlockInFootnote')
-                hlcode = hlcode.replace('\\begin{Verbatim}',
-                                        '\\begin{sphinxVerbatim}')
+                self.body.append(CR + r'\sphinxSetupCodeBlockInFootnote')
+                hlcode = hlcode.replace(r'\begin{Verbatim}',
+                                        r'\begin{sphinxVerbatim}')
             # if in table raise verbatim flag to avoid "tabulary" environment
             # and opt for sphinxVerbatimintable to handle caption & long lines
             elif self.table:
                 self.table.has_problematic = True
                 self.table.has_verbatim = True
-                hlcode = hlcode.replace('\\begin{Verbatim}',
-                                        '\\begin{sphinxVerbatimintable}')
+                hlcode = hlcode.replace(r'\begin{Verbatim}',
+                                        r'\begin{sphinxVerbatimintable}')
             else:
-                hlcode = hlcode.replace('\\begin{Verbatim}',
-                                        '\\begin{sphinxVerbatim}')
+                hlcode = hlcode.replace(r'\begin{Verbatim}',
+                                        r'\begin{sphinxVerbatim}')
             # get consistent trailer
             hlcode = hlcode.rstrip()[:-14]  # strip \end{Verbatim}
             if self.table and not self.in_footnote:
-                hlcode += '\\end{sphinxVerbatimintable}'
+                hlcode += r'\end{sphinxVerbatimintable}'
             else:
-                hlcode += '\\end{sphinxVerbatim}'
+                hlcode += r'\end{sphinxVerbatim}'
 
             hllines = str(highlight_args.get('hl_lines', []))[1:-1]
             if hllines:
-                self.body.append(CR + '\\fvset{hllines={, %s,}}%%' % hllines)
+                self.body.append(CR + r'\fvset{hllines={, %s,}}%%' % hllines)
             self.body.append(CR + hlcode + CR)
             if hllines:
-                self.body.append('\\sphinxresetverbatimhllines' + CR)
+                self.body.append(r'\sphinxresetverbatimhllines' + CR)
             raise nodes.SkipNode
 
     def depart_literal_block(self, node: Element) -> None:
-        self.body.append(CR + '\\end{sphinxalltt}' + CR)
+        self.body.append(CR + r'\end{sphinxalltt}' + CR)
         self.in_parsed_literal -= 1
     visit_doctest_block = visit_literal_block
     depart_doctest_block = depart_literal_block
 
     def visit_line(self, node: Element) -> None:
-        self.body.append('\\item[] ')
+        self.body.append(r'\item[] ')
 
     def depart_line(self, node: Element) -> None:
         self.body.append(CR)
 
     def visit_line_block(self, node: Element) -> None:
         if isinstance(node.parent, nodes.line_block):
-            self.body.append('\\item[]' + CR)
-            self.body.append('\\begin{DUlineblock}{\\DUlineblockindent}' + CR)
+            self.body.append(r'\item[]' + CR)
+            self.body.append(r'\begin{DUlineblock}{\DUlineblockindent}' + CR)
         else:
-            self.body.append(CR + '\\begin{DUlineblock}{0em}' + CR)
+            self.body.append(CR + r'\begin{DUlineblock}{0em}' + CR)
         if self.table:
             self.table.has_problematic = True
 
     def depart_line_block(self, node: Element) -> None:
-        self.body.append('\\end{DUlineblock}' + CR)
+        self.body.append(r'\end{DUlineblock}' + CR)
 
     def visit_block_quote(self, node: Element) -> None:
         # If the block quote contains a single object and that object
@@ -1853,7 +1849,7 @@ def visit_block_quote(self, node: Element) -> None:
                     isinstance(child, nodes.enumerated_list):
                 done = 1
         if not done:
-            self.body.append('\\begin{quote}' + CR)
+            self.body.append(r'\begin{quote}' + CR)
             if self.table:
                 self.table.has_problematic = True
 
@@ -1865,7 +1861,7 @@ def depart_block_quote(self, node: Element) -> None:
                     isinstance(child, nodes.enumerated_list):
                 done = 1
         if not done:
-            self.body.append('\\end{quote}' + CR)
+            self.body.append(r'\end{quote}' + CR)
 
     # option node handling copied from docutils' latex writer
 
@@ -1886,7 +1882,7 @@ def depart_option_argument(self, node: Element) -> None:
         pass
 
     def visit_option_group(self, node: Element) -> None:
-        self.body.append('\\item [')
+        self.body.append(r'\item [')
         # flag for first option
         self.context.append(0)
 
@@ -1895,12 +1891,12 @@ def depart_option_group(self, node: Element) -> None:
         self.body.append('] ')
 
     def visit_option_list(self, node: Element) -> None:
-        self.body.append('\\begin{optionlist}{3cm}' + CR)
+        self.body.append(r'\begin{optionlist}{3cm}' + CR)
         if self.table:
             self.table.has_problematic = True
 
     def depart_option_list(self, node: Element) -> None:
-        self.body.append('\\end{optionlist}' + CR)
+        self.body.append(r'\end{optionlist}' + CR)
 
     def visit_option_list_item(self, node: Element) -> None:
         pass
@@ -1920,13 +1916,13 @@ def depart_description(self, node: Element) -> None:
         pass
 
     def visit_superscript(self, node: Element) -> None:
-        self.body.append('$^{\\text{')
+        self.body.append(r'$^{\text{')
 
     def depart_superscript(self, node: Element) -> None:
         self.body.append('}}$')
 
     def visit_subscript(self, node: Element) -> None:
-        self.body.append('$_{\\text{')
+        self.body.append(r'$_{\text{')
 
     def depart_subscript(self, node: Element) -> None:
         self.body.append('}}$')
@@ -1993,7 +1989,7 @@ def encode(self, text: str) -> str:
         if self.literal_whitespace:
             # Insert a blank before the newline, to avoid
             # ! LaTeX Error: There's no line here to end.
-            text = text.replace(CR, '~\\\\' + CR).replace(' ', '~')
+            text = text.replace(CR, r'~\\' + CR).replace(' ', '~')
         return text
 
     def encode_uri(self, text: str) -> str:
@@ -2001,9 +1997,9 @@ def encode_uri(self, text: str) -> str:
         #       this must be checked against hyperref package exact dealings
         #       mainly, %, #, {, } and \ need escaping via a \ escape
         # in \href, the tilde is allowed and must be represented literally
-        return self.encode(text).replace('\\textasciitilde{}', '~').\
-            replace('\\sphinxhyphen{}', '-').\
-            replace('\\textquotesingle{}', "'")
+        return self.encode(text).replace(r'\textasciitilde{}', '~').\
+            replace(r'\sphinxhyphen{}', '-').\
+            replace(r'\textquotesingle{}', "'")
 
     def visit_Text(self, node: Text) -> None:
         text = self.encode(node.astext())

From 3f62d2f294bb6e066325bc8f1a58f6a565c9b3c5 Mon Sep 17 00:00:00 2001
From: Joaquin Anton <janton@nvidia.com>
Date: Fri, 26 Feb 2021 14:26:09 +0100
Subject: [PATCH 150/305] Use explicit title for titlenode, when no title is
 provided

Signed-off-by: Joaquin Anton <janton@nvidia.com>
---
 sphinx/environment/collectors/title.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/sphinx/environment/collectors/title.py b/sphinx/environment/collectors/title.py
index 5225155e87e..00832ae4399 100644
--- a/sphinx/environment/collectors/title.py
+++ b/sphinx/environment/collectors/title.py
@@ -39,9 +39,10 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
         longtitlenode = titlenode
         # explicit title set with title directive; use this only for
         # the <title> tag in HTML output
-        if 'title' in doctree:
+        explicit_title = nodes.Text(doctree['title']) if 'title' in doctree else None
+        if explicit_title:
             longtitlenode = nodes.title()
-            longtitlenode += nodes.Text(doctree['title'])
+            longtitlenode += explicit_title
         # look for first section title and use that as the title
         for node in doctree.traverse(nodes.section):
             visitor = SphinxContentsFilter(doctree)
@@ -50,7 +51,7 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
             break
         else:
             # document has no title
-            titlenode += nodes.Text('<no title>')
+            titlenode += explicit_title or nodes.Text('<no title>')
         app.env.titles[app.env.docname] = titlenode
         app.env.longtitles[app.env.docname] = longtitlenode
 

From 347ae4ff4733f42a439cd4efb9457e7d4e2a036b Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 27 Feb 2021 13:01:34 +0900
Subject: [PATCH 151/305] Fix #8938: imgconverter: Show the error of the
 command availability check

imgconverter extension suppresses an OSError like "Cannot allocate
memory" unexpectedly.  So the error should be shown with the warning.
---
 CHANGES                    | 1 +
 sphinx/ext/imgconverter.py | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 428b6951f81..50a9ce275a9 100644
--- a/CHANGES
+++ b/CHANGES
@@ -64,6 +64,7 @@ Features added
 * #2018: html: :confval:`html_favicon` and :confval:`html_logo` now accept URL
   for the image
 * #8070: html search: Support searching for 2characters word
+* #8938: imgconverter: Show the error of the command availability check
 * #7830: Add debug logs for change detection of sources and templates
 * #8201: Emit a warning if toctree contains duplicated entries
 
diff --git a/sphinx/ext/imgconverter.py b/sphinx/ext/imgconverter.py
index b0d40b551ec..84fe6549c7a 100644
--- a/sphinx/ext/imgconverter.py
+++ b/sphinx/ext/imgconverter.py
@@ -37,10 +37,10 @@ def is_available(self) -> bool:
             logger.debug('Invoking %r ...', args)
             subprocess.run(args, stdout=PIPE, stderr=PIPE, check=True)
             return True
-        except OSError:
+        except OSError as exc:
             logger.warning(__('convert command %r cannot be run, '
-                              'check the image_converter setting'),
-                           self.config.image_converter)
+                              'check the image_converter setting: %s'),
+                           self.config.image_converter, exc)
             return False
         except CalledProcessError as exc:
             logger.warning(__('convert exited with error:\n'

From 7d3cc382fa2ab875ea168ee40ce34562a387bb40 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 15 Nov 2020 13:58:12 +0900
Subject: [PATCH 152/305] autodoc: an imported TypeVar is not resolved (refs:
 #8415)

So far, a TypeVar is rendered without module name. As a result, it
could not be resolved if it is imported from other modules.  This
prepends its module name and make it resolvable.  This is available
only in Python 3.7 or above.

As a side effect, all of TypeVars are displayed with module name. It
should be fixed in latter step (refs: #7119)
---
 CHANGES                    |  2 ++
 sphinx/util/typing.py      |  5 ++++-
 tests/test_util_inspect.py |  8 +++++++-
 tests/test_util_typing.py  | 15 +++++++++++----
 4 files changed, 24 insertions(+), 6 deletions(-)

diff --git a/CHANGES b/CHANGES
index a908a0f42eb..6ad69d483c3 100644
--- a/CHANGES
+++ b/CHANGES
@@ -72,6 +72,8 @@ Bugs fixed
 ----------
 
 * #8917: autodoc: Raises a warning if function has wrong __globals__ value
+* #8415: autodoc: a TypeVar imported from other module is not resolved (in
+  Python 3.7 or above)
 * #8380: html search: Paragraphs in search results are not identified as ``<p>``
 * #8915: html theme: The translation of sphinx_rtd_theme does not work
 * #8342: Emit a warning if a unknown domain is given for directive or role (ex.
diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py
index d2bd03efd58..afd2f805a9e 100644
--- a/sphinx/util/typing.py
+++ b/sphinx/util/typing.py
@@ -263,7 +263,10 @@ def stringify(annotation: Any) -> str:
         else:
             return annotation
     elif isinstance(annotation, TypeVar):
-        return annotation.__name__
+        if annotation.__module__ == 'typing':
+            return annotation.__name__
+        else:
+            return '.'.join([annotation.__module__, annotation.__name__])
     elif inspect.isNewType(annotation):
         # Could not get the module where it defiend
         return annotation.__name__
diff --git a/tests/test_util_inspect.py b/tests/test_util_inspect.py
index bf202106335..7b86c6ade36 100644
--- a/tests/test_util_inspect.py
+++ b/tests/test_util_inspect.py
@@ -142,7 +142,13 @@ def test_signature_annotations():
 
     # TypeVars and generic types with TypeVars
     sig = inspect.signature(f2)
-    assert stringify_signature(sig) == '(x: List[T], y: List[T_co], z: T) -> List[T_contra]'
+    if sys.version_info < (3, 7):
+        assert stringify_signature(sig) == '(x: List[T], y: List[T_co], z: T) -> List[T_contra]'
+    else:
+        assert stringify_signature(sig) == ('(x: List[tests.typing_test_data.T],'
+                                            ' y: List[tests.typing_test_data.T_co],'
+                                            ' z: tests.typing_test_data.T'
+                                            ') -> List[tests.typing_test_data.T_contra]')
 
     # Union types
     sig = inspect.signature(f3)
diff --git a/tests/test_util_typing.py b/tests/test_util_typing.py
index 927db73fdf0..97732965e89 100644
--- a/tests/test_util_typing.py
+++ b/tests/test_util_typing.py
@@ -194,10 +194,17 @@ def test_stringify_type_hints_typevars():
     T_co = TypeVar('T_co', covariant=True)
     T_contra = TypeVar('T_contra', contravariant=True)
 
-    assert stringify(T) == "T"
-    assert stringify(T_co) == "T_co"
-    assert stringify(T_contra) == "T_contra"
-    assert stringify(List[T]) == "List[T]"
+    if sys.version_info < (3, 7):
+        assert stringify(T) == "T"
+        assert stringify(T_co) == "T_co"
+        assert stringify(T_contra) == "T_contra"
+        assert stringify(List[T]) == "List[T]"
+    else:
+        assert stringify(T) == "tests.test_util_typing.T"
+        assert stringify(T_co) == "tests.test_util_typing.T_co"
+        assert stringify(T_contra) == "tests.test_util_typing.T_contra"
+        assert stringify(List[T]) == "List[tests.test_util_typing.T]"
+
     assert stringify(MyInt) == "MyInt"
 
 

From 3059a999b2f3a2f4b8d69c7e473a81ce70f82f3c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 25 Nov 2020 00:50:36 +0900
Subject: [PATCH 153/305] Close #8326: Rename master_doc to root_doc

To describe the purpose more accurately, the `master_doc` is now renamed
to `root_doc`.  The old name is still available.  But it is recommeneded
to use new one from now on.
---
 CHANGES                                       |  1 +
 doc/_static/conf.py.txt                       |  8 +++---
 doc/conf.py                                   |  2 +-
 doc/man/sphinx-apidoc.rst                     |  2 +-
 doc/man/sphinx-quickstart.rst                 |  4 +--
 doc/templating.rst                            | 14 +++++++++-
 doc/usage/configuration.rst                   | 19 +++++++++----
 doc/usage/restructuredtext/directives.rst     |  6 ++---
 sphinx/builders/__init__.py                   |  8 +++---
 sphinx/builders/_epub_base.py                 | 14 +++++-----
 sphinx/builders/epub3.py                      |  2 +-
 sphinx/builders/html/__init__.py              |  3 ++-
 sphinx/builders/latex/__init__.py             |  2 +-
 sphinx/builders/manpage.py                    |  2 +-
 sphinx/builders/singlehtml.py                 | 16 +++++------
 sphinx/builders/texinfo.py                    |  2 +-
 sphinx/cmd/quickstart.py                      | 27 ++++++++++++++++---
 sphinx/config.py                              | 19 ++++++-------
 sphinx/environment/__init__.py                |  4 +--
 sphinx/environment/adapters/toctree.py        |  2 +-
 sphinx/environment/collectors/toctree.py      |  2 +-
 sphinx/setup_command.py                       |  2 +-
 sphinx/templates/htmlhelp/project.hhc         |  2 +-
 sphinx/templates/htmlhelp/project.hhp         |  4 +--
 sphinx/templates/quickstart/conf.py_t         |  6 ++---
 .../{master_doc.rst_t => root_doc.rst_t}      |  0
 sphinx/themes/agogo/layout.html               |  4 +--
 sphinx/themes/basic/globaltoc.html            |  2 +-
 sphinx/themes/basic/layout.html               |  4 +--
 sphinx/themes/basic/localtoc.html             |  2 +-
 sphinx/themes/haiku/layout.html               |  2 +-
 sphinx/themes/pyramid/layout.html             |  2 +-
 tests/roots/test-ext-doctest-skipif/conf.py   |  2 +-
 tests/roots/test-ext-doctest/conf.py          |  2 +-
 tests/roots/test-latex-equations/conf.py      |  2 +-
 .../roots/test-latex-includegraphics/conf.py  |  2 --
 tests/roots/test-linkcheck/conf.py            |  2 +-
 tests/test_build.py                           | 12 ++++-----
 tests/test_build_latex.py                     |  8 +++---
 tests/test_config.py                          | 14 +++++-----
 tests/test_environment.py                     |  4 +--
 tests/test_quickstart.py                      |  2 +-
 tests/test_setup_command.py                   | 10 +++----
 43 files changed, 145 insertions(+), 104 deletions(-)
 rename sphinx/templates/quickstart/{master_doc.rst_t => root_doc.rst_t} (100%)

diff --git a/CHANGES b/CHANGES
index a908a0f42eb..72196a184bb 100644
--- a/CHANGES
+++ b/CHANGES
@@ -67,6 +67,7 @@ Features added
 * #8938: imgconverter: Show the error of the command availability check
 * #7830: Add debug logs for change detection of sources and templates
 * #8201: Emit a warning if toctree contains duplicated entries
+* #8326: ``master_doc`` is now renamed to :confval:`root_doc`
 
 Bugs fixed
 ----------
diff --git a/doc/_static/conf.py.txt b/doc/_static/conf.py.txt
index 5420e2717e6..844451fd8a8 100644
--- a/doc/_static/conf.py.txt
+++ b/doc/_static/conf.py.txt
@@ -43,7 +43,7 @@ source_suffix = '.rst'
 # source_encoding = 'utf-8-sig'
 
 # The master toctree document.
-master_doc = 'index'
+root_doc = 'index'
 
 # General information about the project.
 project = u'test'
@@ -252,7 +252,7 @@ latex_elements = {
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    (master_doc, 'test.tex', u'test Documentation',
+    (root_doc, 'test.tex', u'test Documentation',
      u'test', 'manual'),
 ]
 
@@ -283,7 +283,7 @@ latex_documents = [
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    (master_doc, 'test', u'test Documentation',
+    (root_doc, 'test', u'test Documentation',
      [author], 1)
 ]
 
@@ -298,7 +298,7 @@ man_pages = [
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    (master_doc, 'test', u'test Documentation',
+    (root_doc, 'test', u'test Documentation',
      author, 'test', 'One line description of project.',
      'Miscellaneous'),
 ]
diff --git a/doc/conf.py b/doc/conf.py
index f38d03d6d86..7cf74dc97b0 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -9,7 +9,7 @@
               'sphinx.ext.intersphinx',
               'sphinx.ext.viewcode', 'sphinx.ext.inheritance_diagram']
 
-master_doc = 'contents'
+root_doc = 'contents'
 templates_path = ['_templates']
 exclude_patterns = ['_build']
 
diff --git a/doc/man/sphinx-apidoc.rst b/doc/man/sphinx-apidoc.rst
index 725d2f1692d..3ce5b452336 100644
--- a/doc/man/sphinx-apidoc.rst
+++ b/doc/man/sphinx-apidoc.rst
@@ -145,7 +145,7 @@ These options are used when :option:`--full` is specified:
    * ``module.rst_t``
    * ``package.rst_t``
    * ``toc.rst_t``
-   * ``master_doc.rst_t``
+   * ``root_doc.rst_t``
    * ``conf.py_t``
    * ``Makefile_t``
    * ``Makefile.new_t``
diff --git a/doc/man/sphinx-quickstart.rst b/doc/man/sphinx-quickstart.rst
index 520a420ce7f..16fc6656059 100644
--- a/doc/man/sphinx-quickstart.rst
+++ b/doc/man/sphinx-quickstart.rst
@@ -72,7 +72,7 @@ Options
 
 .. option:: --master=MASTER
 
-   Master document name. (see :confval:`master_doc`).
+   Master document name. (see :confval:`root_doc`).
 
 .. rubric:: Extension Options
 
@@ -149,7 +149,7 @@ Options
    sphinx project files generated by quickstart.  Following Jinja2 template
    files are allowed:
 
-   * ``master_doc.rst_t``
+   * ``root_doc.rst_t``
    * ``conf.py_t``
    * ``Makefile_t``
    * ``Makefile.new_t``
diff --git a/doc/templating.rst b/doc/templating.rst
index 97596e6a923..61b714bfa33 100644
--- a/doc/templating.rst
+++ b/doc/templating.rst
@@ -325,7 +325,19 @@ in the future.
 
 .. data:: master_doc
 
-   The value of :confval:`master_doc`, for usage with :func:`pathto`.
+   Same as :data:`root_doc`.
+
+   .. versionchanged:: 4.0
+
+      Renamed to ``root_doc``.
+
+.. data:: root_doc
+
+   The value of :confval:`root_doc`, for usage with :func:`pathto`.
+
+   .. versionchanged:: 4.0
+
+      Renamed from ``master_doc``.
 
 .. data:: pagename
 
diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index de3416c47e6..23db18fed78 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -183,11 +183,20 @@ General configuration
 
 .. confval:: master_doc
 
-   The document name of the "master" document, that is, the document that
+   Same as :confval:`root_doc`.
+
+   .. versionchanged:: 4.0
+      Renamed ``master_doc`` to ``master_doc``.
+
+.. confval:: root_doc
+
+   The document name of the "root" document, that is, the document that
    contains the root :rst:dir:`toctree` directive.  Default is ``'index'``.
 
    .. versionchanged:: 2.0
       The default is changed to ``'index'`` from ``'contents'``.
+   .. versionchanged:: 4.0
+      Renamed ``master_doc`` from ``master_doc``.
 
 .. confval:: exclude_patterns
 
@@ -2023,8 +2032,8 @@ These options influence LaTeX output.
    *startdocname*
      String that specifies the :term:`document name` of the LaTeX file's master
      document.  All documents referenced by the *startdoc* document in TOC trees
-     will be included in the LaTeX file.  (If you want to use the default master
-     document for your LaTeX build, provide your :confval:`master_doc` here.)
+     will be included in the LaTeX file.  (If you want to use the default root
+     document for your LaTeX build, provide your :confval:`root_doc` here.)
 
    *targetname*
      File name of the LaTeX file in the output directory.
@@ -2293,7 +2302,7 @@ These options influence manual page output.
      String that specifies the :term:`document name` of the manual page's master
      document. All documents referenced by the *startdoc* document in TOC trees
      will be included in the manual file.  (If you want to use the default
-     master document for your manual pages build, use your :confval:`master_doc`
+     root document for your manual pages build, use your :confval:`root_doc`
      here.)
 
    *name*
@@ -2349,7 +2358,7 @@ These options influence Texinfo output.
      master document.  All documents referenced by the *startdoc* document in
      TOC trees will be included in the Texinfo file.  (If you want to use the
      default master document for your Texinfo build, provide your
-     :confval:`master_doc` here.)
+     :confval:`root_doc` here.)
 
    *targetname*
      File name (no extension) of the Texinfo file in the output directory.
diff --git a/doc/usage/restructuredtext/directives.rst b/doc/usage/restructuredtext/directives.rst
index 53625ac9e11..995804e3706 100644
--- a/doc/usage/restructuredtext/directives.rst
+++ b/doc/usage/restructuredtext/directives.rst
@@ -197,9 +197,9 @@ tables of contents.  The ``toctree`` directive is the central element.
    <metadata>` to let a document be built, but notify Sphinx that it is not
    reachable via a toctree.
 
-   The "master document" (selected by :confval:`master_doc`) is the "root" of
-   the TOC tree hierarchy.  It can be used as the documentation's main page, or
-   as a "full table of contents" if you don't give a ``maxdepth`` option.
+   The "root document" (selected by :confval:`root_doc`) is the "root" of the TOC
+   tree hierarchy.  It can be used as the documentation's main page, or as a
+   "full table of contents" if you don't give a ``maxdepth`` option.
 
    .. versionchanged:: 0.3
       Added "globbing" option.
diff --git a/sphinx/builders/__init__.py b/sphinx/builders/__init__.py
index 7e361652f07..c4ac432e421 100644
--- a/sphinx/builders/__init__.py
+++ b/sphinx/builders/__init__.py
@@ -413,9 +413,9 @@ def read(self) -> List[str]:
         else:
             self._read_serial(docnames)
 
-        if self.config.master_doc not in self.env.all_docs:
-            raise SphinxError('master file %s not found' %
-                              self.env.doc2path(self.config.master_doc))
+        if self.config.root_doc not in self.env.all_docs:
+            raise SphinxError('root file %s not found' %
+                              self.env.doc2path(self.config.root_doc))
 
         for retval in self.events.emit('env-updated', self.env):
             if retval is not None:
@@ -517,7 +517,7 @@ def write(self, build_docnames: Iterable[str], updated_docnames: Sequence[str],
             for tocdocname in self.env.files_to_rebuild.get(docname, set()):
                 if tocdocname in self.env.found_docs:
                     docnames.add(tocdocname)
-        docnames.add(self.config.master_doc)
+        docnames.add(self.config.root_doc)
 
         with progress_message(__('preparing documents')):
             self.prepare_writing(docnames)
diff --git a/sphinx/builders/_epub_base.py b/sphinx/builders/_epub_base.py
index 453474e094d..3b19bb8d06e 100644
--- a/sphinx/builders/_epub_base.py
+++ b/sphinx/builders/_epub_base.py
@@ -222,14 +222,14 @@ def check_refnodes(self, nodes: List[Dict[str, Any]]) -> None:
                 appeared.add(node['refuri'])
 
     def get_toc(self) -> None:
-        """Get the total table of contents, containing the master_doc
+        """Get the total table of contents, containing the root_doc
         and pre and post files not managed by sphinx.
         """
-        doctree = self.env.get_and_resolve_doctree(self.config.master_doc,
+        doctree = self.env.get_and_resolve_doctree(self.config.root_doc,
                                                    self, prune_toctrees=False,
                                                    includehidden=True)
         self.refnodes = self.get_refnodes(doctree, [])
-        master_dir = path.dirname(self.config.master_doc)
+        master_dir = path.dirname(self.config.root_doc)
         if master_dir:
             master_dir += '/'  # XXX or os.sep?
             for item in self.refnodes:
@@ -237,13 +237,13 @@ def get_toc(self) -> None:
         self.toc_add_files(self.refnodes)
 
     def toc_add_files(self, refnodes: List[Dict[str, Any]]) -> None:
-        """Add the master_doc, pre and post files to a list of refnodes.
+        """Add the root_doc, pre and post files to a list of refnodes.
         """
         refnodes.insert(0, {
             'level': 1,
-            'refuri': html.escape(self.config.master_doc + self.out_suffix),
+            'refuri': html.escape(self.config.root_doc + self.out_suffix),
             'text': ssp(html.escape(
-                self.env.titles[self.config.master_doc].astext()))
+                self.env.titles[self.config.root_doc].astext()))
         })
         for file, text in reversed(self.config.epub_pre_files):
             refnodes.insert(0, {
@@ -677,7 +677,7 @@ def build_toc(self) -> None:
         logger.info(__('writing toc.ncx file...'))
 
         if self.config.epub_tocscope == 'default':
-            doctree = self.env.get_and_resolve_doctree(self.config.master_doc,
+            doctree = self.env.get_and_resolve_doctree(self.config.root_doc,
                                                        self, prune_toctrees=False,
                                                        includehidden=False)
             refnodes = self.get_refnodes(doctree, [])
diff --git a/sphinx/builders/epub3.py b/sphinx/builders/epub3.py
index 8a0dab30362..623ee45a45d 100644
--- a/sphinx/builders/epub3.py
+++ b/sphinx/builders/epub3.py
@@ -166,7 +166,7 @@ def build_navigation_doc(self) -> None:
 
         if self.config.epub_tocscope == 'default':
             doctree = self.env.get_and_resolve_doctree(
-                self.config.master_doc, self,
+                self.config.root_doc, self,
                 prune_toctrees=False, includehidden=False)
             refnodes = self.get_refnodes(doctree, [])
             self.toc_add_files(refnodes)
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index a68594a6d05..0f55aa8bfe7 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -494,7 +494,8 @@ def prepare_writing(self, docnames: Set[str]) -> None:
             'version': self.config.version,
             'last_updated': self.last_updated,
             'copyright': self.config.copyright,
-            'master_doc': self.config.master_doc,
+            'master_doc': self.config.root_doc,
+            'root_doc': self.config.root_doc,
             'use_opensearch': self.config.html_use_opensearch,
             'docstitle': self.config.html_title,
             'shorttitle': self.config.html_short_title,
diff --git a/sphinx/builders/latex/__init__.py b/sphinx/builders/latex/__init__.py
index dc533b48635..681d3cfe6f1 100644
--- a/sphinx/builders/latex/__init__.py
+++ b/sphinx/builders/latex/__init__.py
@@ -517,7 +517,7 @@ def default_latex_documents(config: Config) -> List[Tuple[str, str, str, str, st
     """ Better default latex_documents settings. """
     project = texescape.escape(config.project, config.latex_engine)
     author = texescape.escape(config.author, config.latex_engine)
-    return [(config.master_doc,
+    return [(config.root_doc,
              make_filename_from_project(config.project) + '.tex',
              texescape.escape_abbr(project),
              texescape.escape_abbr(author),
diff --git a/sphinx/builders/manpage.py b/sphinx/builders/manpage.py
index e1e1b77f011..f994309e1af 100644
--- a/sphinx/builders/manpage.py
+++ b/sphinx/builders/manpage.py
@@ -109,7 +109,7 @@ def finish(self) -> None:
 def default_man_pages(config: Config) -> List[Tuple[str, str, str, List[str], int]]:
     """ Better default man_pages settings. """
     filename = make_filename_from_project(config.project)
-    return [(config.master_doc, filename, '%s %s' % (config.project, config.release),
+    return [(config.root_doc, filename, '%s %s' % (config.project, config.release),
              [config.author], 1)]
 
 
diff --git a/sphinx/builders/singlehtml.py b/sphinx/builders/singlehtml.py
index 2e72887e376..1ef618dd0a2 100644
--- a/sphinx/builders/singlehtml.py
+++ b/sphinx/builders/singlehtml.py
@@ -42,7 +42,7 @@ def get_outdated_docs(self) -> Union[str, List[str]]:  # type: ignore
     def get_target_uri(self, docname: str, typ: str = None) -> str:
         if docname in self.env.all_docs:
             # all references are on the same page...
-            return self.config.master_doc + self.out_suffix + \
+            return self.config.root_doc + self.out_suffix + \
                 '#document-' + docname
         else:
             # chances are this is a html_additional_page
@@ -54,7 +54,7 @@ def get_relative_uri(self, from_: str, to: str, typ: str = None) -> str:
 
     def fix_refuris(self, tree: Node) -> None:
         # fix refuris with double anchor
-        fname = self.config.master_doc + self.out_suffix
+        fname = self.config.root_doc + self.out_suffix
         for refnode in tree.traverse(nodes.reference):
             if 'refuri' not in refnode:
                 continue
@@ -75,7 +75,7 @@ def _get_local_toctree(self, docname: str, collapse: bool = True, **kwargs: Any)
         return self.render_partial(toctree)['fragment']
 
     def assemble_doctree(self) -> nodes.document:
-        master = self.config.master_doc
+        master = self.config.root_doc
         tree = self.env.get_doctree(master)
         tree = inline_all_toctrees(self, set(), master, tree, darkgreen, [master])
         tree['docname'] = master
@@ -99,7 +99,7 @@ def assemble_toc_secnumbers(self) -> Dict[str, Dict[str, Tuple[int, ...]]]:
                 alias = "%s/%s" % (docname, id)
                 new_secnumbers[alias] = secnum
 
-        return {self.config.master_doc: new_secnumbers}
+        return {self.config.root_doc: new_secnumbers}
 
     def assemble_toc_fignumbers(self) -> Dict[str, Dict[str, Dict[str, Tuple[int, ...]]]]:
         # Assemble toc_fignumbers to resolve figure numbers on SingleHTML.
@@ -120,11 +120,11 @@ def assemble_toc_fignumbers(self) -> Dict[str, Dict[str, Dict[str, Tuple[int, ..
                 for id, fignum in fignums.items():
                     new_fignumbers[alias][id] = fignum
 
-        return {self.config.master_doc: new_fignumbers}
+        return {self.config.root_doc: new_fignumbers}
 
     def get_doc_context(self, docname: str, body: str, metatags: str) -> Dict:
         # no relation links...
-        toctree = TocTree(self.env).get_toctree_for(self.config.master_doc, self, False)
+        toctree = TocTree(self.env).get_toctree_for(self.config.root_doc, self, False)
         # if there is no toctree, toc is None
         if toctree:
             self.fix_refuris(toctree)
@@ -160,8 +160,8 @@ def write(self, *ignored: Any) -> None:
             self.env.toc_fignumbers = self.assemble_toc_fignumbers()
 
         with progress_message(__('writing')):
-            self.write_doc_serialized(self.config.master_doc, doctree)
-            self.write_doc(self.config.master_doc, doctree)
+            self.write_doc_serialized(self.config.root_doc, doctree)
+            self.write_doc(self.config.root_doc, doctree)
 
     def finish(self) -> None:
         self.write_additional_files()
diff --git a/sphinx/builders/texinfo.py b/sphinx/builders/texinfo.py
index 1a56be0f909..bb2039e61ef 100644
--- a/sphinx/builders/texinfo.py
+++ b/sphinx/builders/texinfo.py
@@ -197,7 +197,7 @@ def copy_support_files(self) -> None:
 def default_texinfo_documents(config: Config) -> List[Tuple[str, str, str, str, str, str, str]]:  # NOQA
     """ Better default texinfo_documents settings. """
     filename = make_filename_from_project(config.project)
-    return [(config.master_doc, filename, config.project, config.author, filename,
+    return [(config.root_doc, filename, config.project, config.author, filename,
              'One line description of project', 'Miscellaneous')]
 
 
diff --git a/sphinx/cmd/quickstart.py b/sphinx/cmd/quickstart.py
index 4ef9335a4f5..a40a2107310 100644
--- a/sphinx/cmd/quickstart.py
+++ b/sphinx/cmd/quickstart.py
@@ -162,10 +162,22 @@ def __init__(self, templatedir: str) -> None:
         self.templatedir = templatedir or ''
         super().__init__()
 
+    def _has_custom_template(self, template_name: str) -> bool:
+        """Check if custom template file exists.
+
+        Note: Please don't use this function from extensions.
+              It will be removed in the future without deprecation period.
+        """
+        template = path.join(self.templatedir, path.basename(template_name))
+        if self.templatedir and path.exists(template):
+            return True
+        else:
+            return False
+
     def render(self, template_name: str, context: Dict) -> str:
-        user_template = path.join(self.templatedir, path.basename(template_name))
-        if self.templatedir and path.exists(user_template):
-            return self.render_from_file(user_template, context)
+        if self._has_custom_template(template_name):
+            custom_template = path.join(self.templatedir, path.basename(template_name))
+            return self.render_from_file(custom_template, context)
         else:
             return super().render(template_name, context)
 
@@ -318,6 +330,7 @@ def generate(d: Dict, overwrite: bool = True, silent: bool = False, templatedir:
     if 'mastertocmaxdepth' not in d:
         d['mastertocmaxdepth'] = 2
 
+    d['root_doc'] = d['master']
     d['now'] = time.asctime()
     d['project_underline'] = column_width(d['project']) * '='
     d.setdefault('extensions', [])
@@ -362,7 +375,13 @@ def write_file(fpath: str, content: str, newline: str = None) -> None:
     write_file(path.join(srcdir, 'conf.py'), template.render_string(conf_text, d))
 
     masterfile = path.join(srcdir, d['master'] + d['suffix'])
-    write_file(masterfile, template.render('quickstart/master_doc.rst_t', d))
+    if template._has_custom_template('quickstart/master_doc.rst_t'):
+        msg = ('A custom template `master_doc.rst_t` found. It has been renamed to '
+               '`root_doc.rst_t`.  Please rename it on your project too.')
+        print(colorize('red', msg))  # RemovedInSphinx60Warning
+        write_file(masterfile, template.render('quickstart/master_doc.rst_t', d))
+    else:
+        write_file(masterfile, template.render('quickstart/root_doc.rst_t', d))
 
     if d.get('make_mode') is True:
         makefile_template = 'quickstart/Makefile.new_t'
diff --git a/sphinx/config.py b/sphinx/config.py
index 735a3e0b3e3..d7f9c4f8a27 100644
--- a/sphinx/config.py
+++ b/sphinx/config.py
@@ -105,6 +105,7 @@ class Config:
         'figure_language_filename': ('{root}.{language}{ext}', 'env', [str]),
 
         'master_doc': ('index', 'env', []),
+        'root_doc': (lambda config: config.master_doc, 'env', []),
         'source_suffix': ({'.rst': 'restructuredtext'}, 'env', Any),
         'source_encoding': ('utf-8-sig', 'env', []),
         'exclude_patterns': ([], 'env', []),
@@ -461,17 +462,17 @@ def check_primary_domain(app: "Sphinx", config: Config) -> None:
         config.primary_domain = None  # type: ignore
 
 
-def check_master_doc(app: "Sphinx", env: "BuildEnvironment", added: Set[str],
-                     changed: Set[str], removed: Set[str]) -> Set[str]:
-    """Adjust master_doc to 'contents' to support an old project which does not have
-    no master_doc setting.
+def check_root_doc(app: "Sphinx", env: "BuildEnvironment", added: Set[str],
+                   changed: Set[str], removed: Set[str]) -> Set[str]:
+    """Adjust root_doc to 'contents' to support an old project which does not have
+    no root_doc setting.
     """
-    if (app.config.master_doc == 'index' and
+    if (app.config.root_doc == 'index' and
             'index' not in app.project.docnames and
             'contents' in app.project.docnames):
-        logger.warning(__('Since v2.0, Sphinx uses "index" as master_doc by default. '
-                          'Please add "master_doc = \'contents\'" to your conf.py.'))
-        app.config.master_doc = "contents"  # type: ignore
+        logger.warning(__('Since v2.0, Sphinx uses "index" as root_doc by default. '
+                          'Please add "root_doc = \'contents\'" to your conf.py.'))
+        app.config.root_doc = "contents"  # type: ignore
 
     return changed
 
@@ -483,7 +484,7 @@ def setup(app: "Sphinx") -> Dict[str, Any]:
     app.connect('config-inited', correct_copyright_year, priority=800)
     app.connect('config-inited', check_confval_types, priority=800)
     app.connect('config-inited', check_primary_domain, priority=800)
-    app.connect('env-get-outdated', check_master_doc)
+    app.connect('env-get-outdated', check_root_doc)
 
     return {
         'version': 'builtin',
diff --git a/sphinx/environment/__init__.py b/sphinx/environment/__init__.py
index 28599c977f4..60ede8188a4 100644
--- a/sphinx/environment/__init__.py
+++ b/sphinx/environment/__init__.py
@@ -600,7 +600,7 @@ def traverse_toctree(parent: str, docname: str) -> Iterator[Tuple[str, str]]:
                         traversed.add(subdocname)
 
         relations = {}
-        docnames = traverse_toctree(None, self.config.master_doc)
+        docnames = traverse_toctree(None, self.config.root_doc)
         prevdoc = None
         parent, docname = next(docnames)
         for nextparent, nextdoc in docnames:
@@ -618,7 +618,7 @@ def check_consistency(self) -> None:
         included = set().union(*self.included.values())  # type: ignore
         for docname in sorted(self.all_docs):
             if docname not in self.files_to_rebuild:
-                if docname == self.config.master_doc:
+                if docname == self.config.root_doc:
                     # the master file is not included anywhere ;)
                     continue
                 if docname in included:
diff --git a/sphinx/environment/adapters/toctree.py b/sphinx/environment/adapters/toctree.py
index 2e33cf70225..d12055b8438 100644
--- a/sphinx/environment/adapters/toctree.py
+++ b/sphinx/environment/adapters/toctree.py
@@ -315,7 +315,7 @@ def get_toc_for(self, docname: str, builder: "Builder") -> Node:
     def get_toctree_for(self, docname: str, builder: "Builder", collapse: bool,
                         **kwargs: Any) -> Element:
         """Return the global TOC nodetree."""
-        doctree = self.env.get_doctree(self.env.config.master_doc)
+        doctree = self.env.get_doctree(self.env.config.root_doc)
         toctrees = []  # type: List[Element]
         if 'includehidden' not in kwargs:
             kwargs['includehidden'] = True
diff --git a/sphinx/environment/collectors/toctree.py b/sphinx/environment/collectors/toctree.py
index da0b3fe6c5a..aeb6ef3a6d9 100644
--- a/sphinx/environment/collectors/toctree.py
+++ b/sphinx/environment/collectors/toctree.py
@@ -281,7 +281,7 @@ def _walk_doc(docname: str, secnum: Tuple[int, ...]) -> None:
                 _walk_doctree(docname, doctree, secnum)
 
         if env.config.numfig:
-            _walk_doc(env.config.master_doc, tuple())
+            _walk_doc(env.config.root_doc, tuple())
             for docname, fignums in env.toc_fignumbers.items():
                 if fignums != old_fignumbers.get(docname):
                     rewrite_needed.append(docname)
diff --git a/sphinx/setup_command.py b/sphinx/setup_command.py
index dab19547ebf..a508c50a1c9 100644
--- a/sphinx/setup_command.py
+++ b/sphinx/setup_command.py
@@ -190,6 +190,6 @@ def run(self):
             if not self.link_index:
                 continue
 
-            src = app.config.master_doc + app.builder.out_suffix  # type: ignore
+            src = app.config.root_doc + app.builder.out_suffix  # type: ignore
             dst = app.builder.get_outfilename('index')  # type: ignore
             os.symlink(src, dst)
diff --git a/sphinx/templates/htmlhelp/project.hhc b/sphinx/templates/htmlhelp/project.hhc
index c1096e71140..705cfeba7d9 100644
--- a/sphinx/templates/htmlhelp/project.hhc
+++ b/sphinx/templates/htmlhelp/project.hhc
@@ -18,7 +18,7 @@
     </OBJECT>
     <UL>
       <LI>
-        {{ sitemap(short_title, master_doc)|indent(8) }}
+        {{ sitemap(short_title, root_doc)|indent(8) }}
       </LI>
       {%- for indexname, indexcls, content, collapse in domain_indices %}
       <LI>
diff --git a/sphinx/templates/htmlhelp/project.hhp b/sphinx/templates/htmlhelp/project.hhp
index b647b371387..17edc1f3dcb 100644
--- a/sphinx/templates/htmlhelp/project.hhp
+++ b/sphinx/templates/htmlhelp/project.hhp
@@ -4,7 +4,7 @@ Binary Index=No
 Compiled file={{ outname }}.chm
 Contents file={{ outname }}.hhc
 Default Window={{ outname }}
-Default topic={{ master_doc }}
+Default topic={{ root_doc }}
 Display compile progress=No
 Full text search stop list file={{ outname }}.stp
 Full-text search=Yes
@@ -13,7 +13,7 @@ Language={{ "%#x"|format(lcid) }}
 Title={{ title }}
 
 [WINDOWS]
-{{ outname }}="{{ title }}","{{ outname }}.hhc","{{ outname }}.hhk","{{ master_doc }}","{{ master_doc }}",,,,,0x63520,220,0x10384e,[0,0,1024,768],,,,,,,0
+{{ outname }}="{{ title }}","{{ outname }}.hhc","{{ outname }}.hhk","{{ root_doc }}","{{ root_doc }}",,,,,0x63520,220,0x10384e,[0,0,1024,768],,,,,,,0
 
 [FILES]
 {%- for filename in files %}
diff --git a/sphinx/templates/quickstart/conf.py_t b/sphinx/templates/quickstart/conf.py_t
index 8a20fc4c8a3..0c5285f9ec3 100644
--- a/sphinx/templates/quickstart/conf.py_t
+++ b/sphinx/templates/quickstart/conf.py_t
@@ -64,9 +64,9 @@ templates_path = ['{{ dot }}templates']
 source_suffix = {{ suffix | repr }}
 
 {% endif -%}
-{% if master != 'index' -%}
-# The master toctree document.
-master_doc = {{ master | repr }}
+{% if root_doc != 'index' -%}
+# The root document.
+root_doc = {{ root_doc | repr }}
 
 {% endif -%}
 {% if language -%}
diff --git a/sphinx/templates/quickstart/master_doc.rst_t b/sphinx/templates/quickstart/root_doc.rst_t
similarity index 100%
rename from sphinx/templates/quickstart/master_doc.rst_t
rename to sphinx/templates/quickstart/root_doc.rst_t
diff --git a/sphinx/themes/agogo/layout.html b/sphinx/themes/agogo/layout.html
index a8ae6304dc7..855ec8ccb1b 100644
--- a/sphinx/themes/agogo/layout.html
+++ b/sphinx/themes/agogo/layout.html
@@ -14,13 +14,13 @@
     <div class="header-wrapper" role="banner">
       <div class="header">
         {%- if logo_url %}
-          <p class="logo"><a href="{{ pathto(master_doc)|e }}">
+          <p class="logo"><a href="{{ pathto(root_doc)|e }}">
             <img class="logo" src="{{ logo_url|e }}" alt="Logo"/>
           </a></p>
         {%- endif %}
         {%- block headertitle %}
         <div class="headertitle"><a
-          href="{{ pathto(master_doc)|e }}">{{ shorttitle|e }}</a></div>
+          href="{{ pathto(root_doc)|e }}">{{ shorttitle|e }}</a></div>
         {%- endblock %}
         <div class="rel" role="navigation" aria-label="related navigation">
           {%- for rellink in rellinks|reverse %}
diff --git a/sphinx/themes/basic/globaltoc.html b/sphinx/themes/basic/globaltoc.html
index a47c32cc054..5ac0abbd43f 100644
--- a/sphinx/themes/basic/globaltoc.html
+++ b/sphinx/themes/basic/globaltoc.html
@@ -7,5 +7,5 @@
     :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-<h3><a href="{{ pathto(master_doc)|e }}">{{ _('Table of Contents') }}</a></h3>
+<h3><a href="{{ pathto(root_doc)|e }}">{{ _('Table of Contents') }}</a></h3>
 {{ toctree(includehidden=theme_globaltoc_includehidden, collapse=theme_globaltoc_collapse, maxdepth=theme_globaltoc_maxdepth) }}
diff --git a/sphinx/themes/basic/layout.html b/sphinx/themes/basic/layout.html
index e35d4e5fe9a..df07072201e 100644
--- a/sphinx/themes/basic/layout.html
+++ b/sphinx/themes/basic/layout.html
@@ -35,7 +35,7 @@ <h3>{{ _('Navigation') }}</h3>
           {%- if not loop.first %}{{ reldelim2 }}{% endif %}</li>
         {%- endfor %}
         {%- block rootrellink %}
-        <li class="nav-item nav-item-0"><a href="{{ pathto(master_doc)|e }}">{{ shorttitle|e }}</a>{{ reldelim1 }}</li>
+        <li class="nav-item nav-item-0"><a href="{{ pathto(root_doc)|e }}">{{ shorttitle|e }}</a>{{ reldelim1 }}</li>
         {%- endblock %}
         {%- for parent in parents %}
           <li class="nav-item nav-item-{{ loop.index }}"><a href="{{ parent.link|e }}" {% if loop.last %}{{ accesskey("U") }}{% endif %}>{{ parent.title }}</a>{{ reldelim1 }}</li>
@@ -52,7 +52,7 @@ <h3>{{ _('Navigation') }}</h3>
         <div class="sphinxsidebarwrapper">
           {%- block sidebarlogo %}
           {%- if logo_url %}
-            <p class="logo"><a href="{{ pathto(master_doc)|e }}">
+            <p class="logo"><a href="{{ pathto(root_doc)|e }}">
               <img class="logo" src="{{ logo_url|e }}" alt="Logo"/>
             </a></p>
           {%- endif %}
diff --git a/sphinx/themes/basic/localtoc.html b/sphinx/themes/basic/localtoc.html
index c15ad27087d..d761c23787d 100644
--- a/sphinx/themes/basic/localtoc.html
+++ b/sphinx/themes/basic/localtoc.html
@@ -8,6 +8,6 @@
     :license: BSD, see LICENSE for details.
 #}
 {%- if display_toc %}
-  <h3><a href="{{ pathto(master_doc)|e }}">{{ _('Table of Contents') }}</a></h3>
+  <h3><a href="{{ pathto(root_doc)|e }}">{{ _('Table of Contents') }}</a></h3>
   {{ toc }}
 {%- endif %}
diff --git a/sphinx/themes/haiku/layout.html b/sphinx/themes/haiku/layout.html
index bf76204b1ec..50ab798a924 100644
--- a/sphinx/themes/haiku/layout.html
+++ b/sphinx/themes/haiku/layout.html
@@ -21,7 +21,7 @@
         «&#160;&#160;<a href="{{ prev.link|e }}">{{ prev.title }}</a>
         &#160;&#160;::&#160;&#160;
         {%- endif %}
-        <a class="uplink" href="{{ pathto(master_doc)|e }}">{{ _('Contents') }}</a>
+        <a class="uplink" href="{{ pathto(root_doc)|e }}">{{ _('Contents') }}</a>
         {%- if next %}
         &#160;&#160;::&#160;&#160;
         <a href="{{ next.link|e }}">{{ next.title }}</a>&#160;&#160;»
diff --git a/sphinx/themes/pyramid/layout.html b/sphinx/themes/pyramid/layout.html
index 097e974075e..33d9bb7d127 100644
--- a/sphinx/themes/pyramid/layout.html
+++ b/sphinx/themes/pyramid/layout.html
@@ -12,7 +12,7 @@
 {%- if logo %}
 <div class="header" role="banner">
   <div class="logo">
-    <a href="{{ pathto(master_doc)|e }}">
+    <a href="{{ pathto(root_doc)|e }}">
       <img class="logo" src="{{ pathto(logo, 1)|e }}" alt="Logo"/>
     </a>
   </div>
diff --git a/tests/roots/test-ext-doctest-skipif/conf.py b/tests/roots/test-ext-doctest-skipif/conf.py
index c863dbc0132..6f5498256d6 100644
--- a/tests/roots/test-ext-doctest-skipif/conf.py
+++ b/tests/roots/test-ext-doctest-skipif/conf.py
@@ -1,7 +1,7 @@
 extensions = ['sphinx.ext.doctest']
 
 project = 'test project for the doctest :skipif: directive'
-master_doc = 'skipif'
+root_doc = 'skipif'
 source_suffix = '.txt'
 exclude_patterns = ['_build']
 
diff --git a/tests/roots/test-ext-doctest/conf.py b/tests/roots/test-ext-doctest/conf.py
index fcf6a6cdafa..d0e8b107b2f 100644
--- a/tests/roots/test-ext-doctest/conf.py
+++ b/tests/roots/test-ext-doctest/conf.py
@@ -1,6 +1,6 @@
 extensions = ['sphinx.ext.doctest']
 
 project = 'test project for doctest'
-master_doc = 'doctest'
+root_doc = 'doctest'
 source_suffix = '.txt'
 exclude_patterns = ['_build']
diff --git a/tests/roots/test-latex-equations/conf.py b/tests/roots/test-latex-equations/conf.py
index 0957543e667..d851892ba47 100644
--- a/tests/roots/test-latex-equations/conf.py
+++ b/tests/roots/test-latex-equations/conf.py
@@ -1,2 +1,2 @@
-master_doc = 'equations'
+root_doc = 'equations'
 extensions = ['sphinx.ext.imgmath']
diff --git a/tests/roots/test-latex-includegraphics/conf.py b/tests/roots/test-latex-includegraphics/conf.py
index b53df86a2b4..65c19ab859c 100644
--- a/tests/roots/test-latex-includegraphics/conf.py
+++ b/tests/roots/test-latex-includegraphics/conf.py
@@ -1,5 +1,3 @@
-master_doc = 'index'
-
 exclude_patterns = ['_build']
 
 latex_elements = {
diff --git a/tests/roots/test-linkcheck/conf.py b/tests/roots/test-linkcheck/conf.py
index ae8ef24b7e5..ac54f73b02e 100644
--- a/tests/roots/test-linkcheck/conf.py
+++ b/tests/roots/test-linkcheck/conf.py
@@ -1,4 +1,4 @@
-master_doc = 'links'
+root_doc = 'links'
 source_suffix = '.txt'
 exclude_patterns = ['_build']
 linkcheck_anchors = True
diff --git a/tests/test_build.py b/tests/test_build.py
index 62de3ea5f59..03643c91f6f 100644
--- a/tests/test_build.py
+++ b/tests/test_build.py
@@ -48,12 +48,12 @@ def nonascii_srcdir(request, rootdir, sphinx_test_tempdir):
             =======================
             """))
 
-        master_doc = srcdir / 'index.txt'
-        master_doc.write_text(master_doc.read_text() + dedent("""
-                              .. toctree::
+        root_doc = srcdir / 'index.txt'
+        root_doc.write_text(root_doc.read_text() + dedent("""
+                            .. toctree::
 
-                                 %(test_name)s/%(test_name)s
-                              """ % {'test_name': test_name}))
+                               %(test_name)s/%(test_name)s
+                            """ % {'test_name': test_name}))
     return srcdir
 
 
@@ -71,7 +71,7 @@ def test_build_all(requests_head, make_app, nonascii_srcdir, buildername):
     app.build()
 
 
-def test_master_doc_not_found(tempdir, make_app):
+def test_root_doc_not_found(tempdir, make_app):
     (tempdir / 'conf.py').write_text('')
     assert tempdir.listdir() == ['conf.py']
 
diff --git a/tests/test_build_latex.py b/tests/test_build_latex.py
index 4c735952fd7..c8c94b44bd3 100644
--- a/tests/test_build_latex.py
+++ b/tests/test_build_latex.py
@@ -1037,7 +1037,7 @@ def test_toctree_maxdepth_howto(app, status, warning):
 
 @pytest.mark.sphinx(
     'latex', testroot='toctree-maxdepth',
-    confoverrides={'master_doc': 'foo'})
+    confoverrides={'root_doc': 'foo'})
 def test_toctree_not_found(app, status, warning):
     app.builder.build_all()
     result = (app.outdir / 'python.tex').read_text()
@@ -1051,7 +1051,7 @@ def test_toctree_not_found(app, status, warning):
 
 @pytest.mark.sphinx(
     'latex', testroot='toctree-maxdepth',
-    confoverrides={'master_doc': 'bar'})
+    confoverrides={'root_doc': 'bar'})
 def test_toctree_without_maxdepth(app, status, warning):
     app.builder.build_all()
     result = (app.outdir / 'python.tex').read_text()
@@ -1064,7 +1064,7 @@ def test_toctree_without_maxdepth(app, status, warning):
 
 @pytest.mark.sphinx(
     'latex', testroot='toctree-maxdepth',
-    confoverrides={'master_doc': 'qux'})
+    confoverrides={'root_doc': 'qux'})
 def test_toctree_with_deeper_maxdepth(app, status, warning):
     app.builder.build_all()
     result = (app.outdir / 'python.tex').read_text()
@@ -1532,7 +1532,7 @@ def test_latex_figure_in_admonition(app, status, warning):
 def test_default_latex_documents():
     from sphinx.util import texescape
     texescape.init()
-    config = Config({'master_doc': 'index',
+    config = Config({'root_doc': 'index',
                      'project': 'STASI™ Documentation',
                      'author': "Wolfgang Schäuble & G'Beckstein."})
     config.init_values()
diff --git a/tests/test_config.py b/tests/test_config.py
index 9a0b617d5d9..a48e7ce30bc 100644
--- a/tests/test_config.py
+++ b/tests/test_config.py
@@ -20,7 +20,7 @@
 
 
 @pytest.mark.sphinx(testroot='config', confoverrides={
-    'master_doc': 'master',
+    'root_doc': 'root',
     'nonexisting_value': 'True',
     'latex_elements.maketitle': 'blah blah blah',
     'modindex_common_prefix': 'path1,path2'})
@@ -33,7 +33,7 @@ def test_core_config(app, status, warning):
     assert cfg.templates_path == ['_templates']
 
     # overrides
-    assert cfg.master_doc == 'master'
+    assert cfg.root_doc == 'root'
     assert cfg.latex_elements['maketitle'] == 'blah blah blah'
     assert cfg.modindex_common_prefix == ['path1', 'path2']
 
@@ -78,11 +78,11 @@ def test_extension_values():
     config = Config()
 
     # check standard settings
-    assert config.master_doc == 'index'
+    assert config.root_doc == 'index'
 
     # can't override it by add_config_value()
     with pytest.raises(ExtensionError) as excinfo:
-        config.add('master_doc', 'index', 'env', None)
+        config.add('root_doc', 'index', 'env', None)
     assert 'already present' in str(excinfo.value)
 
     # add a new config value
@@ -201,13 +201,13 @@ def test_config_eol(logger, tempdir):
         assert logger.called is False
 
 
-@pytest.mark.sphinx(confoverrides={'master_doc': 123,
+@pytest.mark.sphinx(confoverrides={'root_doc': 123,
                                    'language': 'foo',
                                    'primary_domain': None})
 def test_builtin_conf(app, status, warning):
     warnings = warning.getvalue()
-    assert 'master_doc' in warnings, (
-        'override on builtin "master_doc" should raise a type warning')
+    assert 'root_doc' in warnings, (
+        'override on builtin "root_doc" should raise a type warning')
     assert 'language' not in warnings, (
         'explicitly permitted override on builtin "language" should NOT raise '
         'a type warning')
diff --git a/tests/test_environment.py b/tests/test_environment.py
index bad06baa4d7..5d3035ac0cd 100644
--- a/tests/test_environment.py
+++ b/tests/test_environment.py
@@ -35,14 +35,14 @@ def test_config_status(make_app, app_params):
     assert "0 added, 0 changed, 0 removed" in app2._status.getvalue()
 
     # incremental build (config entry changed)
-    app3 = make_app(*args, confoverrides={'master_doc': 'indexx'}, **kwargs)
+    app3 = make_app(*args, confoverrides={'root_doc': 'indexx'}, **kwargs)
     fname = os.path.join(app3.srcdir, 'index.rst')
     assert os.path.isfile(fname)
     shutil.move(fname, fname[:-4] + 'x.rst')
     assert app3.env.config_status == CONFIG_CHANGED
     app3.build()
     shutil.move(fname[:-4] + 'x.rst', fname)
-    assert "[config changed ('master_doc')] 1 added" in app3._status.getvalue()
+    assert "[config changed ('root_doc')] 1 added" in app3._status.getvalue()
 
     # incremental build (extension changed)
     app4 = make_app(*args, confoverrides={'extensions': ['sphinx.ext.autodoc']}, **kwargs)
diff --git a/tests/test_quickstart.py b/tests/test_quickstart.py
index 02aafe335f5..94144ef2210 100644
--- a/tests/test_quickstart.py
+++ b/tests/test_quickstart.py
@@ -163,7 +163,7 @@ def test_quickstart_all_answers(tempdir):
     ]
     assert ns['templates_path'] == ['.templates']
     assert ns['source_suffix'] == '.txt'
-    assert ns['master_doc'] == 'contents'
+    assert ns['root_doc'] == 'contents'
     assert ns['project'] == 'STASI™'
     assert ns['copyright'] == '%s, Wolfgang Schäuble & G\'Beckstein' % \
         time.strftime('%Y')
diff --git a/tests/test_setup_command.py b/tests/test_setup_command.py
index 52dad14fd4e..0561b2fc4fa 100644
--- a/tests/test_setup_command.py
+++ b/tests/test_setup_command.py
@@ -93,12 +93,12 @@ def nonascii_srcdir(request, setup_command):
         ==========================
         """))
 
-    master_doc = srcdir / 'index.txt'
-    master_doc.write_bytes((master_doc.read_text() + dedent("""
-                            .. toctree::
+    root_doc = srcdir / 'index.txt'
+    root_doc.write_bytes((root_doc.read_text() + dedent("""
+                          .. toctree::
 
-                               %(mb_name)s/%(mb_name)s
-                            """ % locals())).encode())
+                             %(mb_name)s/%(mb_name)s
+                          """ % locals())).encode())
 
 
 @pytest.mark.usefixtures('nonascii_srcdir')

From ae5986f9cdbac0a35110b010126d0d56446bd0de Mon Sep 17 00:00:00 2001
From: Thomas Grainger <tagrain@gmail.com>
Date: Sun, 28 Feb 2021 12:00:18 +0000
Subject: [PATCH 154/305] Update sphinx/builders/html/__init__.py

---
 sphinx/builders/html/__init__.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 760a17dc507..bd31e309b48 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1260,11 +1260,7 @@ def migrate_html_add_permalinks(app: Sphinx, config: Config) -> None:
     # RemovedInSphinx60Warning
     logger.warning(__('html_add_permalinks has been deprecated since v3.5.0. '
                       'Please use html_permalinks and html_permalinks_icon instead.'))
-    if (
-        html_add_permalinks is None or
-        html_add_permalinks is False or
-        html_add_permalinks == ""
-    ):
+    if not html_add_permalinks:
         config.html_permalinks = False  # type: ignore[attr-defined]
         return
 

From 878c11611275eca4d14a56efcf79a55ad242dc9a Mon Sep 17 00:00:00 2001
From: Thomas Grainger <tagrain@gmail.com>
Date: Sun, 28 Feb 2021 14:29:07 +0000
Subject: [PATCH 155/305] Update sphinx/builders/html/__init__.py

---
 sphinx/builders/html/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index bd31e309b48..01de0b94fd4 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1265,7 +1265,7 @@ def migrate_html_add_permalinks(app: Sphinx, config: Config) -> None:
         return
 
     config.html_permalinks_icon = html.escape(  # type: ignore[attr-defined]
-        config.html_add_permalinks
+        html_add_permalinks
     )
 
 # for compatibility

From 727e95f15cc2b054e44133cea5a2916051a9b066 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 28 Feb 2021 23:45:23 +0900
Subject: [PATCH 156/305] Update CHANGES for PR #8905

---
 CHANGES | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGES b/CHANGES
index cd2f055364b..2c51be98f66 100644
--- a/CHANGES
+++ b/CHANGES
@@ -75,6 +75,7 @@ Bugs fixed
 * #8917: autodoc: Raises a warning if function has wrong __globals__ value
 * #8415: autodoc: a TypeVar imported from other module is not resolved (in
   Python 3.7 or above)
+* #8905: html: html_add_permalinks=None and html_add_permalinks="" are ignored
 * #8380: html search: Paragraphs in search results are not identified as ``<p>``
 * #8915: html theme: The translation of sphinx_rtd_theme does not work
 * #8342: Emit a warning if a unknown domain is given for directive or role (ex.

From 2c6c1469eedbc3f975e308cda47d746e5087938e Mon Sep 17 00:00:00 2001
From: Joaquin Anton <janton@nvidia.com>
Date: Mon, 1 Mar 2021 10:32:31 +0100
Subject: [PATCH 157/305] Apply code review suggestions

Signed-off-by: Joaquin Anton <janton@nvidia.com>
---
 sphinx/environment/collectors/title.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/sphinx/environment/collectors/title.py b/sphinx/environment/collectors/title.py
index 00832ae4399..28e967427d0 100644
--- a/sphinx/environment/collectors/title.py
+++ b/sphinx/environment/collectors/title.py
@@ -39,10 +39,9 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
         longtitlenode = titlenode
         # explicit title set with title directive; use this only for
         # the <title> tag in HTML output
-        explicit_title = nodes.Text(doctree['title']) if 'title' in doctree else None
-        if explicit_title:
+        if 'title' in doctree:
             longtitlenode = nodes.title()
-            longtitlenode += explicit_title
+            longtitlenode += nodes.Text(doctree['title'])
         # look for first section title and use that as the title
         for node in doctree.traverse(nodes.section):
             visitor = SphinxContentsFilter(doctree)
@@ -51,7 +50,7 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
             break
         else:
             # document has no title
-            titlenode += explicit_title or nodes.Text('<no title>')
+            titlenode += nodes.Text(doctree.get('title', '<no title>'))
         app.env.titles[app.env.docname] = titlenode
         app.env.longtitles[app.env.docname] = longtitlenode
 

From 61c9c7fc58bf0c21207908bde6440cd315456818 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 2 Mar 2021 21:17:12 +0900
Subject: [PATCH 158/305] Deprecate SphinxComponentRegistry.get_source_input()

The source_input system was deprecated at v2.0.  So no client uses it
longer now.  Therefore this deprecate the getter interface and its
usage.
---
 CHANGES                   |  2 ++
 doc/extdev/deprecated.rst | 10 ++++++++++
 sphinx/io.py              | 29 +++++++----------------------
 sphinx/registry.py        |  5 +++++
 4 files changed, 24 insertions(+), 22 deletions(-)

diff --git a/CHANGES b/CHANGES
index 428b6951f81..38dbc575b03 100644
--- a/CHANGES
+++ b/CHANGES
@@ -48,6 +48,8 @@ Deprecated
 * ``sphinx.directives.patches.CSVTable``
 * ``sphinx.directives.patches.ListTable``
 * ``sphinx.directives.patches.RSTTable``
+* ``sphinx.registry.SphinxComponentRegistry.get_source_input()``
+* ``sphinx.registry.SphinxComponentRegistry.source_inputs``
 * ``sphinx.transforms.FigureAligner``
 * ``sphinx.util.pycompat.convert_with_2to3()``
 * ``sphinx.util.pycompat.execfile_()``
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index 828a73d0596..10c1dfb22ca 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -47,6 +47,16 @@ The following is a list of deprecated interfaces.
      - 6.0
      - ``docutils.parsers.rst.diretives.tables.RSTTable``
 
+   * - ``sphinx.registry.SphinxComponentRegistry.get_source_input()``
+     - 4.0
+     - 6.0
+     - N/A
+
+   * - ``sphinx.registry.SphinxComponentRegistry.source_inputs``
+     - 4.0
+     - 6.0
+     - N/A
+
    * - ``sphinx.transforms.FigureAligner``
      - 4.0
      - 6.0
diff --git a/sphinx/io.py b/sphinx/io.py
index 96f181184cf..f6ab0e1ef48 100644
--- a/sphinx/io.py
+++ b/sphinx/io.py
@@ -178,27 +178,12 @@ def read_doc(app: "Sphinx", env: BuildEnvironment, filename: str) -> nodes.docum
         #   CommonMarkParser.
         parser.settings_spec = RSTParser.settings_spec
 
-    input_class = app.registry.get_source_input(filetype)
-    if input_class:
-        # Sphinx-1.8 style
-        source = input_class(app, env, source=None, source_path=filename,  # type: ignore
-                             encoding=env.config.source_encoding)
-        pub = Publisher(reader=reader,
-                        parser=parser,
-                        writer=SphinxDummyWriter(),
-                        source_class=SphinxDummySourceClass,  # type: ignore
-                        destination=NullOutput())
-        pub.process_programmatic_settings(None, env.settings, None)
-        pub.set_source(source, filename)
-    else:
-        # Sphinx-2.0 style
-        pub = Publisher(reader=reader,
-                        parser=parser,
-                        writer=SphinxDummyWriter(),
-                        source_class=SphinxFileInput,
-                        destination=NullOutput())
-        pub.process_programmatic_settings(None, env.settings, None)
-        pub.set_source(source_path=filename)
-
+    pub = Publisher(reader=reader,
+                    parser=parser,
+                    writer=SphinxDummyWriter(),
+                    source_class=SphinxFileInput,
+                    destination=NullOutput())
+    pub.process_programmatic_settings(None, env.settings, None)
+    pub.set_source(source_path=filename)
     pub.publish()
     return pub.document
diff --git a/sphinx/registry.py b/sphinx/registry.py
index 168583739d3..cd7a7f4a030 100644
--- a/sphinx/registry.py
+++ b/sphinx/registry.py
@@ -9,6 +9,7 @@
 """
 
 import traceback
+import warnings
 from importlib import import_module
 from types import MethodType
 from typing import TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Tuple, Type, Union
@@ -23,6 +24,7 @@
 
 from sphinx.builders import Builder
 from sphinx.config import Config
+from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.domains import Domain, Index, ObjType
 from sphinx.domains.std import GenericObject, Target
 from sphinx.environment import BuildEnvironment
@@ -285,6 +287,9 @@ def create_source_parser(self, app: "Sphinx", filename: str) -> Parser:
         return parser
 
     def get_source_input(self, filetype: str) -> "Type[Input]":
+        warnings.warn('SphinxComponentRegistry.get_source_input() is deprecated.',
+                      RemovedInSphinx60Warning)
+
         try:
             return self.source_inputs[filetype]
         except KeyError:

From b923165d5ef289ba39bb964201d4a036eb5a5ff6 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 2 Mar 2021 22:27:46 +0900
Subject: [PATCH 159/305] Update CHANGES for PR #8937

---
 CHANGES | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGES b/CHANGES
index 2c51be98f66..812af757fbb 100644
--- a/CHANGES
+++ b/CHANGES
@@ -39,6 +39,7 @@ Incompatible changes
   ``None`` by default instead of ``'default'``
 * #8769: LaTeX refactoring: split sphinx.sty into multiple files and rename
   some auxiliary files created in ``latex`` build output repertory
+* #8937: Use explicit title instead of <no title>
 
 Deprecated
 ----------

From 4052cbc9b157abd26fae7c4d0aedd233a21b98d5 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Tue, 2 Mar 2021 20:22:22 +0100
Subject: [PATCH 160/305] C++, support spaceship operator

Fixes sphinx-doc/sphinx#8942
---
 CHANGES                  | 1 +
 sphinx/domains/cpp.py    | 6 ++++--
 tests/test_domain_cpp.py | 6 +++++-
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 812af757fbb..4d22cfcaa63 100644
--- a/CHANGES
+++ b/CHANGES
@@ -69,6 +69,7 @@ Features added
 * #7830: Add debug logs for change detection of sources and templates
 * #8201: Emit a warning if toctree contains duplicated entries
 * #8326: ``master_doc`` is now renamed to :confval:`root_doc`
+* #8942: C++, add support for the C++20 spaceship operator, ``<=>``.
 
 Bugs fixed
 ----------
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index cf93681ae86..04b471b1704 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -306,6 +306,7 @@
     |   \+\+ | --
     |   ->\*? | \,
     |   (<<|>>)=? | && | \|\|
+    |   <=>
     |   [!<>=/*%+|&^~-]=?
     |   (\b(and|and_eq|bitand|bitor|compl|not|not_eq|or|or_eq|xor|xor_eq)\b)
 ''')
@@ -494,6 +495,7 @@
     '>': 'gt',
     '<=': 'le',
     '>=': 'ge',
+    '<=>': 'ss',
     '!': 'nt', 'not': 'nt',
     '&&': 'aa', 'and': 'aa',
     '||': 'oo', 'or': 'oo',
@@ -528,7 +530,7 @@
     ['^', 'xor'],
     ['&', 'bitand'],
     ['==', '!=', 'not_eq'],
-    ['<=', '>=', '<', '>'],
+    ['<=>', '<=', '>=', '<', '>'],
     ['<<', '>>'],
     ['+', '-'],
     ['*', '/', '%'],
@@ -5309,7 +5311,7 @@ def _parse_logical_or_expression(self, inTemplate: bool) -> ASTExpression:
         # exclusive-or   = and              ^
         # and            = equality         &
         # equality       = relational       ==, !=
-        # relational     = shift            <, >, <=, >=
+        # relational     = shift            <, >, <=, >=, <=>
         # shift          = additive         <<, >>
         # additive       = multiplicative   +, -
         # multiplicative = pm               *, /, %
diff --git a/tests/test_domain_cpp.py b/tests/test_domain_cpp.py
index da05c126190..4c7d63a2608 100644
--- a/tests/test_domain_cpp.py
+++ b/tests/test_domain_cpp.py
@@ -289,13 +289,16 @@ class Config:
     exprCheck('5 == 42', 'eqL5EL42E')
     exprCheck('5 != 42', 'neL5EL42E')
     exprCheck('5 not_eq 42', 'neL5EL42E')
-    # ['<=', '>=', '<', '>']
+    # ['<=', '>=', '<', '>', '<=>']
     exprCheck('5 <= 42', 'leL5EL42E')
     exprCheck('A <= 42', 'le1AL42E')
     exprCheck('5 >= 42', 'geL5EL42E')
     exprCheck('5 < 42', 'ltL5EL42E')
     exprCheck('A < 42', 'lt1AL42E')
     exprCheck('5 > 42', 'gtL5EL42E')
+    exprCheck('A > 42', 'gt1AL42E')
+    exprCheck('5 <=> 42', 'ssL5EL42E')
+    exprCheck('A <=> 42', 'ss1AL42E')
     # ['<<', '>>']
     exprCheck('5 << 42', 'lsL5EL42E')
     exprCheck('A << 42', 'ls1AL42E')
@@ -661,6 +664,7 @@ def test_operators():
     check('function', 'void operator>()', {1: "gt-operator", 2: "gtv"})
     check('function', 'void operator<=()', {1: "lte-operator", 2: "lev"})
     check('function', 'void operator>=()', {1: "gte-operator", 2: "gev"})
+    check('function', 'void operator<=>()', {1: None, 2: "ssv"})
     check('function', 'void operator!()', {1: "not-operator", 2: "ntv"})
     check('function', 'void operator not()', {2: "ntv"})
     check('function', 'void operator&&()', {1: "sand-operator", 2: "aav"})

From cf85d3afd1d26394df42b148d2b2a5c462f50947 Mon Sep 17 00:00:00 2001
From: Ask Hjorth Larsen <asklarsen@gmail.com>
Date: Wed, 3 Mar 2021 19:52:49 +0100
Subject: [PATCH 161/305] format translatable strings in one go.  This enables
 translation tools like msgfmt to verify that an incorrect translation cannot
 crash sphinx-build.  This will fix current crashes for Hungarian and Greek
 (Spanish was fixed in #8941)

---
 sphinx/transforms/post_transforms/__init__.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/sphinx/transforms/post_transforms/__init__.py b/sphinx/transforms/post_transforms/__init__.py
index 1c424050ab8..00a0f9c2d24 100644
--- a/sphinx/transforms/post_transforms/__init__.py
+++ b/sphinx/transforms/post_transforms/__init__.py
@@ -168,14 +168,13 @@ def warn_missing_reference(self, refdoc: str, typ: str, target: str,
         if self.app.emit_firstresult('warn-missing-reference', domain, node):
             return
         elif domain and typ in domain.dangling_warnings:
-            msg = domain.dangling_warnings[typ]
+            msg = domain.dangling_warnings[typ] % {'target': target}
         elif node.get('refdomain', 'std') not in ('', 'std'):
-            msg = (__('%s:%s reference target not found: %%(target)s') %
-                   (node['refdomain'], typ))
+            msg = (__('%s:%s reference target not found: %s') %
+                   (node['refdomain'], typ, target))
         else:
-            msg = __('%r reference target not found: %%(target)s') % typ
-        logger.warning(msg % {'target': target},
-                       location=node, type='ref', subtype=typ)
+            msg = __('%r reference target not found: %s') % (typ, target)
+        logger.warning(msg, location=node, type='ref', subtype=typ)
 
 
 class OnlyNodeTransform(SphinxPostTransform):

From 17599133f7fdd5ba185b99ba48faa617e01986fd Mon Sep 17 00:00:00 2001
From: Eric Larson <larson.eric.d@gmail.com>
Date: Wed, 3 Mar 2021 16:28:33 -0500
Subject: [PATCH 162/305] BUG: Fix rebuild regression

---
 sphinx/builders/html/__init__.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 01de0b94fd4..115f7353816 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1248,7 +1248,13 @@ def validate_html_favicon(app: Sphinx, config: Config) -> None:
         config.html_favicon = None  # type: ignore
 
 
-UNSET = object()
+class _stable_repr_object():
+
+    def __repr__(self):
+        return '<object>'
+
+
+UNSET = _stable_repr_object()
 
 
 def migrate_html_add_permalinks(app: Sphinx, config: Config) -> None:

From 72e231d0e6431f3709e74f0f9355a9798ebb0991 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Thu, 4 Mar 2021 21:28:18 +0100
Subject: [PATCH 163/305] C and C++, fix nested paramter lists

---
 CHANGES                  |  2 ++
 sphinx/domains/c.py      | 25 +++++++++++++++++--------
 sphinx/domains/cpp.py    | 24 ++++++++++++++++--------
 tests/test_domain_c.py   |  3 +++
 tests/test_domain_cpp.py |  3 +++
 5 files changed, 41 insertions(+), 16 deletions(-)

diff --git a/CHANGES b/CHANGES
index 4d22cfcaa63..a362d9037ac 100644
--- a/CHANGES
+++ b/CHANGES
@@ -93,6 +93,8 @@ Bugs fixed
 * C, properly reject function declarations when a keyword is used
   as parameter name.
 * #8933: viewcode: Failed to create back-links on parallel build
+* #8960: C and C++, fix rendering of (member) function pointer types in
+  function parameter lists.
 
 Testing
 --------
diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index 79d4e145c6b..0fecbad6d41 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -669,15 +669,24 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        paramlist = addnodes.desc_parameterlist()
-        for arg in self.args:
-            param = addnodes.desc_parameter('', '', noemph=True)
-            if mode == 'lastIsName':  # i.e., outer-function params
+        # only use the desc_parameterlist for the outer list, not for inner lists
+        if mode == 'lastIsName':
+            paramlist = addnodes.desc_parameterlist()
+            for arg in self.args:
+                param = addnodes.desc_parameter('', '', noemph=True)
                 arg.describe_signature(param, 'param', env, symbol=symbol)
-            else:
-                arg.describe_signature(param, 'markType', env, symbol=symbol)
-            paramlist += param
-        signode += paramlist
+                paramlist += param
+            signode += paramlist
+        else:
+            signode += nodes.Text('(', '(')
+            first = True
+            for arg in self.args:
+                if not first:
+                    signode += nodes.Text(', ', ', ')
+                first = False
+                arg.describe_signature(signode, 'markType', env, symbol=symbol)
+            signode += nodes.Text(')', ')')
+
         for attr in self.attrs:
             signode += nodes.Text(' ')
             attr.describe_signature(signode)
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index 04b471b1704..3bd764de573 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -1967,15 +1967,23 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        paramlist = addnodes.desc_parameterlist()
-        for arg in self.args:
-            param = addnodes.desc_parameter('', '', noemph=True)
-            if mode == 'lastIsName':  # i.e., outer-function params
+        # only use the desc_parameterlist for the outer list, not for inner lists
+        if mode == 'lastIsName':
+            paramlist = addnodes.desc_parameterlist()
+            for arg in self.args:
+                param = addnodes.desc_parameter('', '', noemph=True)
                 arg.describe_signature(param, 'param', env, symbol=symbol)
-            else:
-                arg.describe_signature(param, 'markType', env, symbol=symbol)
-            paramlist += param
-        signode += paramlist
+                paramlist += param
+            signode += paramlist
+        else:
+            signode += nodes.Text('(', '(')
+            first = True
+            for arg in self.args:
+                if not first:
+                    signode += nodes.Text(', ', ', ')
+                first = False
+                arg.describe_signature(signode, 'markType', env, symbol=symbol)
+            signode += nodes.Text(')', ')')
 
         def _add_anno(signode: TextElement, text: str) -> None:
             signode += nodes.Text(' ')
diff --git a/tests/test_domain_c.py b/tests/test_domain_c.py
index 38e83a77eaf..ef4858786de 100644
--- a/tests/test_domain_c.py
+++ b/tests/test_domain_c.py
@@ -420,6 +420,9 @@ def test_function_definitions():
     with pytest.raises(DefinitionError):
         parse('function', 'void f(int for)')
 
+    # from #8960
+    check('function', 'void f(void (*p)(int, double), int i)', {1: 'f'})
+
 
 def test_nested_name():
     check('struct', '{key}.A', {1: "A"})
diff --git a/tests/test_domain_cpp.py b/tests/test_domain_cpp.py
index 4c7d63a2608..edd5ea5bc57 100644
--- a/tests/test_domain_cpp.py
+++ b/tests/test_domain_cpp.py
@@ -619,6 +619,9 @@ def test_function_definitions():
     # from breathe#441
     check('function', 'auto MakeThingy() -> Thingy*', {1: 'MakeThingy', 2: '10MakeThingyv'})
 
+    # from #8960
+    check('function', 'void f(void (*p)(int, double), int i)', {2: '1fPFvidEi'})
+
 
 def test_operators():
     check('function', 'void operator new()', {1: "new-operator", 2: "nwv"})

From ff788495571c0d80a3a8b510e0e319b3d1e87cd6 Mon Sep 17 00:00:00 2001
From: igo95862 <igo95862@yandex.ru>
Date: Fri, 5 Mar 2021 14:19:22 +0300
Subject: [PATCH 164/305] Fix py.typed file not being included in source
 archive

---
 MANIFEST.in | 1 +
 1 file changed, 1 insertion(+)

diff --git a/MANIFEST.in b/MANIFEST.in
index 1114ca19f8f..7c2f852a81c 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -15,6 +15,7 @@ include sphinx-quickstart.py
 include sphinx-apidoc.py
 include tox.ini
 include sphinx/locale/.tx/config
+include sphinx/py.typed
 
 recursive-include sphinx/templates *
 recursive-include sphinx/texinputs *

From e1130972b2ad2e57db4ebe0a6fa83e1cb76aa6a3 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 15 Nov 2020 19:12:46 +0900
Subject: [PATCH 165/305] Add pending_xref_condition node

To choose appropriate content for pending_xref node on resolving,
this introduces a new custom node `pending_xref_condition`.  It only
has a condition for the filtering and contents of the reference.
---
 CHANGES              |  2 ++
 doc/extdev/nodes.rst |  1 +
 sphinx/addnodes.py   | 48 ++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 51 insertions(+)

diff --git a/CHANGES b/CHANGES
index 4d22cfcaa63..ddc43367878 100644
--- a/CHANGES
+++ b/CHANGES
@@ -70,6 +70,8 @@ Features added
 * #8201: Emit a warning if toctree contains duplicated entries
 * #8326: ``master_doc`` is now renamed to :confval:`root_doc`
 * #8942: C++, add support for the C++20 spaceship operator, ``<=>``.
+* #7199: A new node, ``sphinx.addnodes.pending_xref_condition`` has been added.
+  It can be used to choose appropriate content of the reference by conditions.
 
 Bugs fixed
 ----------
diff --git a/doc/extdev/nodes.rst b/doc/extdev/nodes.rst
index e38393a78c5..3976de4c709 100644
--- a/doc/extdev/nodes.rst
+++ b/doc/extdev/nodes.rst
@@ -37,6 +37,7 @@ New inline nodes
 
 .. autoclass:: index
 .. autoclass:: pending_xref
+.. autoclass:: pending_xref_condition
 .. autoclass:: literal_emphasis
 .. autoclass:: download_reference
 
diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 9bcfaaabfce..9ec4898c161 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -338,6 +338,54 @@ class pending_xref(nodes.Inline, nodes.Element):
     """
 
 
+class pending_xref_condition(nodes.Inline, nodes.TextElement):
+    """Node for cross-references that are used to choose appropriate
+    content of the reference by conditions on the resolving phase.
+
+    When the :py:class:`pending_xref` node contains one or more
+    **pending_xref_condition** nodes, the cross-reference resolver
+    should choose the content of the reference using defined conditions
+    in ``condition`` attribute of each pending_xref_condition nodes::
+
+        <pending_xref refdomain="py" reftarget="io.StringIO ...>
+            <pending_xref_condition condition="resolved">
+                <literal>
+                    StringIO
+            <pending_xref_condition condition="*">
+                <literal>
+                    io.StringIO
+
+    After the processing of cross-reference resolver, one of the content node
+    under pending_xref_condition node is chosen by its condition and to be
+    removed all of pending_xref_condition nodes::
+
+        # When resolved the cross-reference successfully
+        <reference>
+            <literal>
+                StringIO
+
+        # When resolution is failed
+        <reference>
+            <literal>
+                io.StringIO
+
+    .. note:: This node is only allowed to be placed under pending_xref node.
+              It is not allows to place it under other nodes.  In addition,
+              pending_xref node must contain only pending_xref_condition
+              nodes if it contains one or more pending_xref_condition nodes.
+
+    The pending_xref_condition node should have **condition** attribute.
+    Domains can be store their individual conditions into the attribute to
+    filter contents on resolving phase.  As a reserved condition name,
+    ``condition="*"`` is used for the fallback of resolution failure.
+    Additionally, as a recommended condition name, ``condition="resolved"``
+    is used for the representation of resolstion success in the intersphinx
+    module.
+
+    .. versionadded:: 4.0
+    """
+
+
 class number_reference(nodes.reference):
     """Node for number references, similar to pending_xref."""
 

From d99132680d277db8409d17195948ee1d422dca66 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 15 Nov 2020 19:44:39 +0900
Subject: [PATCH 166/305] Filter pending_xref_condition node on failed
 resolution

---
 sphinx/transforms/post_transforms/__init__.py | 23 ++++++++++++++++---
 sphinx/util/nodes.py                          | 10 ++++++++
 2 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/sphinx/transforms/post_transforms/__init__.py b/sphinx/transforms/post_transforms/__init__.py
index f8b01e81f7c..299b681efe0 100644
--- a/sphinx/transforms/post_transforms/__init__.py
+++ b/sphinx/transforms/post_transforms/__init__.py
@@ -22,10 +22,14 @@
 from sphinx.transforms import SphinxTransform
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxTranslator
-from sphinx.util.nodes import process_only_nodes
+from sphinx.util.nodes import find_pending_xref_condition, process_only_nodes
 
 logger = logging.getLogger(__name__)
 
+if False:
+    # For type annotation
+    from docutils.nodes import Node
+
 
 class SphinxPostTransform(SphinxTransform):
     """A base class of post-transforms.
@@ -97,8 +101,21 @@ def run(self, **kwargs: Any) -> None:
                     if newnode is None:
                         self.warn_missing_reference(refdoc, typ, target, node, domain)
             except NoUri:
-                newnode = contnode
-            node.replace_self(newnode or contnode)
+                newnode = None
+
+            if newnode:
+                newnodes = [newnode]  # type: List[Node]
+            else:
+                newnodes = [contnode]
+                if newnode is None and isinstance(node[0], addnodes.pending_xref_condition):
+                    matched = find_pending_xref_condition(node, "*")
+                    if matched:
+                        newnodes = matched.children
+                    else:
+                        logger.warning(__('Could not determine the fallback text for the '
+                                          'cross-reference. Might be a bug.'), location=node)
+
+            node.replace_self(newnodes)
 
     def resolve_anyref(self, refdoc: str, node: pending_xref, contnode: Element) -> Element:
         """Resolve reference generated by the "any" role."""
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index 944fd3ecb0c..22cc9d4c000 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -531,6 +531,16 @@ def make_id(env: "BuildEnvironment", document: nodes.document,
     return node_id
 
 
+def find_pending_xref_condition(node: addnodes.pending_xref, condition: str) -> Element:
+    """Pick matched pending_xref_condition node up from the pending_xref."""
+    for subnode in node:
+        if (isinstance(subnode, addnodes.pending_xref_condition) and
+                subnode.get('condition') == condition):
+            return subnode
+    else:
+        return None
+
+
 def make_refnode(builder: "Builder", fromdocname: str, todocname: str, targetid: str,
                  child: Node, title: str = None) -> nodes.reference:
     """Shortcut to create a reference node."""

From 930a880294dc935a7320d64ecbe219c18e005536 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 15 Nov 2020 23:15:01 +0900
Subject: [PATCH 167/305] Fix #7199: py domain: Add a new confval:
 python_use_unqualified_type_names

Add a new config variable: python_use_unqualified_type_names.  If enabled,
it goes to suppress the module name of the python reference if it can be
resolved.
---
 CHANGES                                       |  2 +
 doc/usage/configuration.rst                   | 11 ++++++
 sphinx/domains/python.py                      | 37 ++++++++++++++++---
 sphinx/util/nodes.py                          |  6 +--
 .../conf.py                                   |  1 +
 .../index.rst                                 |  8 ++++
 tests/test_domain_py.py                       | 19 ++++++++++
 7 files changed, 76 insertions(+), 8 deletions(-)
 create mode 100644 tests/roots/test-domain-py-python_use_unqualified_type_names/conf.py
 create mode 100644 tests/roots/test-domain-py-python_use_unqualified_type_names/index.rst

diff --git a/CHANGES b/CHANGES
index ddc43367878..3dc6bfc9dc4 100644
--- a/CHANGES
+++ b/CHANGES
@@ -60,6 +60,8 @@ Features added
 * #8924: autodoc: Support ``bound`` argument for TypeVar
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined
+* #7199: py domain: Add :confval:`python_use_unqualified_type_names` to suppress
+  the module name of the python reference if it can be resolved (experimental)
 * #7784: i18n: The alt text for image is translated by default (without
   :confval:`gettext_additional_targets` setting)
 * #2018: html: :confval:`html_favicon` and :confval:`html_logo` now accept URL
diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index 23db18fed78..989ce8737ed 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -2714,6 +2714,17 @@ Options for the C++ domain
 
    .. versionadded:: 1.5
 
+Options for the Python domain
+-----------------------------
+
+.. confval:: python_use_unqualified_type_names
+
+   If true, suppress the module name of the python reference if it can be
+   resolved.  The default is ``False``.
+
+   .. versionadded:: 4.0
+
+   .. note:: This configuration is still in experimental
 
 Example of configuration file
 =============================
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 5e430a1d732..40a67f82cc7 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -22,7 +22,7 @@
 from docutils.parsers.rst import directives
 
 from sphinx import addnodes
-from sphinx.addnodes import desc_signature, pending_xref
+from sphinx.addnodes import desc_signature, pending_xref, pending_xref_condition
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
 from sphinx.deprecation import RemovedInSphinx50Warning
@@ -37,7 +37,7 @@
 from sphinx.util.docfields import Field, GroupedField, TypedField
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.inspect import signature_from_str
-from sphinx.util.nodes import make_id, make_refnode
+from sphinx.util.nodes import find_pending_xref_condition, make_id, make_refnode
 from sphinx.util.typing import TextlikeNode
 
 logger = logging.getLogger(__name__)
@@ -92,7 +92,17 @@ def type_to_xref(text: str, env: BuildEnvironment = None) -> addnodes.pending_xr
     else:
         kwargs = {}
 
-    return pending_xref('', nodes.Text(text),
+    if env.config.python_use_unqualified_type_names:
+        # Note: It would be better to use qualname to describe the object to support support
+        # nested classes.  But python domain can't access the real python object because this
+        # module should work not-dynamically.
+        shortname = text.split('.')[-1]
+        contnodes = [pending_xref_condition('', shortname, condition='resolved'),
+                     pending_xref_condition('', text, condition='*')]  # type: List[Node]
+    else:
+        contnodes = [nodes.Text(text)]
+
+    return pending_xref('', *contnodes,
                         refdomain='py', reftype=reftype, reftarget=text, **kwargs)
 
 
@@ -1209,7 +1219,15 @@ def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder
         if obj[2] == 'module':
             return self._make_module_refnode(builder, fromdocname, name, contnode)
         else:
-            return make_refnode(builder, fromdocname, obj[0], obj[1], contnode, name)
+            # determine the content of the reference by conditions
+            content = find_pending_xref_condition(node, 'resolved')
+            if content:
+                children = content.children
+            else:
+                # if not found, use contnode
+                children = [contnode]
+
+            return make_refnode(builder, fromdocname, obj[0], obj[1], children, name)
 
     def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
                          target: str, node: pending_xref, contnode: Element
@@ -1226,9 +1244,17 @@ def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Bui
                                 self._make_module_refnode(builder, fromdocname,
                                                           name, contnode)))
             else:
+                # determine the content of the reference by conditions
+                content = find_pending_xref_condition(node, 'resolved')
+                if content:
+                    children = content.children
+                else:
+                    # if not found, use contnode
+                    children = [contnode]
+
                 results.append(('py:' + self.role_for_objtype(obj[2]),
                                 make_refnode(builder, fromdocname, obj[0], obj[1],
-                                             contnode, name)))
+                                             children, name)))
         return results
 
     def _make_module_refnode(self, builder: Builder, fromdocname: str, name: str,
@@ -1295,6 +1321,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.setup_extension('sphinx.directives')
 
     app.add_domain(PythonDomain)
+    app.add_config_value('python_use_unqualified_type_names', False, 'env')
     app.connect('object-description-transform', filter_meta_fields)
     app.connect('missing-reference', builtin_resolver, priority=900)
 
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index 22cc9d4c000..c7619a836fe 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -10,7 +10,7 @@
 
 import re
 import unicodedata
-from typing import TYPE_CHECKING, Any, Callable, Iterable, List, Set, Tuple, Type, cast
+from typing import TYPE_CHECKING, Any, Callable, Iterable, List, Set, Tuple, Type, Union, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -542,7 +542,7 @@ def find_pending_xref_condition(node: addnodes.pending_xref, condition: str) ->
 
 
 def make_refnode(builder: "Builder", fromdocname: str, todocname: str, targetid: str,
-                 child: Node, title: str = None) -> nodes.reference:
+                 child: Union[Node, List[Node]], title: str = None) -> nodes.reference:
     """Shortcut to create a reference node."""
     node = nodes.reference('', '', internal=True)
     if fromdocname == todocname and targetid:
@@ -555,7 +555,7 @@ def make_refnode(builder: "Builder", fromdocname: str, todocname: str, targetid:
             node['refuri'] = builder.get_relative_uri(fromdocname, todocname)
     if title:
         node['reftitle'] = title
-    node.append(child)
+    node += child
     return node
 
 
diff --git a/tests/roots/test-domain-py-python_use_unqualified_type_names/conf.py b/tests/roots/test-domain-py-python_use_unqualified_type_names/conf.py
new file mode 100644
index 00000000000..c81bfe4c74d
--- /dev/null
+++ b/tests/roots/test-domain-py-python_use_unqualified_type_names/conf.py
@@ -0,0 +1 @@
+python_use_unqualified_type_names = True
diff --git a/tests/roots/test-domain-py-python_use_unqualified_type_names/index.rst b/tests/roots/test-domain-py-python_use_unqualified_type_names/index.rst
new file mode 100644
index 00000000000..599206d8c7d
--- /dev/null
+++ b/tests/roots/test-domain-py-python_use_unqualified_type_names/index.rst
@@ -0,0 +1,8 @@
+domain-py-smart_reference
+=========================
+
+.. py:class:: Name
+   :module: foo
+
+
+.. py:function:: hello(name: foo.Name, age: foo.Age)
diff --git a/tests/test_domain_py.py b/tests/test_domain_py.py
index 448c2c95424..03e865e8456 100644
--- a/tests/test_domain_py.py
+++ b/tests/test_domain_py.py
@@ -999,6 +999,25 @@ def test_noindexentry(app):
     assert_node(doctree[2], addnodes.index, entries=[])
 
 
+@pytest.mark.sphinx('html', testroot='domain-py-python_use_unqualified_type_names')
+def test_python_python_use_unqualified_type_names(app, status, warning):
+    app.build()
+    content = (app.outdir / 'index.html').read_text()
+    assert ('<span class="n"><a class="reference internal" href="#foo.Name" title="foo.Name">'
+            '<span class="pre">Name</span></a></span>' in content)
+    assert '<span class="n"><span class="pre">foo.Age</span></span>' in content
+
+
+@pytest.mark.sphinx('html', testroot='domain-py-python_use_unqualified_type_names',
+                    confoverrides={'python_use_unqualified_type_names': False})
+def test_python_python_use_unqualified_type_names_disabled(app, status, warning):
+    app.build()
+    content = (app.outdir / 'index.html').read_text()
+    assert ('<span class="n"><a class="reference internal" href="#foo.Name" title="foo.Name">'
+            '<span class="pre">foo.Name</span></a></span>' in content)
+    assert '<span class="n"><span class="pre">foo.Age</span></span>' in content
+
+
 @pytest.mark.sphinx('dummy', testroot='domain-py-xref-warning')
 def test_warn_missing_reference(app, status, warning):
     app.build()

From 7f0b13af6e023382f8bfdaa0916c614a586ff05c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 6 Mar 2021 14:43:13 +0900
Subject: [PATCH 168/305] intersphinx: Support pending_xref_condition

---
 sphinx/ext/intersphinx.py     | 23 ++++++++++++++++++-----
 tests/test_ext_intersphinx.py |  8 ++++++++
 2 files changed, 26 insertions(+), 5 deletions(-)

diff --git a/sphinx/ext/intersphinx.py b/sphinx/ext/intersphinx.py
index 5569ad9deda..a01bcc37ab6 100644
--- a/sphinx/ext/intersphinx.py
+++ b/sphinx/ext/intersphinx.py
@@ -33,10 +33,11 @@
 from urllib.parse import urlsplit, urlunsplit
 
 from docutils import nodes
-from docutils.nodes import Element, TextElement
+from docutils.nodes import TextElement
 from docutils.utils import relative_path
 
 import sphinx
+from sphinx.addnodes import pending_xref
 from sphinx.application import Sphinx
 from sphinx.builders.html import INVENTORY_FILENAME
 from sphinx.config import Config
@@ -44,6 +45,7 @@
 from sphinx.locale import _, __
 from sphinx.util import logging, requests
 from sphinx.util.inventory import InventoryFile
+from sphinx.util.nodes import find_pending_xref_condition
 from sphinx.util.typing import Inventory
 
 logger = logging.getLogger(__name__)
@@ -257,8 +259,8 @@ def load_mappings(app: Sphinx) -> None:
                 inventories.main_inventory.setdefault(type, {}).update(objects)
 
 
-def missing_reference(app: Sphinx, env: BuildEnvironment, node: Element, contnode: TextElement
-                      ) -> nodes.reference:
+def missing_reference(app: Sphinx, env: BuildEnvironment, node: pending_xref,
+                      contnode: TextElement) -> nodes.reference:
     """Attempt to resolve a missing reference via intersphinx references."""
     target = node['reftarget']
     inventories = InventoryAdapter(env)
@@ -284,6 +286,17 @@ def missing_reference(app: Sphinx, env: BuildEnvironment, node: Element, contnod
     if 'py:attribute' in objtypes:
         # Since Sphinx-2.1, properties are stored as py:method
         objtypes.append('py:method')
+
+    # determine the contnode by pending_xref_condition
+    content = find_pending_xref_condition(node, 'resolved')
+    if content:
+        # resolved condition found.
+        contnodes = content.children
+        contnode = content.children[0]  # type: ignore
+    else:
+        # not resolved. Use the given contnode
+        contnodes = [contnode]
+
     to_try = [(inventories.main_inventory, target)]
     if domain:
         full_qualified_name = env.get_domain(domain).get_full_qualified_name(node)
@@ -316,7 +329,7 @@ def missing_reference(app: Sphinx, env: BuildEnvironment, node: Element, contnod
             newnode = nodes.reference('', '', internal=False, refuri=uri, reftitle=reftitle)
             if node.get('refexplicit'):
                 # use whatever title was given
-                newnode.append(contnode)
+                newnode.extend(contnodes)
             elif dispname == '-' or \
                     (domain == 'std' and node['reftype'] == 'keyword'):
                 # use whatever title was given, but strip prefix
@@ -325,7 +338,7 @@ def missing_reference(app: Sphinx, env: BuildEnvironment, node: Element, contnod
                     newnode.append(contnode.__class__(title[len(in_set) + 1:],
                                                       title[len(in_set) + 1:]))
                 else:
-                    newnode.append(contnode)
+                    newnode.extend(contnodes)
             else:
                 # else use the given display name (used for :ref:)
                 newnode.append(contnode.__class__(dispname, dispname))
diff --git a/tests/test_ext_intersphinx.py b/tests/test_ext_intersphinx.py
index a876775257b..523ed2acc32 100644
--- a/tests/test_ext_intersphinx.py
+++ b/tests/test_ext_intersphinx.py
@@ -196,6 +196,14 @@ def test_missing_reference_pydomain(tempdir, app, status, warning):
     rn = missing_reference(app, app.env, node, contnode)
     assert rn.astext() == 'Foo.bar'
 
+    # pending_xref_condition="resolved"
+    node = addnodes.pending_xref('', reftarget='Foo.bar', refdomain='py', reftype='attr')
+    node['py:module'] = 'module1'
+    node += addnodes.pending_xref_condition('', 'Foo.bar', condition='resolved')
+    node += addnodes.pending_xref_condition('', 'module1.Foo.bar', condition='*')
+    rn = missing_reference(app, app.env, node, nodes.Text('dummy-cont-node'))
+    assert rn.astext() == 'Foo.bar'
+
 
 def test_missing_reference_stddomain(tempdir, app, status, warning):
     inv_file = tempdir / 'inventory'

From 1ea11b1e489b50132b219ec2ee0fe570e49af638 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 28 Jan 2021 01:57:46 +0900
Subject: [PATCH 169/305] Fix #759: autodoc: Add
 sphinx.ext.autodoc.preserve_defaults extension

Add a new extension `sphinx.ext.autodoc.preserve_defaults`.

It preserves the default argument values of function signatures in source code
and keep them not evaluated for readability.  This is an experimental
extension and it will be integrated into autodoc core in Sphinx-4.0.
---
 CHANGES                                       |  3 +
 doc/usage/extensions/autodoc.rst              | 10 +++
 sphinx/ext/autodoc/__init__.py                |  1 +
 sphinx/ext/autodoc/preserve_defaults.py       | 88 +++++++++++++++++++
 .../target/preserve_defaults.py               | 19 ++++
 tests/test_ext_autodoc_preserve_defaults.py   | 45 ++++++++++
 6 files changed, 166 insertions(+)
 create mode 100644 sphinx/ext/autodoc/preserve_defaults.py
 create mode 100644 tests/roots/test-ext-autodoc/target/preserve_defaults.py
 create mode 100644 tests/test_ext_autodoc_preserve_defaults.py

diff --git a/CHANGES b/CHANGES
index a2ef4f73ee8..4198e57bb25 100644
--- a/CHANGES
+++ b/CHANGES
@@ -192,6 +192,9 @@ Features added
 * #8775: autodoc: Support type union operator (PEP-604) in Python 3.10 or above
 * #8297: autodoc: Allow to extend :confval:`autodoc_default_options` via
   directive options
+* #759: autodoc: Add a new configuration :confval:`autodoc_preserve_defaults` as
+  an experimental feature.  It preserves the default argument values of
+  functions in source code and keep them not evaluated for readability.
 * #8619: html: kbd role generates customizable HTML tags for compound keys
 * #8634: html: Allow to change the order of JS/CSS via ``priority`` parameter
   for :meth:`Sphinx.add_js_file()` and :meth:`Sphinx.add_css_file()`
diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index f69ac8c5c05..ad58a1eb2b7 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -586,6 +586,16 @@ There are also config values that you can set:
    .. __: https://mypy.readthedocs.io/en/latest/kinds_of_types.html#type-aliases
    .. versionadded:: 3.3
 
+.. confval:: autodoc_preserve_defaults
+
+   If True, the default argument values of functions will be not evaluated on
+   generating document.  It preserves them as is in the source code.
+
+   .. versionadded:: 4.0
+
+      Added as an experimental feature.  This will be integrated into autodoc core
+      in the future.
+
 .. confval:: autodoc_warningiserror
 
    This value controls the behavior of :option:`sphinx-build -W` during
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 8d6781a1a5c..0b570930149 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -2634,6 +2634,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
 
     app.connect('config-inited', migrate_autodoc_member_order, priority=800)
 
+    app.setup_extension('sphinx.ext.autodoc.preserve_defaults')
     app.setup_extension('sphinx.ext.autodoc.type_comment')
     app.setup_extension('sphinx.ext.autodoc.typehints')
 
diff --git a/sphinx/ext/autodoc/preserve_defaults.py b/sphinx/ext/autodoc/preserve_defaults.py
new file mode 100644
index 00000000000..3d859fe8eee
--- /dev/null
+++ b/sphinx/ext/autodoc/preserve_defaults.py
@@ -0,0 +1,88 @@
+"""
+    sphinx.ext.autodoc.preserve_defaults
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Preserve the default argument values of function signatures in source code
+    and keep them not evaluated for readability.
+
+    :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import ast
+import inspect
+from typing import Any, Dict
+
+from sphinx.application import Sphinx
+from sphinx.locale import __
+from sphinx.pycode.ast import parse as ast_parse
+from sphinx.pycode.ast import unparse as ast_unparse
+from sphinx.util import logging
+
+logger = logging.getLogger(__name__)
+
+
+class DefaultValue:
+    def __init__(self, name: str) -> None:
+        self.name = name
+
+    def __repr__(self) -> str:
+        return self.name
+
+
+def get_function_def(obj: Any) -> ast.FunctionDef:
+    """Get FunctionDef object from living object.
+    This tries to parse original code for living object and returns
+    AST node for given *obj*.
+    """
+    try:
+        source = inspect.getsource(obj)
+        if source.startswith((' ', r'\t')):
+            # subject is placed inside class or block.  To read its docstring,
+            # this adds if-block before the declaration.
+            module = ast_parse('if True:\n' + source)
+            return module.body[0].body[0]  # type: ignore
+        else:
+            module = ast_parse(source)
+            return module.body[0]  # type: ignore
+    except (OSError, TypeError):  # failed to load source code
+        return None
+
+
+def update_defvalue(app: Sphinx, obj: Any, bound_method: bool) -> None:
+    """Update defvalue info of *obj* using type_comments."""
+    if not app.config.autodoc_preserve_defaults:
+        return
+
+    try:
+        function = get_function_def(obj)
+        if function.args.defaults or function.args.kw_defaults:
+            sig = inspect.signature(obj)
+            defaults = list(function.args.defaults)
+            kw_defaults = list(function.args.kw_defaults)
+            parameters = list(sig.parameters.values())
+            for i, param in enumerate(parameters):
+                if param.default is not param.empty:
+                    if param.kind in (param.POSITIONAL_ONLY, param.POSITIONAL_OR_KEYWORD):
+                        value = DefaultValue(ast_unparse(defaults.pop(0)))  # type: ignore
+                        parameters[i] = param.replace(default=value)
+                    else:
+                        value = DefaultValue(ast_unparse(kw_defaults.pop(0)))  # type: ignore
+                        parameters[i] = param.replace(default=value)
+            sig = sig.replace(parameters=parameters)
+            obj.__signature__ = sig
+    except (AttributeError, TypeError):
+        # failed to update signature (ex. built-in or extension types)
+        pass
+    except NotImplementedError as exc:  # failed to ast.unparse()
+        logger.warning(__("Failed to parse a default argument value for %r: %s"), obj, exc)
+
+
+def setup(app: Sphinx) -> Dict[str, Any]:
+    app.add_config_value('autodoc_preserve_defaults', False, True)
+    app.connect('autodoc-before-process-signature', update_defvalue)
+
+    return {
+        'version': '1.0',
+        'parallel_read_safe': True
+    }
diff --git a/tests/roots/test-ext-autodoc/target/preserve_defaults.py b/tests/roots/test-ext-autodoc/target/preserve_defaults.py
new file mode 100644
index 00000000000..c927fa03521
--- /dev/null
+++ b/tests/roots/test-ext-autodoc/target/preserve_defaults.py
@@ -0,0 +1,19 @@
+from datetime import datetime
+from typing import Any
+
+CONSTANT = 'foo'
+SENTINEL = object()
+
+
+def foo(name: str = CONSTANT,
+        sentinal: Any = SENTINEL,
+        now: datetime = datetime.now()) -> None:
+    """docstring"""
+
+
+class Class:
+    """docstring"""
+
+    def meth(self, name: str = CONSTANT, sentinal: Any = SENTINEL,
+             now: datetime = datetime.now()) -> None:
+        """docstring"""
diff --git a/tests/test_ext_autodoc_preserve_defaults.py b/tests/test_ext_autodoc_preserve_defaults.py
new file mode 100644
index 00000000000..f9833c29171
--- /dev/null
+++ b/tests/test_ext_autodoc_preserve_defaults.py
@@ -0,0 +1,45 @@
+"""
+    test_ext_autodoc_preserve_defaults
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Test the autodoc extension.
+
+    :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import pytest
+
+from .test_ext_autodoc import do_autodoc
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc',
+                    confoverrides={'autodoc_preserve_defaults': True})
+def test_preserve_defaults(app):
+    options = {"members": None}
+    actual = do_autodoc(app, 'module', 'target.preserve_defaults', options)
+    assert list(actual) == [
+        '',
+        '.. py:module:: target.preserve_defaults',
+        '',
+        '',
+        '.. py:class:: Class()',
+        '   :module: target.preserve_defaults',
+        '',
+        '   docstring',
+        '',
+        '',
+        '   .. py:method:: Class.meth(name: str = CONSTANT, sentinal: Any = SENTINEL, '
+        'now: datetime.datetime = datetime.now()) -> None',
+        '      :module: target.preserve_defaults',
+        '',
+        '      docstring',
+        '',
+        '',
+        '.. py:function:: foo(name: str = CONSTANT, sentinal: Any = SENTINEL, now: '
+        'datetime.datetime = datetime.now()) -> None',
+        '   :module: target.preserve_defaults',
+        '',
+        '   docstring',
+        '',
+    ]

From f37e679fd134feb9deeeb1e9d57536faa8156958 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 6 Mar 2021 18:57:18 +0900
Subject: [PATCH 170/305] doc: Update document for autodoc :members: option

---
 doc/usage/extensions/autodoc.rst | 34 +++++++++++++++++++++-----------
 1 file changed, 22 insertions(+), 12 deletions(-)

diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index f69ac8c5c05..b162683b72b 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -89,33 +89,43 @@ inserting them into the page source under a suitable :rst:dir:`py:module`,
 
             Boil the noodle *time* minutes.
 
-   **Options and advanced usage**
+   .. rubric:: Options
+
+   .. rst:directive:option:: members
+      :type: no value or comma separated list
+
+      If set, autodoc will generate document for the members of the target
+      module, class or exception.
 
-   * If you want to automatically document members, there's a ``members``
-     option::
+      For example::
 
         .. automodule:: noodle
            :members:
 
-     will document all module members (recursively), and ::
+      will document all module members (recursively), and ::
 
         .. autoclass:: Noodle
            :members:
 
-     will document all non-private member functions and properties (that is,
-     those whose name doesn't start with ``_``).
+      will document all class member methods and properties.
 
-     For modules, ``__all__`` will be respected when looking for members unless
-     you give the ``ignore-module-all`` flag option.  Without
-     ``ignore-module-all``, the order of the members will also be the order in
-     ``__all__``.
+      By default, autodoc will not generate document for the members that are
+      private, not having docstrings, inherited from super class, or special
+      members.
 
-     You can also give an explicit list of members; only these will then be
-     documented::
+      For modules, ``__all__`` will be respected when looking for members unless
+      you give the ``ignore-module-all`` flag option.  Without
+      ``ignore-module-all``, the order of the members will also be the order in
+      ``__all__``.
+
+      You can also give an explicit list of members; only these will then be
+      documented::
 
         .. autoclass:: Noodle
            :members: eat, slurp
 
+   **Options and advanced usage**
+
    * If you want to make the ``members`` option (or other options described
      below) the default, see :confval:`autodoc_default_options`.
 

From 009fd4c396e949c7ff2568dc02855763df3a078a Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 6 Mar 2021 19:08:23 +0900
Subject: [PATCH 171/305] doc: Update document for autodoc :undoc-members:
 option

---
 doc/usage/extensions/autodoc.rst | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index b162683b72b..c7a553c12f5 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -124,6 +124,16 @@ inserting them into the page source under a suitable :rst:dir:`py:module`,
         .. autoclass:: Noodle
            :members: eat, slurp
 
+   .. rst:directive:option:: undoc-members
+      :type: no value
+
+      If set, autodoc will also generate document for the members not having
+      docstrings::
+
+        .. automodule:: noodle
+           :members:
+           :undoc-members:
+
    **Options and advanced usage**
 
    * If you want to make the ``members`` option (or other options described
@@ -149,13 +159,6 @@ inserting them into the page source under a suitable :rst:dir:`py:module`,
      .. versionchanged:: 3.5
         The default options can be overridden or extended temporarily.
 
-   * Members without docstrings will be left out, unless you give the
-     ``undoc-members`` flag option::
-
-        .. automodule:: noodle
-           :members:
-           :undoc-members:
-
    * "Private" members (that is, those named like ``_private`` or ``__private``)
      will be included if the ``private-members`` flag option is given::
 

From 8411b9a536ec0006d8f0faae05947ad78bf4d2a9 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 6 Mar 2021 19:10:16 +0900
Subject: [PATCH 172/305] doc: Update document for autodoc :private-members:
 option

---
 doc/usage/extensions/autodoc.rst | 39 +++++++++++++++++---------------
 1 file changed, 21 insertions(+), 18 deletions(-)

diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index c7a553c12f5..0712b1ca0e1 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -134,6 +134,27 @@ inserting them into the page source under a suitable :rst:dir:`py:module`,
            :members:
            :undoc-members:
 
+   .. rst:directive:option:: private-members
+      :type: no value or comma separated list
+
+      If set, autodoc will also generate document for the private members
+      (that is, those named like ``_private`` or ``__private``)::
+
+        .. automodule:: noodle
+           :members:
+           :private-members:
+
+      It can also take an explicit list of member names to be documented as
+      arguments::
+
+        .. automodule:: noodle
+           :members:
+           :private-members: _spicy, _garlickly
+
+      .. versionadded:: 1.1
+      .. versionchanged:: 3.2
+         The option can now take arguments.
+
    **Options and advanced usage**
 
    * If you want to make the ``members`` option (or other options described
@@ -159,24 +180,6 @@ inserting them into the page source under a suitable :rst:dir:`py:module`,
      .. versionchanged:: 3.5
         The default options can be overridden or extended temporarily.
 
-   * "Private" members (that is, those named like ``_private`` or ``__private``)
-     will be included if the ``private-members`` flag option is given::
-
-        .. automodule:: noodle
-           :members:
-           :private-members:
-
-     It can also take an explicit list of member names to be documented as
-     arguments::
-
-        .. automodule:: noodle
-           :members:
-           :private-members: _spicy, _garlickly
-
-     .. versionadded:: 1.1
-     .. versionchanged:: 3.2
-        The option can now take arguments.
-
    * autodoc considers a member private if its docstring contains
      ``:meta private:`` in its :ref:`info-field-lists`.
      For example:

From 697fdea61287eb5c5faf3608d5c72f417a91816c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 6 Mar 2021 19:12:10 +0900
Subject: [PATCH 173/305] doc: Update document for autodoc :special-members:
 option

---
 doc/usage/extensions/autodoc.rst | 37 +++++++++++++++++++-------------
 1 file changed, 22 insertions(+), 15 deletions(-)

diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index 0712b1ca0e1..59022cc8029 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -155,6 +155,28 @@ inserting them into the page source under a suitable :rst:dir:`py:module`,
       .. versionchanged:: 3.2
          The option can now take arguments.
 
+   .. rst:directive:option:: special-members
+      :type: no value or comma separated list
+
+      If set, autodoc will also generate document for the special members
+      (that is, those named like ``__special__``)::
+
+        .. autoclass:: my.Class
+           :members:
+           :special-members:
+
+      It can also take an explicit list of member names to be documented as
+      arguments::
+
+        .. autoclass:: my.Class
+           :members:
+           :special-members: __init__, __name__
+
+     .. versionadded:: 1.1
+
+     .. versionchanged:: 1.2
+        The option can now take arguments
+
    **Options and advanced usage**
 
    * If you want to make the ``members`` option (or other options described
@@ -219,21 +241,6 @@ inserting them into the page source under a suitable :rst:dir:`py:module`,
 
      .. versionadded:: 3.5
 
-   * Python "special" members (that is, those named like ``__special__``) will
-     be included if the ``special-members`` flag option is given::
-
-        .. autoclass:: my.Class
-           :members:
-           :private-members:
-           :special-members:
-
-     would document both "private" and "special" members of the class.
-
-     .. versionadded:: 1.1
-
-     .. versionchanged:: 1.2
-        The option can now take arguments, i.e. the special members to document.
-
    * For classes and exceptions, members inherited from base classes will be
      left out when documenting all members, unless you give the
      ``inherited-members`` option, in addition to ``members``::

From 0dcdbdc230edf6412445c2856df15b7037f333d3 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 6 Mar 2021 21:19:26 +0900
Subject: [PATCH 174/305] doc: Fix indentation

---
 doc/usage/extensions/autodoc.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index 2f9049dc011..034c86e1132 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -172,10 +172,10 @@ inserting them into the page source under a suitable :rst:dir:`py:module`,
            :members:
            :special-members: __init__, __name__
 
-     .. versionadded:: 1.1
+      .. versionadded:: 1.1
 
-     .. versionchanged:: 1.2
-        The option can now take arguments
+      .. versionchanged:: 1.2
+         The option can now take arguments
 
    **Options and advanced usage**
 

From af98b9e14f8cd67bcf7894befa14fc6892898a70 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 7 Mar 2021 00:38:39 +0900
Subject: [PATCH 175/305] Fix wrong directive name in warning messages

---
 sphinx/directives/patches.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/sphinx/directives/patches.py b/sphinx/directives/patches.py
index 5baa0994c0d..3cfad5a3f36 100644
--- a/sphinx/directives/patches.py
+++ b/sphinx/directives/patches.py
@@ -92,7 +92,7 @@ class CSVTable(tables.CSVTable):
     Only for docutils-0.13 or older version."""
 
     def run(self) -> List[Node]:
-        warnings.warn('RSTTable is deprecated.',
+        warnings.warn('CSVTable is deprecated.',
                       RemovedInSphinx60Warning)
         return super().run()
 
@@ -110,7 +110,7 @@ class ListTable(tables.ListTable):
     Only for docutils-0.13 or older version."""
 
     def run(self) -> List[Node]:
-        warnings.warn('RSTTable is deprecated.',
+        warnings.warn('ListTable is deprecated.',
                       RemovedInSphinx60Warning)
         return super().run()
 

From 2638e9aecc87460df82e3dd801d423e5aa779f05 Mon Sep 17 00:00:00 2001
From: Naveen M K <naveen@syrusdark.website>
Date: Sun, 7 Mar 2021 00:13:40 +0530
Subject: [PATCH 176/305] Sphinx is available on Chocolatey

---
 doc/usage/installation.rst | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/doc/usage/installation.rst b/doc/usage/installation.rst
index 46ef6a51ecb..ce26e961d24 100644
--- a/doc/usage/installation.rst
+++ b/doc/usage/installation.rst
@@ -107,7 +107,29 @@ Anaconda
 Windows
 -------
 
-.. todo:: Could we start packaging this?
+Sphinx can be install using `Chocolatey`__ or :ref:`installed manually <windows-other-method>`.
+
+__ https://chocolatey.org/
+
+Chocolatey
+~~~~~~~~~~
+
+::
+
+   $ choco install sphinx
+   
+You would need to `install Chocolatey
+<https://chocolatey.org/install/>`_.
+before running this.
+
+For more information, refer to the `chocolatey page`__.
+
+__ https://chocolatey.org/packages/sphinx/
+
+.. _windows-other-method:
+
+Other Methods
+~~~~~~~~~~~~~
 
 Most Windows users do not have Python installed by default, so we begin with
 the installation of Python itself.  To check if you already have Python

From 1b425230e3430d427bd5b9a817f271c24b75ee7c Mon Sep 17 00:00:00 2001
From: Naveen M K <naveen@syrusdark.website>
Date: Sun, 7 Mar 2021 00:21:41 +0530
Subject: [PATCH 177/305] lint

---
 doc/usage/installation.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/doc/usage/installation.rst b/doc/usage/installation.rst
index ce26e961d24..69fed31ab2c 100644
--- a/doc/usage/installation.rst
+++ b/doc/usage/installation.rst
@@ -107,7 +107,8 @@ Anaconda
 Windows
 -------
 
-Sphinx can be install using `Chocolatey`__ or :ref:`installed manually <windows-other-method>`.
+Sphinx can be install using `Chocolatey`__ or
+:ref:`installed manually <windows-other-method>`.
 
 __ https://chocolatey.org/
 
@@ -119,7 +120,7 @@ Chocolatey
    $ choco install sphinx
    
 You would need to `install Chocolatey
-<https://chocolatey.org/install/>`_.
+<https://chocolatey.org/install/>`_
 before running this.
 
 For more information, refer to the `chocolatey page`__.

From fb4220d0a2b7fe143118767ff577face6c72bebc Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 7 Mar 2021 01:59:48 +0900
Subject: [PATCH 178/305] Close #8487: csv-table now considers abspath as
 relpath from srcdir

To make directives' behavior consistent, the :file: option for
csv-table directive now recognizes an absolute path as a relative
path from source directory.
---
 CHANGES                                       |  2 +
 doc/extdev/deprecated.rst                     |  5 ---
 sphinx/directives/patches.py                  | 37 +++++++++++++------
 tests/roots/test-directive-csv-table/conf.py  |  0
 .../test-directive-csv-table/example.csv      |  1 +
 .../subdir/example.csv                        |  1 +
 tests/test_directive_patch.py                 | 32 ++++++++++++++++
 7 files changed, 61 insertions(+), 17 deletions(-)
 create mode 100644 tests/roots/test-directive-csv-table/conf.py
 create mode 100644 tests/roots/test-directive-csv-table/example.csv
 create mode 100644 tests/roots/test-directive-csv-table/subdir/example.csv

diff --git a/CHANGES b/CHANGES
index c75929ca6a3..a183eba66b1 100644
--- a/CHANGES
+++ b/CHANGES
@@ -40,6 +40,8 @@ Incompatible changes
 * #8769: LaTeX refactoring: split sphinx.sty into multiple files and rename
   some auxiliary files created in ``latex`` build output repertory
 * #8937: Use explicit title instead of <no title>
+* #8487: The :file: option for csv-table directive now recognizes an absolute
+  path as a relative path from source directory
 
 Deprecated
 ----------
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index 10c1dfb22ca..96bc84ff3bc 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -32,11 +32,6 @@ The following is a list of deprecated interfaces.
      - TBD
      - ``logo_url``
 
-   * - ``sphinx.directives.patches.CSVTable``
-     - 4.0
-     - 6.0
-     - ``docutils.parsers.rst.diretives.tables.CSVTable``
-
    * - ``sphinx.directives.patches.ListTable``
      - 4.0
      - 6.0
diff --git a/sphinx/directives/patches.py b/sphinx/directives/patches.py
index 3cfad5a3f36..1c3cfd853bc 100644
--- a/sphinx/directives/patches.py
+++ b/sphinx/directives/patches.py
@@ -6,7 +6,9 @@
     :license: BSD, see LICENSE for details.
 """
 
+import os
 import warnings
+from os import path
 from typing import TYPE_CHECKING, Any, Dict, List, Tuple, cast
 
 from docutils import nodes
@@ -18,13 +20,19 @@
 from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.directives import optional_int
 from sphinx.domains.math import MathDomain
+from sphinx.locale import __
+from sphinx.util import logging
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import set_source_info
+from sphinx.util.osutil import SEP, os_path, relpath
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
 
+logger = logging.getLogger(__name__)
+
+
 class Figure(images.Figure):
     """The figure directive which applies `:name:` option to the figure node
     instead of the image node.
@@ -87,21 +95,25 @@ def make_title(self) -> Tuple[nodes.title, List[system_message]]:
 
 
 class CSVTable(tables.CSVTable):
-    """The csv-table directive which sets source and line information to its caption.
-
-    Only for docutils-0.13 or older version."""
+    """The csv-table directive which searches a CSV file from Sphinx project's source
+    directory when an absolute path is given via :file: option.
+    """
 
     def run(self) -> List[Node]:
-        warnings.warn('CSVTable is deprecated.',
-                      RemovedInSphinx60Warning)
-        return super().run()
+        if 'file' in self.options and self.options['file'].startswith((SEP, os.sep)):
+            env = self.state.document.settings.env
+            filename = self.options['file']
+            if path.exists(filename):
+                logger.warning(__('":file:" option for csv-table directive now recognizes '
+                                  'an absolute path as a relative path from source directory. '
+                                  'Please update your document.'),
+                               location=(env.docname, self.lineno))
+            else:
+                abspath = path.join(env.srcdir, os_path(self.options['file'][1:]))
+                docdir = path.dirname(env.doc2path(env.docname))
+                self.options['file'] = relpath(abspath, docdir)
 
-    def make_title(self) -> Tuple[nodes.title, List[system_message]]:
-        title, message = super().make_title()
-        if title:
-            set_source_info(self, title)
-
-        return title, message
+        return super().run()
 
 
 class ListTable(tables.ListTable):
@@ -224,6 +236,7 @@ def add_target(self, ret: List[Node]) -> None:
 def setup(app: "Sphinx") -> Dict[str, Any]:
     directives.register_directive('figure', Figure)
     directives.register_directive('meta', Meta)
+    directives.register_directive('csv-table', CSVTable)
     directives.register_directive('code', Code)
     directives.register_directive('math', MathDirective)
 
diff --git a/tests/roots/test-directive-csv-table/conf.py b/tests/roots/test-directive-csv-table/conf.py
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/roots/test-directive-csv-table/example.csv b/tests/roots/test-directive-csv-table/example.csv
new file mode 100644
index 00000000000..eb039aa9bfe
--- /dev/null
+++ b/tests/roots/test-directive-csv-table/example.csv
@@ -0,0 +1 @@
+foo,bar,baz
diff --git a/tests/roots/test-directive-csv-table/subdir/example.csv b/tests/roots/test-directive-csv-table/subdir/example.csv
new file mode 100644
index 00000000000..32fe56fad5e
--- /dev/null
+++ b/tests/roots/test-directive-csv-table/subdir/example.csv
@@ -0,0 +1 @@
+FOO,BAR,BAZ
diff --git a/tests/test_directive_patch.py b/tests/test_directive_patch.py
index 7dc568b1d5e..b28e0f1e57d 100644
--- a/tests/test_directive_patch.py
+++ b/tests/test_directive_patch.py
@@ -8,6 +8,7 @@
     :license: BSD, see LICENSE for details.
 """
 
+import pytest
 from docutils import nodes
 
 from sphinx.testing import restructuredtext
@@ -54,6 +55,37 @@ def test_code_directive(app):
     assert_node(doctree[0], language="python", linenos=True, highlight_args={'linenostart': 5})
 
 
+@pytest.mark.sphinx(testroot='directive-csv-table')
+def test_csv_table_directive(app):
+    # relative path from current document
+    text = ('.. csv-table::\n'
+            '   :file: example.csv\n')
+    doctree = restructuredtext.parse(app, text, docname="subdir/index")
+    assert_node(doctree,
+                ([nodes.table, nodes.tgroup, (nodes.colspec,
+                                              nodes.colspec,
+                                              nodes.colspec,
+                                              [nodes.tbody, nodes.row])],))
+    assert_node(doctree[0][0][3][0],
+                ([nodes.entry, nodes.paragraph, "FOO"],
+                 [nodes.entry, nodes.paragraph, "BAR"],
+                 [nodes.entry, nodes.paragraph, "BAZ"]))
+
+    # absolute path from source directory
+    text = ('.. csv-table::\n'
+            '   :file: /example.csv\n')
+    doctree = restructuredtext.parse(app, text, docname="subdir/index")
+    assert_node(doctree,
+                ([nodes.table, nodes.tgroup, (nodes.colspec,
+                                              nodes.colspec,
+                                              nodes.colspec,
+                                              [nodes.tbody, nodes.row])],))
+    assert_node(doctree[0][0][3][0],
+                ([nodes.entry, nodes.paragraph, "foo"],
+                 [nodes.entry, nodes.paragraph, "bar"],
+                 [nodes.entry, nodes.paragraph, "baz"]))
+
+
 def test_math_directive(app):
     # normal case
     text = '.. math:: E = mc^2'

From 1ac05a2a832dfecfbf9431e919cb9f3b99ebf11f Mon Sep 17 00:00:00 2001
From: igo95862 <igo95862@yandex.ru>
Date: Mon, 8 Mar 2021 12:18:25 +0300
Subject: [PATCH 179/305] doc: Create autodoc extension tutorial

---
 doc/development/tutorials/autodoc_ext.rst     | 140 ++++++++++++++++++
 .../tutorials/examples/autodoc_intenum.py     |  52 +++++++
 2 files changed, 192 insertions(+)
 create mode 100644 doc/development/tutorials/autodoc_ext.rst
 create mode 100644 doc/development/tutorials/examples/autodoc_intenum.py

diff --git a/doc/development/tutorials/autodoc_ext.rst b/doc/development/tutorials/autodoc_ext.rst
new file mode 100644
index 00000000000..eca0e51200a
--- /dev/null
+++ b/doc/development/tutorials/autodoc_ext.rst
@@ -0,0 +1,140 @@
+Developing autodoc extension for IntEnum
+========================================
+
+The objective of this tutorial is to create an extension that adds
+support for new type for autodoc. This autodoc extension will format
+the ``IntEnum`` class from Python standard library. (module ``enum``)
+
+Overview
+--------
+
+We want the extension that will create auto-documentation for IntEnum.
+``IntEnum`` is the integer enum class from standard library ``enum`` module.
+
+Currently this class has no special auto documentation behavior.
+
+We want to add following to autodoc:
+
+* A new ``autointenum`` directive that will document the ``IntEnum`` class.
+* The generated documentation will have all the enum possible values
+  with names.
+* The ``autointenum`` directive will have an option ``:hex:`` which will
+  cause the integers be printed in hexadecimal form.
+
+
+Prerequisites
+-------------
+
+We need the same setup as in :doc:`the previous extensions <todo>`. This time,
+we will be putting out extension in a file called :file:`autodoc_intenum.py`.
+The :file:`my_enums.py` will contain the sample enums we will document.
+
+Here is an example of the folder structure you might obtain:
+
+.. code-block:: text
+
+      └── source
+          ├── _ext
+          │   └── autodoc_intenum.py
+          ├── conf.py
+          ├── index.rst
+          └── my_enums.py
+
+
+Writing the extension
+---------------------
+
+Start with ``setup`` function for the extension.
+
+.. literalinclude:: examples/autodoc_intenum.py
+   :language: python
+   :linenos:
+   :pyobject: setup
+
+
+The :meth:`~Sphinx.setup_extension` method will pull the autodoc extension
+because our new extension depends on autodoc. :meth:`~Sphinx.add_autodocumenter`
+is the method that registers our new auto documenter class.
+
+We want to import certain objects from the autodoc extension:
+
+.. literalinclude:: examples/autodoc_intenum.py
+   :language: python
+   :linenos:
+   :lines: 1-7
+
+
+There are several different documenter classes such as ``MethodDocumenter``
+or ``AttributeDocumenter`` available in the autodoc extension but
+our new class is the subclass of ``ClassDocumenter`` which a
+documenter class used by autodoc to document classes.
+
+This is the definition of our new the auto-documenter class:
+
+.. literalinclude:: examples/autodoc_intenum.py
+   :language: python
+   :linenos:
+   :pyobject: IntEnumDocumenter
+
+
+Important attributes of the new class:
+
+**objtype**
+    This attribute determines the ``auto`` directive name. In
+    this case the auto directive will be ``autointenum``.
+
+**directivetype**
+    This attribute sets the generated directive name. In
+    this example the generated directive will be ``.. :py:class::``.
+
+**priority**
+    the larger the number the higher is the priority. We want our
+    documenter be higher priority than the parent.
+
+**option_spec**
+    option specifications. We copy the parent class options and
+    add a new option *hex*.
+
+
+Overridden members:
+
+**can_document_member**
+    This member is important to override. It should
+    return *True* when the passed object can be documented by this class.
+
+**add_directive_header**
+    This method generates the directive header. We add
+    **:final:** directive option. Remember to call **super** or no directive
+    will be generated.
+
+**add_content**
+    This method generates the body of the class documentation.
+    After calling the super method we generate lines for enum description.
+
+
+Using the extension
+-------------------
+
+You can now use the new autodoc directive to document any ``IntEnum``.
+
+For example, you have the following ``IntEnum``:
+
+.. code-block:: python
+   :caption: my_enums.py
+   
+   class Colors(IntEnum):
+       """Colors enumerator"""
+       NONE = 0
+       RED = 1
+       GREEN = 2
+       BLUE = 3
+
+
+This will be the documentation file with auto-documentation directive:
+
+.. code-block:: rst
+   :caption: index.rst
+
+   .. autointenum:: my_enums.Colors
+
+
diff --git a/doc/development/tutorials/examples/autodoc_intenum.py b/doc/development/tutorials/examples/autodoc_intenum.py
new file mode 100644
index 00000000000..7fb85d0662e
--- /dev/null
+++ b/doc/development/tutorials/examples/autodoc_intenum.py
@@ -0,0 +1,52 @@
+from enum import IntEnum
+from typing import Any, Optional
+
+from docutils.statemachine import StringList
+
+from sphinx.application import Sphinx
+from sphinx.ext.autodoc import ClassDocumenter, bool_option
+
+
+class IntEnumDocumenter(ClassDocumenter):
+    objtype = 'intenum'
+    directivetype = 'class'
+    priority = 10 + ClassDocumenter.priority
+    option_spec = dict(ClassDocumenter.option_spec)
+    option_spec['hex'] = bool_option
+
+    @classmethod
+    def can_document_member(cls,
+                            member: Any, membername: str,
+                            isattr: bool, parent: Any) -> bool:
+        return isinstance(member, IntEnum)
+
+    def add_directive_header(self, sig: str) -> None:
+        super().add_directive_header(sig)
+        self.add_line('   :final:', self.get_sourcename())
+
+    def add_content(self,
+                    more_content: Optional[StringList],
+                    no_docstring: bool = False
+                    ) -> None:
+
+        super().add_content(more_content, no_docstring)
+
+        source_name = self.get_sourcename()
+        enum_object: IntEnum = self.object
+        use_hex = self.options.hex
+        self.add_line('', source_name)
+
+        for enum_value in enum_object:
+            the_value_name = enum_value.name
+            the_value_value = enum_value.value
+            if use_hex:
+                the_value_value = hex(the_value_value)
+
+            self.add_line(
+                f"**{the_value_name}**: {the_value_value}", source_name)
+            self.add_line('', source_name)
+
+
+def setup(app: Sphinx) -> None:
+    app.setup_extension('sphinx.ext.autodoc')  # Require autodoc extension
+    app.add_autodocumenter(IntEnumDocumenter)

From a56f69b916c1ae139eb1f38ee6d147b71b3d1d59 Mon Sep 17 00:00:00 2001
From: igo95862 <igo95862@yandex.ru>
Date: Mon, 8 Mar 2021 12:21:56 +0300
Subject: [PATCH 180/305] doc: Added autodoc extension tutorial to tutorials
 index

---
 doc/development/tutorials/index.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/development/tutorials/index.rst b/doc/development/tutorials/index.rst
index be126b3ca41..a7eee48991f 100644
--- a/doc/development/tutorials/index.rst
+++ b/doc/development/tutorials/index.rst
@@ -13,3 +13,5 @@ Refer to the following tutorials to get started with extension development.
    helloworld
    todo
    recipe
+   autodoc_ext
+

From c57cb0b5ed02990b376ffc8b3ba58a95c4faba70 Mon Sep 17 00:00:00 2001
From: igo95862 <igo95862@yandex.ru>
Date: Mon, 8 Mar 2021 12:23:02 +0300
Subject: [PATCH 181/305] doc: Link autodoc tutorial in add_autodocumenter
 docstring

Uses :ref: link because :doc: does not work.
---
 sphinx/application.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/application.py b/sphinx/application.py
index b5cc4426844..7812cecc96a 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -1102,7 +1102,7 @@ def add_autodocumenter(self, cls: Any, override: bool = False) -> None:
         If *override* is True, the given *cls* is forcedly installed even if
         a documenter having the same name is already installed.
 
-        .. todo:: Add real docs for Documenter and subclassing
+        See :ref:`autodoc_ext_tutorial`.
 
         .. versionadded:: 0.6
         .. versionchanged:: 2.2

From 7ee2000598716262cf802594165cd12c20f16d23 Mon Sep 17 00:00:00 2001
From: igo95862 <igo95862@yandex.ru>
Date: Mon, 8 Mar 2021 12:45:43 +0300
Subject: [PATCH 182/305] doc: Added reflink to autodoc tutorial

Used in add_autodocumenter docstring
---
 doc/development/tutorials/autodoc_ext.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/development/tutorials/autodoc_ext.rst b/doc/development/tutorials/autodoc_ext.rst
index eca0e51200a..d8905710c66 100644
--- a/doc/development/tutorials/autodoc_ext.rst
+++ b/doc/development/tutorials/autodoc_ext.rst
@@ -1,3 +1,5 @@
+.. _autodoc_ext_tutorial:
+
 Developing autodoc extension for IntEnum
 ========================================
 

From 54886fd256aeb87b7b7c8a1bcf65bad55c33d3eb Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 25 Apr 2020 12:24:36 +0900
Subject: [PATCH 183/305] Close #7549: autosummary: Enable autosummary_generate
 by default

---
 CHANGES                              |  1 +
 doc/conf.py                          |  1 +
 doc/usage/extensions/autosummary.rst | 18 ++++++++++++------
 sphinx/ext/autosummary/__init__.py   |  2 +-
 4 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/CHANGES b/CHANGES
index a183eba66b1..ad3c20988ef 100644
--- a/CHANGES
+++ b/CHANGES
@@ -62,6 +62,7 @@ Features added
 --------------
 
 * #8924: autodoc: Support ``bound`` argument for TypeVar
+* #7549: autosummary: Enable :confval:`autosummary_generate` by default
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined
 * #7199: py domain: Add :confval:`python_use_unqualified_type_names` to suppress
diff --git a/doc/conf.py b/doc/conf.py
index 7cf74dc97b0..ddf68de0516 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -79,6 +79,7 @@
 latex_use_xindy = True
 
 autodoc_member_order = 'groupwise'
+autosummary_generate = False
 todo_include_todos = True
 extlinks = {'duref': ('http://docutils.sourceforge.net/docs/ref/rst/'
                       'restructuredtext.html#%s', ''),
diff --git a/doc/usage/extensions/autosummary.rst b/doc/usage/extensions/autosummary.rst
index 03ea7548e2f..28f207de7fe 100644
--- a/doc/usage/extensions/autosummary.rst
+++ b/doc/usage/extensions/autosummary.rst
@@ -19,11 +19,13 @@ The :mod:`sphinx.ext.autosummary` extension does this in two parts:
    that contain links to the documented items, and short summary blurbs
    extracted from their docstrings.
 
-2. Optionally, the convenience script :program:`sphinx-autogen` or the new
-   :confval:`autosummary_generate` config value can be used to generate short
-   "stub" files for the entries listed in the :rst:dir:`autosummary` directives.
-   These files by default contain only the corresponding
-   :mod:`sphinx.ext.autodoc` directive, but can be customized with templates.
+2. A :rst:dir:`autosummary` directive also generates short "stub" files for the
+   entries listed in its content.  These files by default contain only the
+   corresponding :mod:`sphinx.ext.autodoc` directive, but can be customized with
+   templates.
+
+   The :program:`sphinx-autogen` script is also able to generate "stub" files
+   from command line.
 
 .. rst:directive:: autosummary
 
@@ -161,7 +163,7 @@ also use these config values:
 .. confval:: autosummary_generate
 
    Boolean indicating whether to scan all found documents for autosummary
-   directives, and to generate stub pages for each. It is disabled by default.
+   directives, and to generate stub pages for each. It is enabled by default.
 
    Can also be a list of documents for which stub pages should be generated.
 
@@ -173,6 +175,10 @@ also use these config values:
       Emits :event:`autodoc-skip-member` event as :mod:`~sphinx.ext.autodoc`
       does.
 
+   .. versionchanged:: 4.0
+
+      Enabled by default.
+
 .. confval:: autosummary_generate_overwrite
 
    If true, autosummary overwrites existing files by generated stub pages.
diff --git a/sphinx/ext/autosummary/__init__.py b/sphinx/ext/autosummary/__init__.py
index 7dbaaf6865b..1a0fd240927 100644
--- a/sphinx/ext/autosummary/__init__.py
+++ b/sphinx/ext/autosummary/__init__.py
@@ -772,7 +772,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.connect('builder-inited', process_generate_options)
     app.add_config_value('autosummary_context', {}, True)
     app.add_config_value('autosummary_filename_map', {}, 'html')
-    app.add_config_value('autosummary_generate', [], True, [bool])
+    app.add_config_value('autosummary_generate', True, True, [bool])
     app.add_config_value('autosummary_generate_overwrite', True, False)
     app.add_config_value('autosummary_mock_imports',
                          lambda config: config.autodoc_mock_imports, 'env')

From 6976c051ee1a356950ea0641fdebdfed51d10799 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 10 Mar 2021 01:38:48 +0900
Subject: [PATCH 184/305] refactor: Use PEP-526 based variable annotation
 (sphinx.util)

---
 sphinx/util/__init__.py   |  8 ++++----
 sphinx/util/cfamily.py    | 10 +++++-----
 sphinx/util/console.py    |  8 ++++----
 sphinx/util/docfields.py  | 12 ++++++------
 sphinx/util/docstrings.py |  2 +-
 sphinx/util/docutils.py   |  8 ++++----
 sphinx/util/inventory.py  |  4 ++--
 sphinx/util/jsdump.py     |  6 +++---
 sphinx/util/logging.py    | 16 +++++++++-------
 sphinx/util/matching.py   |  4 ++--
 sphinx/util/nodes.py      |  4 ++--
 sphinx/util/osutil.py     |  2 +-
 sphinx/util/parallel.py   | 10 +++++-----
 sphinx/util/rst.py        |  3 +--
 sphinx/util/texescape.py  | 10 +++++-----
 15 files changed, 54 insertions(+), 53 deletions(-)

diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index 83b2561f2b3..cb8669eca68 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -47,8 +47,8 @@
 logger = logging.getLogger(__name__)
 
 # Generally useful regular expressions.
-ws_re = re.compile(r'\s+')
-url_re = re.compile(r'(?P<schema>.+)://.*')
+ws_re: Pattern = re.compile(r'\s+')
+url_re: Pattern = re.compile(r'(?P<schema>.+)://.*')
 
 
 # High-level utility functions.
@@ -107,7 +107,7 @@ class FilenameUniqDict(dict):
     appear in.  Used for images and downloadable files in the environment.
     """
     def __init__(self) -> None:
-        self._existing = set()  # type: Set[str]
+        self._existing: Set[str] = set()
 
     def add_file(self, docname: str, newfile: str) -> str:
         if newfile in self:
@@ -379,7 +379,7 @@ def format_exception_cut_frames(x: int = 1) -> str:
     """Format an exception with traceback, but only the last x frames."""
     typ, val, tb = sys.exc_info()
     # res = ['Traceback (most recent call last):\n']
-    res = []  # type: List[str]
+    res: List[str] = []
     tbres = traceback.format_tb(tb)
     res += tbres[-x:]
     res += traceback.format_exception_only(typ, val)
diff --git a/sphinx/util/cfamily.py b/sphinx/util/cfamily.py
index 31244852ce6..2be2e390f0f 100644
--- a/sphinx/util/cfamily.py
+++ b/sphinx/util/cfamily.py
@@ -98,7 +98,7 @@ def __eq__(self, other: Any) -> bool:
             return False
         return True
 
-    __hash__ = None  # type: Callable[[], int]
+    __hash__: Callable[[], int] = None
 
     def clone(self) -> Any:
         return deepcopy(self)
@@ -223,9 +223,9 @@ def __init__(self, definition: str, *,
 
         self.pos = 0
         self.end = len(self.definition)
-        self.last_match = None  # type: Match
-        self._previous_state = (0, None)  # type: Tuple[int, Match]
-        self.otherErrors = []  # type: List[DefinitionError]
+        self.last_match: Match = None
+        self._previous_state: Tuple[int, Match] = (0, None)
+        self.otherErrors: List[DefinitionError] = []
 
         # in our tests the following is set to False to capture bad parsing
         self.allowFallbackExpressionParsing = True
@@ -356,7 +356,7 @@ def _parse_balanced_token_seq(self, end: List[str]) -> str:
         # TODO: add handling of string literals and similar
         brackets = {'(': ')', '[': ']', '{': '}'}
         startPos = self.pos
-        symbols = []  # type: List[str]
+        symbols: List[str] = []
         while not self.eof:
             if len(symbols) == 0 and self.current_char in end:
                 break
diff --git a/sphinx/util/console.py b/sphinx/util/console.py
index 3ea5b9573cd..0c8008371f2 100644
--- a/sphinx/util/console.py
+++ b/sphinx/util/console.py
@@ -11,7 +11,7 @@
 import os
 import re
 import sys
-from typing import Dict
+from typing import Dict, Pattern
 
 try:
     # check if colorama is installed to support color on Windows
@@ -20,8 +20,8 @@
     colorama = None
 
 
-_ansi_re = re.compile('\x1b\\[(\\d\\d;){0,2}\\d\\dm')
-codes = {}  # type: Dict[str, str]
+_ansi_re: Pattern = re.compile('\x1b\\[(\\d\\d;){0,2}\\d\\dm')
+codes: Dict[str, str] = {}
 
 
 def terminal_safe(s: str) -> str:
@@ -44,7 +44,7 @@ def get_terminal_width() -> int:
     return terminal_width
 
 
-_tw = get_terminal_width()
+_tw: int = get_terminal_width()
 
 
 def term_width_line(text: str) -> str:
diff --git a/sphinx/util/docfields.py b/sphinx/util/docfields.py
index 79abfe14b24..43f15f507c6 100644
--- a/sphinx/util/docfields.py
+++ b/sphinx/util/docfields.py
@@ -27,7 +27,7 @@ def _is_single_paragraph(node: nodes.field_body) -> bool:
     if len(node) == 0:
         return False
     elif len(node) > 1:
-        for subnode in node[1:]:  # type: nodes.Node
+        for subnode in node[1:]:  # type: Node
             if not isinstance(subnode, nodes.system_message):
                 return False
     if isinstance(node[0], nodes.paragraph):
@@ -195,7 +195,7 @@ def handle_item(fieldarg: str, content: str) -> nodes.paragraph:
         fieldname = nodes.field_name('', self.label)
         if len(items) == 1 and self.can_collapse:
             fieldarg, content = items[0]
-            bodynode = handle_item(fieldarg, content)  # type: nodes.Node
+            bodynode: Node = handle_item(fieldarg, content)
         else:
             bodynode = self.list_type()
             for fieldarg, content in items:
@@ -209,7 +209,7 @@ class DocFieldTransformer:
     Transforms field lists in "doc field" syntax into better-looking
     equivalents, using the field type definitions given on a domain.
     """
-    typemap = None  # type: Dict[str, Tuple[Field, bool]]
+    typemap: Dict[str, Tuple[Field, bool]] = None
 
     def __init__(self, directive: "ObjectDescription") -> None:
         self.directive = directive
@@ -227,9 +227,9 @@ def transform(self, node: nodes.field_list) -> None:
         """Transform a single field list *node*."""
         typemap = self.typemap
 
-        entries = []        # type: List[Union[nodes.field, Tuple[Field, Any]]]
-        groupindices = {}   # type: Dict[str, int]
-        types = {}          # type: Dict[str, Dict]
+        entries: List[Union[nodes.field, Tuple[Field, Any]]] = []
+        groupindices: Dict[str, int] = {}
+        types: Dict[str, Dict] = {}
 
         # step 1: traverse all fields and collect field types and content
         for field in cast(List[nodes.field], node):
diff --git a/sphinx/util/docstrings.py b/sphinx/util/docstrings.py
index ac778af87ae..46bb5b9b8f0 100644
--- a/sphinx/util/docstrings.py
+++ b/sphinx/util/docstrings.py
@@ -23,7 +23,7 @@
 def extract_metadata(s: str) -> Dict[str, str]:
     """Extract metadata from docstring."""
     in_other_element = False
-    metadata = {}  # type: Dict[str, str]
+    metadata: Dict[str, str] = {}
 
     if not s:
         return metadata
diff --git a/sphinx/util/docutils.py b/sphinx/util/docutils.py
index a3e49e6d7c2..a4ecdc647ab 100644
--- a/sphinx/util/docutils.py
+++ b/sphinx/util/docutils.py
@@ -42,7 +42,7 @@
 
 
 __version_info__ = tuple(LooseVersion(docutils.__version__).version)
-additional_nodes = set()  # type: Set[Type[nodes.Element]]
+additional_nodes: Set[Type[Element]] = set()
 
 
 @contextmanager
@@ -176,8 +176,8 @@ class sphinx_domains:
     """
     def __init__(self, env: "BuildEnvironment") -> None:
         self.env = env
-        self.directive_func = None  # type: Callable
-        self.roles_func = None  # type: Callable
+        self.directive_func: Callable = None
+        self.roles_func: Callable = None
 
     def __enter__(self) -> None:
         self.enable()
@@ -491,7 +491,7 @@ def dispatch_departure(self, node: Node) -> None:
 
 # cache a vanilla instance of nodes.document
 # Used in new_document() function
-__document_cache__ = None  # type: nodes.document
+__document_cache__: nodes.document = None
 
 
 def new_document(source_path: str, settings: Any = None) -> nodes.document:
diff --git a/sphinx/util/inventory.py b/sphinx/util/inventory.py
index 40ac87997d2..f21c273239e 100644
--- a/sphinx/util/inventory.py
+++ b/sphinx/util/inventory.py
@@ -93,7 +93,7 @@ def load(cls, stream: IO, uri: str, joinfunc: Callable) -> Inventory:
 
     @classmethod
     def load_v1(cls, stream: InventoryFileReader, uri: str, join: Callable) -> Inventory:
-        invdata = {}  # type: Inventory
+        invdata: Inventory = {}
         projname = stream.readline().rstrip()[11:]
         version = stream.readline().rstrip()[11:]
         for line in stream.readlines():
@@ -111,7 +111,7 @@ def load_v1(cls, stream: InventoryFileReader, uri: str, join: Callable) -> Inven
 
     @classmethod
     def load_v2(cls, stream: InventoryFileReader, uri: str, join: Callable) -> Inventory:
-        invdata = {}  # type: Inventory
+        invdata: Inventory = {}
         projname = stream.readline().rstrip()[11:]
         version = stream.readline().rstrip()[11:]
         line = stream.readline()
diff --git a/sphinx/util/jsdump.py b/sphinx/util/jsdump.py
index 114fd707516..6d534cb3aa2 100644
--- a/sphinx/util/jsdump.py
+++ b/sphinx/util/jsdump.py
@@ -109,8 +109,8 @@ def loads(x: str) -> Any:
     nothing = object()
     i = 0
     n = len(x)
-    stack = []  # type: List[Union[List, Dict]]
-    obj = nothing  # type: Any
+    stack: List[Union[List, Dict]] = []
+    obj: Any = nothing
     key = False
     keys = []
     while i < n:
@@ -160,7 +160,7 @@ def loads(x: str) -> Any:
                 raise ValueError("multiple values")
             key = False
         else:
-            y = None  # type: Any
+            y: Any = None
             m = _str_re.match(x, i)
             if m:
                 y = decode_string(m.group()[1:-1])
diff --git a/sphinx/util/logging.py b/sphinx/util/logging.py
index dd04b3f238c..64b7d8fb436 100644
--- a/sphinx/util/logging.py
+++ b/sphinx/util/logging.py
@@ -28,7 +28,7 @@
 NAMESPACE = 'sphinx'
 VERBOSE = 15
 
-LEVEL_NAMES = defaultdict(lambda: logging.WARNING)  # type: Dict[str, int]
+LEVEL_NAMES: Dict[str, int] = defaultdict(lambda: logging.WARNING)
 LEVEL_NAMES.update({
     'CRITICAL': logging.CRITICAL,
     'SEVERE': logging.CRITICAL,
@@ -39,7 +39,7 @@
     'DEBUG': logging.DEBUG,
 })
 
-VERBOSITY_MAP = defaultdict(lambda: 0)  # type: Dict[int, int]
+VERBOSITY_MAP: Dict[int, int] = defaultdict(lambda: 0)
 VERBOSITY_MAP.update({
     0: logging.INFO,
     1: VERBOSE,
@@ -91,7 +91,7 @@ def convert_serializable(records: List[logging.LogRecord]) -> None:
 class SphinxLogRecord(logging.LogRecord):
     """Log record class supporting location"""
     prefix = ''
-    location = None  # type: Any
+    location: Any = None
 
     def getMessage(self) -> str:
         message = super().getMessage()
@@ -163,6 +163,8 @@ def emit(self, record: logging.LogRecord) -> None:
 class MemoryHandler(logging.handlers.BufferingHandler):
     """Handler buffering all logs."""
 
+    buffer: List[logging.LogRecord]
+
     def __init__(self) -> None:
         super().__init__(-1)
 
@@ -174,7 +176,7 @@ def flushTo(self, logger: logging.Logger) -> None:
         try:
             for record in self.buffer:
                 logger.handle(record)
-            self.buffer = []  # type: List[logging.LogRecord]
+            self.buffer = []
         finally:
             self.release()
 
@@ -328,7 +330,7 @@ def prefixed_warnings(prefix: str) -> Generator[None, None, None]:
 
 class LogCollector:
     def __init__(self) -> None:
-        self.logs = []  # type: List[logging.LogRecord]
+        self.logs: List[logging.LogRecord] = []
 
     @contextmanager
     def collect(self) -> Generator[None, None, None]:
@@ -449,7 +451,7 @@ class OnceFilter(logging.Filter):
 
     def __init__(self, name: str = '') -> None:
         super().__init__(name)
-        self.messages = {}  # type: Dict[str, List]
+        self.messages: Dict[str, List] = {}
 
     def filter(self, record: logging.LogRecord) -> bool:
         once = getattr(record, 'once', '')
@@ -470,7 +472,7 @@ class SphinxLogRecordTranslator(logging.Filter):
     * Make a instance of SphinxLogRecord
     * docname to path if location given
     """
-    LogRecordClass = None  # type: Type[logging.LogRecord]
+    LogRecordClass: Type[logging.LogRecord] = None
 
     def __init__(self, app: "Sphinx") -> None:
         self.app = app
diff --git a/sphinx/util/matching.py b/sphinx/util/matching.py
index 2ed8046778f..f32d682f126 100644
--- a/sphinx/util/matching.py
+++ b/sphinx/util/matching.py
@@ -21,7 +21,7 @@ def _translate_pattern(pat: str) -> str:
     match slashes.
     """
     i, n = 0, len(pat)
-    res = ''  # type: str
+    res = ''
     while i < n:
         c = pat[i]
         i += 1
@@ -86,7 +86,7 @@ def match(self, string: str) -> bool:
 DOTFILES = Matcher(['**/.*'])
 
 
-_pat_cache = {}  # type: Dict[str, Pattern]
+_pat_cache: Dict[str, Pattern] = {}
 
 
 def patmatch(name: str, pat: str) -> Optional[Match[str]]:
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index c7619a836fe..61d688d8efd 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -251,7 +251,7 @@ def is_translatable(node: Node) -> bool:
 
 def extract_messages(doctree: Element) -> Iterable[Tuple[Element, str]]:
     """Extract translatable messages from a document tree."""
-    for node in doctree.traverse(is_translatable):  # type: nodes.Element
+    for node in doctree.traverse(is_translatable):  # type: Element
         if isinstance(node, addnodes.translatable):
             for msg in node.extract_original_messages():
                 yield node, msg
@@ -363,7 +363,7 @@ def split_explicit_title(text: str) -> Tuple[bool, str, str]:
 def process_index_entry(entry: str, targetid: str) -> List[Tuple[str, str, str, str, str]]:
     from sphinx.domains.python import pairindextypes
 
-    indexentries = []  # type: List[Tuple[str, str, str, str, str]]
+    indexentries: List[Tuple[str, str, str, str, str]] = []
     entry = entry.strip()
     oentry = entry
     main = ''
diff --git a/sphinx/util/osutil.py b/sphinx/util/osutil.py
index 5ee2eccc8c6..c8ecce9e244 100644
--- a/sphinx/util/osutil.py
+++ b/sphinx/util/osutil.py
@@ -185,7 +185,7 @@ class FileAvoidWrite:
     """
     def __init__(self, path: str) -> None:
         self._path = path
-        self._io = None  # type: Optional[StringIO]
+        self._io: Optional[StringIO] = None
 
     def write(self, data: str) -> None:
         if not self._io:
diff --git a/sphinx/util/parallel.py b/sphinx/util/parallel.py
index ed73ee4d6b9..7ad7f81e7f3 100644
--- a/sphinx/util/parallel.py
+++ b/sphinx/util/parallel.py
@@ -60,15 +60,15 @@ class ParallelTasks:
     def __init__(self, nproc: int) -> None:
         self.nproc = nproc
         # (optional) function performed by each task on the result of main task
-        self._result_funcs = {}  # type: Dict[int, Callable]
+        self._result_funcs: Dict[int, Callable] = {}
         # task arguments
-        self._args = {}  # type: Dict[int, List[Any]]
+        self._args: Dict[int, List[Any]] = {}
         # list of subprocesses (both started and waiting)
-        self._procs = {}  # type: Dict[int, multiprocessing.Process]
+        self._procs: Dict[int, multiprocessing.Process] = {}
         # list of receiving pipe connections of running subprocesses
-        self._precvs = {}  # type: Dict[int, Any]
+        self._precvs: Dict[int, Any] = {}
         # list of receiving pipe connections of waiting subprocesses
-        self._precvsWaiting = {}  # type: Dict[int, Any]
+        self._precvsWaiting: Dict[int, Any] = {}
         # number of working subprocesses
         self._pworking = 0
         # task number of each subprocess
diff --git a/sphinx/util/rst.py b/sphinx/util/rst.py
index 79ede34326f..82b3f6bdaab 100644
--- a/sphinx/util/rst.py
+++ b/sphinx/util/rst.py
@@ -30,8 +30,7 @@
 SECTIONING_CHARS = ['=', '-', '~']
 
 # width of characters
-WIDECHARS = defaultdict(lambda: "WF")   # type: Dict[str, str]
-                                        # WF: Wide + Full-width
+WIDECHARS: Dict[str, str] = defaultdict(lambda: "WF")  # WF: Wide + Full-width
 WIDECHARS["ja"] = "WFA"  # In Japanese, Ambiguous characters also have double width
 
 
diff --git a/sphinx/util/texescape.py b/sphinx/util/texescape.py
index 7323d2c27d1..417a963a7ef 100644
--- a/sphinx/util/texescape.py
+++ b/sphinx/util/texescape.py
@@ -98,12 +98,12 @@
 # %, {, }, \, #, and ~ are the only ones which must be replaced by _ character
 # It would be simpler to define it entirely here rather than in init().
 # Unicode replacements are superfluous, as idescape() uses backslashreplace
-tex_replace_map = {}  # type: Dict[int, str]
+tex_replace_map: Dict[int, str] = {}
 
-_tex_escape_map = {}  # type: Dict[int, str]
-_tex_escape_map_without_unicode = {}  # type: Dict[int, str]
-_tex_hlescape_map = {}  # type: Dict[int, str]
-_tex_hlescape_map_without_unicode = {}  # type: Dict[int, str]
+_tex_escape_map: Dict[int, str] = {}
+_tex_escape_map_without_unicode: Dict[int, str] = {}
+_tex_hlescape_map: Dict[int, str] = {}
+_tex_hlescape_map_without_unicode: Dict[int, str] = {}
 
 
 def escape(s: str, latex_engine: str = None) -> str:

From 204f86f736ae59b7f2a26ef31ba48f8165fcd10e Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 12 Mar 2020 00:54:39 +0900
Subject: [PATCH 185/305] py domain: Add py:property directive to describe a
 property (refs: #7068)

---
 CHANGES                                |  1 +
 doc/usage/restructuredtext/domains.rst | 22 +++++++++++
 sphinx/domains/python.py               | 53 +++++++++++++++++++++++++-
 tests/roots/test-domain-py/module.rst  |  3 +-
 tests/test_domain_py.py                | 27 +++++++++++++
 5 files changed, 103 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index a183eba66b1..2a043fab768 100644
--- a/CHANGES
+++ b/CHANGES
@@ -66,6 +66,7 @@ Features added
   the location where the object is defined
 * #7199: py domain: Add :confval:`python_use_unqualified_type_names` to suppress
   the module name of the python reference if it can be resolved (experimental)
+* #7068: py domain: Add :rst:dir:`py:property` directive to describe a property
 * #7784: i18n: The alt text for image is translated by default (without
   :confval:`gettext_additional_targets` setting)
 * #2018: html: :confval:`html_favicon` and :confval:`html_logo` now accept URL
diff --git a/doc/usage/restructuredtext/domains.rst b/doc/usage/restructuredtext/domains.rst
index bd106405587..517e6f5c2e5 100644
--- a/doc/usage/restructuredtext/domains.rst
+++ b/doc/usage/restructuredtext/domains.rst
@@ -316,6 +316,22 @@ The following directives are provided for module and class contents:
 
       .. versionadded:: 4.0
 
+.. rst:directive:: .. py:property:: name
+
+   Describes an object property.
+
+   .. versionadded:: 4.0
+
+   .. rubric:: options
+
+   .. rst:directive:option:: abstractmethod
+      :type: no value
+
+      Indicate the property is abstract.
+
+   .. rst:directive:option:: type: type of the property
+      :type: text
+
 .. rst:directive:: .. py:method:: name(parameters)
 
    Describes an object method.  The parameters should not include the ``self``
@@ -368,6 +384,10 @@ The following directives are provided for module and class contents:
 
       .. versionadded:: 2.1
 
+      .. deprecated:: 4.0
+
+         Use :rst:dir:`py:property` instead.
+
    .. rst:directive:option:: staticmethod
       :type: no value
 
@@ -584,6 +604,8 @@ a matching identifier is found:
 
    Reference a data attribute of an object.
 
+   .. note:: The role is also able to refer to property.
+
 .. rst:role:: py:exc
 
    Reference an exception.  A dotted name may be used.
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 40a67f82cc7..f4958a5361b 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -825,6 +825,46 @@ def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str:
         return _('%s (%s attribute)') % (attrname, clsname)
 
 
+class PyProperty(PyObject):
+    """Description of an attribute."""
+
+    option_spec = PyObject.option_spec.copy()
+    option_spec.update({
+        'abstractmethod': directives.flag,
+        'type': directives.unchanged,
+    })
+
+    def handle_signature(self, sig: str, signode: desc_signature) -> Tuple[str, str]:
+        fullname, prefix = super().handle_signature(sig, signode)
+
+        typ = self.options.get('type')
+        if typ:
+            signode += addnodes.desc_annotation(typ, ': ' + typ)
+
+        return fullname, prefix
+
+    def get_signature_prefix(self, sig: str) -> str:
+        prefix = ['property']
+        if 'abstractmethod' in self.options:
+            prefix.insert(0, 'abstract')
+
+        return ' '.join(prefix) + ' '
+
+    def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str:
+        name, cls = name_cls
+        try:
+            clsname, attrname = name.rsplit('.', 1)
+            if modname and self.env.config.add_module_names:
+                clsname = '.'.join([modname, clsname])
+        except ValueError:
+            if modname:
+                return _('%s (in module %s)') % (name, modname)
+            else:
+                return name
+
+        return _('%s (%s property)') % (attrname, clsname)
+
+
 class PyDecoratorMixin:
     """
     Mixin for decorator directives.
@@ -1056,6 +1096,7 @@ class PythonDomain(Domain):
         'classmethod':  ObjType(_('class method'),  'meth', 'obj'),
         'staticmethod': ObjType(_('static method'), 'meth', 'obj'),
         'attribute':    ObjType(_('attribute'),     'attr', 'obj'),
+        'property':     ObjType(_('property'),      'attr', '_prop', 'obj'),
         'module':       ObjType(_('module'),        'mod', 'obj'),
     }  # type: Dict[str, ObjType]
 
@@ -1068,6 +1109,7 @@ class PythonDomain(Domain):
         'classmethod':     PyClassMethod,
         'staticmethod':    PyStaticMethod,
         'attribute':       PyAttribute,
+        'property':        PyProperty,
         'module':          PyModule,
         'currentmodule':   PyCurrentModule,
         'decorator':       PyDecoratorFunction,
@@ -1205,8 +1247,17 @@ def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder
                                 type, searchmode)
 
         if not matches and type == 'attr':
-            # fallback to meth (for property)
+            # fallback to meth (for property; Sphinx-2.4.x)
+            # this ensures that `:attr:` role continues to refer to the old property entry
+            # that defined by ``method`` directive in old reST files.
             matches = self.find_obj(env, modname, clsname, target, 'meth', searchmode)
+        if not matches and type == 'meth':
+            # fallback to attr (for property)
+            # this ensures that `:meth:` in the old reST files can refer to the property
+            # entry that defined by ``property`` directive.
+            #
+            # Note: _prop is a secret role only for internal look-up.
+            matches = self.find_obj(env, modname, clsname, target, '_prop', searchmode)
 
         if not matches:
             return None
diff --git a/tests/roots/test-domain-py/module.rst b/tests/roots/test-domain-py/module.rst
index dce3fa5acce..4a280681207 100644
--- a/tests/roots/test-domain-py/module.rst
+++ b/tests/roots/test-domain-py/module.rst
@@ -18,8 +18,7 @@ module
 
     * Link to :py:meth:`module_a.submodule.ModTopLevel.mod_child_1`
 
-.. py:method:: ModTopLevel.prop
-   :property:
+.. py:property:: ModTopLevel.prop
 
    * Link to :py:attr:`prop attribute <.prop>`
    * Link to :py:meth:`prop method <.prop>`
diff --git a/tests/test_domain_py.py b/tests/test_domain_py.py
index 03e865e8456..f5df9084b27 100644
--- a/tests/test_domain_py.py
+++ b/tests/test_domain_py.py
@@ -201,6 +201,10 @@ def test_resolve_xref_for_properties(app, status, warning):
             ' title="module_a.submodule.ModTopLevel.prop">'
             '<code class="xref py py-meth docutils literal notranslate"><span class="pre">'
             'prop</span> <span class="pre">method</span></code></a>' in content)
+    assert ('Link to <a class="reference internal" href="#module_a.submodule.ModTopLevel.prop"'
+            ' title="module_a.submodule.ModTopLevel.prop">'
+            '<code class="xref py py-attr docutils literal notranslate"><span class="pre">'
+            'prop</span> <span class="pre">attribute</span></code></a>' in content)
 
 
 @pytest.mark.sphinx('dummy', testroot='domain-py')
@@ -798,6 +802,29 @@ def test_pyattribute(app):
     assert domain.objects['Class.attr'] == ('index', 'Class.attr', 'attribute', False)
 
 
+def test_pyproperty(app):
+    text = (".. py:class:: Class\n"
+            "\n"
+            "   .. py:property:: prop\n"
+            "      :abstractmethod:\n"
+            "      :type: str\n")
+    domain = app.env.get_domain('py')
+    doctree = restructuredtext.parse(app, text)
+    assert_node(doctree, (addnodes.index,
+                          [desc, ([desc_signature, ([desc_annotation, "class "],
+                                                    [desc_name, "Class"])],
+                                  [desc_content, (addnodes.index,
+                                                  desc)])]))
+    assert_node(doctree[1][1][0], addnodes.index,
+                entries=[('single', 'prop (Class property)', 'Class.prop', '', None)])
+    assert_node(doctree[1][1][1], ([desc_signature, ([desc_annotation, "abstract property "],
+                                                     [desc_name, "prop"],
+                                                     [desc_annotation, ": str"])],
+                                   [desc_content, ()]))
+    assert 'Class.prop' in domain.objects
+    assert domain.objects['Class.prop'] == ('index', 'Class.prop', 'property', False)
+
+
 def test_pydecorator_signature(app):
     text = ".. py:decorator:: deco"
     domain = app.env.get_domain('py')

From 1232a14de817a18146c505d6956e3fd73fee358d Mon Sep 17 00:00:00 2001
From: Sviatoslav Sydorenko <wk@sydorenko.org.ua>
Date: Fri, 12 Mar 2021 00:49:49 +0100
Subject: [PATCH 186/305] Make `conf.py` template use new-style interpshinx

Fixes #8985
---
 sphinx/templates/quickstart/conf.py_t | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/sphinx/templates/quickstart/conf.py_t b/sphinx/templates/quickstart/conf.py_t
index 8a20fc4c8a3..42a6fa3ef98 100644
--- a/sphinx/templates/quickstart/conf.py_t
+++ b/sphinx/templates/quickstart/conf.py_t
@@ -105,7 +105,9 @@ html_static_path = ['{{ dot }}static']
 # -- Options for intersphinx extension ---------------------------------------
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'https://docs.python.org/3/': None}
+intersphinx_mapping = {
+    'python': ('https://docs.python.org/3', None),
+}
 {%- endif %}
 {%- if 'sphinx.ext.todo' in extensions %}
 

From dd24a4ef2dd6d72208469a03a7c5833340efb7b6 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 12 Mar 2021 01:55:01 +0900
Subject: [PATCH 187/305] refactor: Use PEP-526 based variable annotation
 (sphinx.writers)

---
 sphinx/writers/html.py    |  6 ++---
 sphinx/writers/html5.py   |  6 ++---
 sphinx/writers/latex.py   | 55 ++++++++++++++++++---------------------
 sphinx/writers/manpage.py |  2 +-
 sphinx/writers/texinfo.py | 54 +++++++++++++++++---------------------
 sphinx/writers/text.py    | 35 ++++++++++++-------------
 6 files changed, 74 insertions(+), 84 deletions(-)

diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py
index 64d1e89698c..35c29550e05 100644
--- a/sphinx/writers/html.py
+++ b/sphinx/writers/html.py
@@ -83,7 +83,7 @@ class HTMLTranslator(SphinxTranslator, BaseTranslator):
     Our custom HTML translator.
     """
 
-    builder = None  # type: StandaloneHTMLBuilder
+    builder: "StandaloneHTMLBuilder" = None
 
     def __init__(self, document: nodes.document, builder: Builder) -> None:
         super().__init__(document, builder)
@@ -371,7 +371,7 @@ def visit_classifier(self, node: Element) -> None:
     def depart_classifier(self, node: Element) -> None:
         self.body.append('</span>')
 
-        next_node = node.next_node(descend=False, siblings=True)  # type: Node
+        next_node: Node = node.next_node(descend=False, siblings=True)
         if not isinstance(next_node, nodes.classifier):
             # close `<dt>` tag at the tail of classifiers
             self.body.append('</dt>')
@@ -382,7 +382,7 @@ def visit_term(self, node: Element) -> None:
 
     # overwritten
     def depart_term(self, node: Element) -> None:
-        next_node = node.next_node(descend=False, siblings=True)  # type: Node
+        next_node: Node = node.next_node(descend=False, siblings=True)
         if isinstance(next_node, nodes.classifier):
             # Leave the end tag to `self.depart_classifier()`, in case
             # there's a classifier.
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index b354bf80431..8ae3d123ee9 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -54,7 +54,7 @@ class HTML5Translator(SphinxTranslator, BaseTranslator):
     Our custom HTML translator.
     """
 
-    builder = None  # type: StandaloneHTMLBuilder
+    builder: "StandaloneHTMLBuilder" = None
 
     def __init__(self, document: nodes.document, builder: Builder) -> None:
         super().__init__(document, builder)
@@ -322,7 +322,7 @@ def visit_classifier(self, node: Element) -> None:
     def depart_classifier(self, node: Element) -> None:
         self.body.append('</span>')
 
-        next_node = node.next_node(descend=False, siblings=True)  # type: Node
+        next_node: Node = node.next_node(descend=False, siblings=True)
         if not isinstance(next_node, nodes.classifier):
             # close `<dt>` tag at the tail of classifiers
             self.body.append('</dt>')
@@ -333,7 +333,7 @@ def visit_term(self, node: Element) -> None:
 
     # overwritten
     def depart_term(self, node: Element) -> None:
-        next_node = node.next_node(descend=False, siblings=True)  # type: Node
+        next_node: Node = node.next_node(descend=False, siblings=True)
         if isinstance(next_node, nodes.classifier):
             # Leave the end tag to `self.depart_classifier()`, in case
             # there's a classifier.
diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py
index 93f97d028ef..edef5417f72 100644
--- a/sphinx/writers/latex.py
+++ b/sphinx/writers/latex.py
@@ -79,14 +79,14 @@ class LaTeXWriter(writers.Writer):
         ('Document class', ['--docclass'], {'default': 'manual'}),
         ('Author', ['--author'], {'default': ''}),
     ))
-    settings_defaults = {}  # type: Dict
+    settings_defaults: Dict = {}
 
     output = None
 
     def __init__(self, builder: "LaTeXBuilder") -> None:
         super().__init__()
         self.builder = builder
-        self.theme = None  # type: Theme
+        self.theme: Theme = None
 
     def translate(self) -> None:
         try:
@@ -106,28 +106,26 @@ class Table:
     """A table data"""
 
     def __init__(self, node: Element) -> None:
-        self.header = []                        # type: List[str]
-        self.body = []                          # type: List[str]
+        self.header: List[str] = []
+        self.body: List[str] = []
         self.align = node.get('align', 'default')
+        self.classes: List[str] = node.get('classes', [])
         self.colcount = 0
-        self.colspec = None                     # type: str
-        self.colwidths = []                     # type: List[int]
+        self.colspec: str = None
+        self.colwidths: List[int] = []
         self.has_problematic = False
         self.has_oldproblematic = False
         self.has_verbatim = False
-        self.caption = None                     # type: List[str]
-        self.stubs = []                         # type: List[int]
+        self.caption: List[str] = None
+        self.stubs: List[int] = []
 
         # current position
         self.col = 0
         self.row = 0
 
-        # for internal use
-        self.classes = node.get('classes', [])  # type: List[str]
-        self.cells = defaultdict(int)           # type: Dict[Tuple[int, int], int]
-                                                # it maps table location to cell_id
-                                                # (cell = rectangular area)
-        self.cell_id = 0                        # last assigned cell_id
+        # A mapping a table location to the cell_id (cell = rectangular area)
+        self.cells: Dict[Tuple[int, int], int] = defaultdict(int)
+        self.cell_id = 0  # last assigned cell_id
 
     def is_longtable(self) -> bool:
         """True if and only if table uses longtable environment."""
@@ -272,7 +270,7 @@ def rstdim_to_latexdim(width_str: str, scale: int = 100) -> str:
 
 
 class LaTeXTranslator(SphinxTranslator):
-    builder = None  # type: LaTeXBuilder
+    builder: "LaTeXBuilder" = None
 
     secnumdepth = 2  # legacy sphinxhowto.cls uses this, whereas article.cls
     # default is originally 3. For book/report, 2 is already LaTeX default.
@@ -284,7 +282,7 @@ class LaTeXTranslator(SphinxTranslator):
     def __init__(self, document: nodes.document, builder: "LaTeXBuilder",
                  theme: "Theme" = None) -> None:
         super().__init__(document, builder)
-        self.body = []  # type: List[str]
+        self.body: List[str] = []
         self.theme = theme
 
         if theme is None:
@@ -427,15 +425,15 @@ def __init__(self, document: nodes.document, builder: "LaTeXBuilder",
 
         self.highlighter = highlighting.PygmentsBridge('latex', self.config.pygments_style,
                                                        latex_engine=self.config.latex_engine)
-        self.context = []                   # type: List[Any]
-        self.descstack = []                 # type: List[str]
-        self.tables = []                    # type: List[Table]
-        self.next_table_colspec = None      # type: str
-        self.bodystack = []                 # type: List[List[str]]
-        self.footnote_restricted = None     # type: nodes.Element
-        self.pending_footnotes = []         # type: List[nodes.footnote_reference]
-        self.curfilestack = []              # type: List[str]
-        self.handled_abbrs = set()          # type: Set[str]
+        self.context: List[Any] = []
+        self.descstack: List[str] = []
+        self.tables: List[Table] = []
+        self.next_table_colspec: str = None
+        self.bodystack: List[List[str]] = []
+        self.footnote_restricted: Element = None
+        self.pending_footnotes: List[nodes.footnote_reference] = []
+        self.curfilestack: List[str] = []
+        self.handled_abbrs: Set[str] = set()
 
     def pushbody(self, newbody: List[str]) -> None:
         self.bodystack.append(self.body)
@@ -1228,9 +1226,8 @@ def is_inline(self, node: Element) -> bool:
         return isinstance(node.parent, nodes.TextElement)
 
     def visit_image(self, node: Element) -> None:
-        pre = []    # type: List[str]
-                    # in reverse order
-        post = []   # type: List[str]
+        pre: List[str] = []  # in reverse order
+        post: List[str] = []
         include_graphics_options = []
         has_hyperlink = isinstance(node.parent, nodes.reference)
         if has_hyperlink:
@@ -1441,7 +1438,7 @@ def add_target(id: str) -> None:
             self.body.append(self.hypertarget(id, anchor=anchor))
 
         # skip if visitor for next node supports hyperlink
-        next_node = node  # type: nodes.Node
+        next_node: Node = node
         while isinstance(next_node, nodes.target):
             next_node = next_node.next_node(ascend=True)
 
diff --git a/sphinx/writers/manpage.py b/sphinx/writers/manpage.py
index 917a71b3b0b..c11c4989268 100644
--- a/sphinx/writers/manpage.py
+++ b/sphinx/writers/manpage.py
@@ -73,7 +73,7 @@ class ManualPageTranslator(SphinxTranslator, BaseTranslator):
     Custom translator.
     """
 
-    _docinfo = {}  # type: Dict[str, Any]
+    _docinfo: Dict[str, Any] = {}
 
     def __init__(self, document: nodes.document, builder: Builder) -> None:
         super().__init__(document, builder)
diff --git a/sphinx/writers/texinfo.py b/sphinx/writers/texinfo.py
index d9187429994..cad6f3685b8 100644
--- a/sphinx/writers/texinfo.py
+++ b/sphinx/writers/texinfo.py
@@ -117,17 +117,17 @@ class TexinfoWriter(writers.Writer):
     """Texinfo writer for generating Texinfo documents."""
     supported = ('texinfo', 'texi')
 
-    settings_spec = (
+    settings_spec: Tuple[str, Any, Tuple[Tuple[str, List[str], Dict[str, str]], ...]] = (
         'Texinfo Specific Options', None, (
             ("Name of the Info file", ['--texinfo-filename'], {'default': ''}),
             ('Dir entry', ['--texinfo-dir-entry'], {'default': ''}),
             ('Description', ['--texinfo-dir-description'], {'default': ''}),
             ('Category', ['--texinfo-dir-category'], {'default':
-                                                      'Miscellaneous'})))  # type: Tuple[str, Any, Tuple[Tuple[str, List[str], Dict[str, str]], ...]]  # NOQA
+                                                      'Miscellaneous'})))
 
-    settings_defaults = {}  # type: Dict
+    settings_defaults: Dict = {}
 
-    output = None  # type: str
+    output: str = None
 
     visitor_attributes = ('output', 'fragment')
 
@@ -146,7 +146,7 @@ def translate(self) -> None:
 
 class TexinfoTranslator(SphinxTranslator):
 
-    builder = None  # type: TexinfoBuilder
+    builder: "TexinfoBuilder" = None
     ignore_missing_images = False
 
     default_elements = {
@@ -168,40 +168,34 @@ def __init__(self, document: nodes.document, builder: "TexinfoBuilder") -> None:
         super().__init__(document, builder)
         self.init_settings()
 
-        self.written_ids = set()        # type: Set[str]
-                                        # node names and anchors in output
+        self.written_ids: Set[str] = set()          # node names and anchors in output
         # node names and anchors that should be in output
-        self.referenced_ids = set()     # type: Set[str]
-        self.indices = []               # type: List[Tuple[str, str]]
-                                        # (node name, content)
-        self.short_ids = {}             # type: Dict[str, str]
-                                        # anchors --> short ids
-        self.node_names = {}            # type: Dict[str, str]
-                                        # node name --> node's name to display
-        self.node_menus = {}            # type: Dict[str, List[str]]
-                                        # node name --> node's menu entries
-        self.rellinks = {}              # type: Dict[str, List[str]]
-                                        # node name --> (next, previous, up)
+        self.referenced_ids: Set[str] = set()
+        self.indices: List[Tuple[str, str]] = []    # (node name, content)
+        self.short_ids: Dict[str, str] = {}         # anchors --> short ids
+        self.node_names: Dict[str, str] = {}        # node name --> node's name to display
+        self.node_menus: Dict[str, List[str]] = {}  # node name --> node's menu entries
+        self.rellinks: Dict[str, List[str]] = {}    # node name --> (next, previous, up)
 
         self.collect_indices()
         self.collect_node_names()
         self.collect_node_menus()
         self.collect_rellinks()
 
-        self.body = []                  # type: List[str]
-        self.context = []               # type: List[str]
-        self.descs = []                 # type: List[addnodes.desc]
-        self.previous_section = None    # type: nodes.section
+        self.body: List[str] = []
+        self.context: List[str] = []
+        self.descs: List[addnodes.desc] = []
+        self.previous_section: nodes.section = None
         self.section_level = 0
         self.seen_title = False
-        self.next_section_ids = set()   # type: Set[str]
+        self.next_section_ids: Set[str] = set()
         self.escape_newlines = 0
         self.escape_hyphens = 0
-        self.curfilestack = []          # type: List[str]
-        self.footnotestack = []         # type: List[Dict[str, List[Union[collected_footnote, bool]]]]  # NOQA
+        self.curfilestack: List[str] = []
+        self.footnotestack: List[Dict[str, List[Union[collected_footnote, bool]]]] = []  # NOQA
         self.in_footnote = 0
-        self.handled_abbrs = set()      # type: Set[str]
-        self.colwidths = None           # type: List[int]
+        self.handled_abbrs: Set[str] = set()
+        self.colwidths: List[int] = None
 
     def finish(self) -> None:
         if self.previous_section is None:
@@ -240,7 +234,7 @@ def init_settings(self) -> None:
                                             language=self.config.language))
         })
         # title
-        title = self.settings.title  # type: str
+        title: str = self.settings.title
         if not title:
             title_node = self.document.next_node(nodes.title)
             title = title_node.astext() if title_node else '<untitled>'
@@ -299,7 +293,7 @@ def add_node_name(name: str) -> str:
     def collect_node_menus(self) -> None:
         """Collect the menu entries for each "node" section."""
         node_menus = self.node_menus
-        targets = [self.document]  # type: List[Element]
+        targets: List[Element] = [self.document]
         targets.extend(self.document.traverse(nodes.section))
         for node in targets:
             assert 'node_name' in node and node['node_name']
@@ -517,7 +511,7 @@ def footnotes_under(n: Element) -> Iterator[nodes.footnote]:
                         continue
                     elif isinstance(c, nodes.Element):
                         yield from footnotes_under(c)
-        fnotes = {}  # type: Dict[str, List[Union[collected_footnote, bool]]]
+        fnotes: Dict[str, List[Union[collected_footnote, bool]]] = {}
         for fn in footnotes_under(node):
             label = cast(nodes.label, fn[0])
             num = label.astext().strip()
diff --git a/sphinx/writers/text.py b/sphinx/writers/text.py
index 274a35d5734..5bd96de7689 100644
--- a/sphinx/writers/text.py
+++ b/sphinx/writers/text.py
@@ -33,11 +33,11 @@ class Cell:
     """
     def __init__(self, text: str = "", rowspan: int = 1, colspan: int = 1) -> None:
         self.text = text
-        self.wrapped = []  # type: List[str]
+        self.wrapped: List[str] = []
         self.rowspan = rowspan
         self.colspan = colspan
-        self.col = None  # type: Optional[int]
-        self.row = None  # type: Optional[int]
+        self.col: Optional[int] = None
+        self.row: Optional[int] = None
 
     def __repr__(self) -> str:
         return "<Cell {!r} {}v{}/{}>{}>".format(
@@ -98,10 +98,9 @@ class Table:
 
     """
     def __init__(self, colwidth: List[int] = None) -> None:
-        self.lines = []  # type: List[List[Cell]]
+        self.lines: List[List[Cell]] = []
         self.separator = 0
-        self.colwidth = (colwidth if colwidth is not None
-                         else [])  # type: List[int]
+        self.colwidth: List[int] = (colwidth if colwidth is not None else [])
         self.current_line = 0
         self.current_col = 0
 
@@ -168,7 +167,7 @@ def cell_width(self, cell: Cell, source: List[int]) -> int:
 
     @property
     def cells(self) -> Generator[Cell, None, None]:
-        seen = set()  # type: Set[Cell]
+        seen: Set[Cell] = set()
         for lineno, line in enumerate(self.lines):
             for colno, cell in enumerate(line):
                 if cell and cell not in seen:
@@ -205,7 +204,7 @@ def writesep(char: str = "-", lineno: Optional[int] = None) -> str:
             """Called on the line *before* lineno.
             Called with no *lineno* for the last sep.
             """
-            out = []  # type: List[str]
+            out: List[str] = []
             for colno, width in enumerate(self.measured_widths):
                 if (
                     lineno is not None and
@@ -267,7 +266,7 @@ def _wrap_chunks(self, chunks: List[str]) -> List[str]:
         The original _wrap_chunks uses len() to calculate width.
         This method respects wide/fullwidth characters for width adjustment.
         """
-        lines = []  # type: List[str]
+        lines: List[str] = []
         if self.width <= 0:
             raise ValueError("invalid width %r (must be > 0)" % self.width)
 
@@ -328,7 +327,7 @@ def _split(self, text: str) -> List[str]:
         """
         def split(t: str) -> List[str]:
             return super(TextWrapper, self)._split(t)
-        chunks = []  # type: List[str]
+        chunks: List[str] = []
         for chunk in split(text):
             for w, g in groupby(chunk, column_width):
                 if w == 1:
@@ -367,9 +366,9 @@ def my_wrap(text: str, width: int = MAXWIDTH, **kwargs: Any) -> List[str]:
 class TextWriter(writers.Writer):
     supported = ('text',)
     settings_spec = ('No options here.', '', ())
-    settings_defaults = {}  # type: Dict
+    settings_defaults: Dict = {}
 
-    output = None  # type: str
+    output: str = None
 
     def __init__(self, builder: "TextBuilder") -> None:
         super().__init__()
@@ -382,7 +381,7 @@ def translate(self) -> None:
 
 
 class TextTranslator(SphinxTranslator):
-    builder = None  # type: TextBuilder
+    builder: "TextBuilder" = None
 
     def __init__(self, document: nodes.document, builder: "TextBuilder") -> None:
         super().__init__(document, builder)
@@ -397,12 +396,12 @@ def __init__(self, document: nodes.document, builder: "TextBuilder") -> None:
         self.sectionchars = self.config.text_sectionchars
         self.add_secnumbers = self.config.text_add_secnumbers
         self.secnumber_suffix = self.config.text_secnumber_suffix
-        self.states = [[]]      # type: List[List[Tuple[int, Union[str, List[str]]]]]
+        self.states: List[List[Tuple[int, Union[str, List[str]]]]] = [[]]
         self.stateindent = [0]
-        self.list_counter = []  # type: List[int]
+        self.list_counter: List[int] = []
         self.sectionlevel = 0
         self.lineblocklevel = 0
-        self.table = None       # type: Table
+        self.table: Table = None
 
     def add_text(self, text: str) -> None:
         self.states[-1].append((-1, text))
@@ -415,8 +414,8 @@ def end_state(self, wrap: bool = True, end: List[str] = [''], first: str = None)
         content = self.states.pop()
         maxindent = sum(self.stateindent)
         indent = self.stateindent.pop()
-        result = []     # type: List[Tuple[int, List[str]]]
-        toformat = []   # type: List[str]
+        result: List[Tuple[int, List[str]]] = []
+        toformat: List[str] = []
 
         def do_format() -> None:
             if not toformat:

From aeb9e42d2be2b697879120b18a6380edf934e80b Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 13 Mar 2021 16:30:59 +0900
Subject: [PATCH 188/305] refactor: Use PEP-526 based variable annotation
 (sphinx.builders)

---
 sphinx/builders/__init__.py         | 21 ++++++++--------
 sphinx/builders/_epub_base.py       | 16 ++++++------
 sphinx/builders/changes.py          |  6 ++---
 sphinx/builders/epub3.py            |  6 ++---
 sphinx/builders/gettext.py          | 13 +++++-----
 sphinx/builders/html/__init__.py    | 39 ++++++++++++++---------------
 sphinx/builders/latex/__init__.py   | 16 ++++++------
 sphinx/builders/latex/constants.py  |  8 +++---
 sphinx/builders/latex/theming.py    |  2 +-
 sphinx/builders/latex/transforms.py | 20 +++++++--------
 sphinx/builders/linkcheck.py        | 30 +++++++++++-----------
 sphinx/builders/manpage.py          |  8 +++---
 sphinx/builders/singlehtml.py       |  4 +--
 sphinx/builders/texinfo.py          |  3 ++-
 sphinx/builders/text.py             |  4 +--
 sphinx/builders/xml.py              |  2 +-
 16 files changed, 98 insertions(+), 100 deletions(-)

diff --git a/sphinx/builders/__init__.py b/sphinx/builders/__init__.py
index c4ac432e421..5128b016daa 100644
--- a/sphinx/builders/__init__.py
+++ b/sphinx/builders/__init__.py
@@ -63,7 +63,7 @@ class Builder:
 
     #: default translator class for the builder.  This can be overridden by
     #: :py:meth:`app.set_translator()`.
-    default_translator_class = None  # type: Type[nodes.NodeVisitor]
+    default_translator_class: Type[nodes.NodeVisitor] = None
     # doctree versioning method
     versioning_method = 'none'
     versioning_compare = False
@@ -74,7 +74,7 @@ class Builder:
 
     #: The list of MIME types of image formats supported by the builder.
     #: Image files are searched in the order in which they appear here.
-    supported_image_types = []  # type: List[str]
+    supported_image_types: List[str] = []
     #: The builder supports remote images or not.
     supported_remote_images = False
     #: The builder supports data URIs or not.
@@ -87,18 +87,18 @@ def __init__(self, app: "Sphinx") -> None:
         self.doctreedir = app.doctreedir
         ensuredir(self.doctreedir)
 
-        self.app = app              # type: Sphinx
-        self.env = None             # type: BuildEnvironment
-        self.events = app.events    # type: EventManager
-        self.config = app.config    # type: Config
-        self.tags = app.tags        # type: Tags
+        self.app: Sphinx = app
+        self.env: BuildEnvironment = None
+        self.events: EventManager = app.events
+        self.config: Config = app.config
+        self.tags: Tags = app.tags
         self.tags.add(self.format)
         self.tags.add(self.name)
         self.tags.add("format_%s" % self.format)
         self.tags.add("builder_%s" % self.name)
 
         # images that need to be copied over (source -> dest)
-        self.images = {}  # type: Dict[str, str]
+        self.images: Dict[str, str] = {}
         # basename of images directory
         self.imagedir = ""
         # relative path to image directory from current docname (used at writing docs)
@@ -106,7 +106,7 @@ def __init__(self, app: "Sphinx") -> None:
 
         # these get set later
         self.parallel_ok = False
-        self.finish_tasks = None  # type: Any
+        self.finish_tasks: Any = None
 
     def set_environment(self, env: BuildEnvironment) -> None:
         """Store BuildEnvironment object."""
@@ -261,8 +261,7 @@ def build_specific(self, filenames: List[str]) -> None:
         # relative to the source directory and without source_suffix.
         dirlen = len(self.srcdir) + 1
         to_write = []
-        suffixes = None  # type: Tuple[str]
-        suffixes = tuple(self.config.source_suffix)  # type: ignore
+        suffixes: Tuple[str] = tuple(self.config.source_suffix)  # type: ignore
         for filename in filenames:
             filename = path.normpath(path.abspath(filename))
             if not filename.startswith(self.srcdir):
diff --git a/sphinx/builders/_epub_base.py b/sphinx/builders/_epub_base.py
index 3b19bb8d06e..65fb1ff9a36 100644
--- a/sphinx/builders/_epub_base.py
+++ b/sphinx/builders/_epub_base.py
@@ -165,9 +165,9 @@ def init(self) -> None:
         self.link_suffix = '.xhtml'
         self.playorder = 0
         self.tocid = 0
-        self.id_cache = {}  # type: Dict[str, str]
+        self.id_cache: Dict[str, str] = {}
         self.use_index = self.get_builder_config('use_index', 'epub')
-        self.refnodes = []  # type: List[Dict[str, Any]]
+        self.refnodes: List[Dict[str, Any]] = []
 
     def create_build_info(self) -> BuildInfo:
         return BuildInfo(self.config, self.tags, ['html', 'epub'])
@@ -209,7 +209,7 @@ def get_refnodes(self, doctree: Node, result: List[Dict[str, Any]]) -> List[Dict
         return result
 
     def check_refnodes(self, nodes: List[Dict[str, Any]]) -> None:
-        appeared = set()  # type: Set[str]
+        appeared: Set[str] = set()
         for node in nodes:
             if node['refuri'] in appeared:
                 logger.warning(
@@ -288,7 +288,7 @@ def update_node_id(node: Element) -> None:
         for target in tree.traverse(nodes.target):
             update_node_id(target)
 
-            next_node = target.next_node(ascend=True)  # type: Node
+            next_node: Node = target.next_node(ascend=True)
             if isinstance(next_node, nodes.Element):
                 update_node_id(next_node)
 
@@ -482,7 +482,7 @@ def content_metadata(self) -> Dict[str, Any]:
         """Create a dictionary with all metadata for the content.opf
         file properly escaped.
         """
-        metadata = {}  # type: Dict[str, Any]
+        metadata: Dict[str, Any] = {}
         metadata['title'] = html.escape(self.config.epub_title)
         metadata['author'] = html.escape(self.config.epub_author)
         metadata['uid'] = html.escape(self.config.epub_uid)
@@ -508,7 +508,7 @@ def build_content(self) -> None:
         if not self.outdir.endswith(os.sep):
             self.outdir += os.sep
         olen = len(self.outdir)
-        self.files = []  # type: List[str]
+        self.files: List[str] = []
         self.ignored_files = ['.buildinfo', 'mimetype', 'content.opf',
                               'toc.ncx', 'META-INF/container.xml',
                               'Thumbs.db', 'ehthumbs.db', '.DS_Store',
@@ -623,7 +623,7 @@ def build_navpoints(self, nodes: List[Dict[str, Any]]) -> List[NavPoint]:
         Subelements of a node are nested inside the navpoint.  For nested nodes
         the parent node is reinserted in the subnav.
         """
-        navstack = []  # type: List[NavPoint]
+        navstack: List[NavPoint] = []
         navstack.append(NavPoint('dummy', 0, '', '', []))
         level = 0
         lastnode = None
@@ -665,7 +665,7 @@ def toc_metadata(self, level: int, navpoints: List[NavPoint]) -> Dict[str, Any]:
         """Create a dictionary with all metadata for the toc.ncx file
         properly escaped.
         """
-        metadata = {}  # type: Dict[str, Any]
+        metadata: Dict[str, Any] = {}
         metadata['uid'] = self.config.epub_uid
         metadata['title'] = html.escape(self.config.epub_title)
         metadata['level'] = level
diff --git a/sphinx/builders/changes.py b/sphinx/builders/changes.py
index 87dd03fb84a..5e51499f950 100644
--- a/sphinx/builders/changes.py
+++ b/sphinx/builders/changes.py
@@ -51,9 +51,9 @@ def get_outdated_docs(self) -> str:
     def write(self, *ignored: Any) -> None:
         version = self.config.version
         domain = cast(ChangeSetDomain, self.env.get_domain('changeset'))
-        libchanges = {}     # type: Dict[str, List[Tuple[str, str, int]]]
-        apichanges = []     # type: List[Tuple[str, str, int]]
-        otherchanges = {}   # type: Dict[Tuple[str, str], List[Tuple[str, str, int]]]
+        libchanges: Dict[str, List[Tuple[str, str, int]]] = {}
+        apichanges: List[Tuple[str, str, int]] = []
+        otherchanges: Dict[Tuple[str, str], List[Tuple[str, str, int]]] = {}
 
         changesets = domain.get_changesets_for(version)
         if not changesets:
diff --git a/sphinx/builders/epub3.py b/sphinx/builders/epub3.py
index 623ee45a45d..be69e87ef09 100644
--- a/sphinx/builders/epub3.py
+++ b/sphinx/builders/epub3.py
@@ -118,7 +118,7 @@ def build_navlist(self, navnodes: List[Dict[str, Any]]) -> List[NavPoint]:
         The difference from build_navpoints method is templates which are used
         when generating navigation documents.
         """
-        navstack = []  # type: List[NavPoint]
+        navstack: List[NavPoint] = []
         navstack.append(NavPoint('', '', []))
         level = 0
         for node in navnodes:
@@ -154,7 +154,7 @@ def navigation_doc_metadata(self, navlist: List[NavPoint]) -> Dict:
         """Create a dictionary with all metadata for the nav.xhtml file
         properly escaped.
         """
-        metadata = {}  # type: Dict
+        metadata: Dict = {}
         metadata['lang'] = html.escape(self.config.epub_language)
         metadata['toc_locale'] = html.escape(self.guide_titles['toc'])
         metadata['navlist'] = navlist
@@ -223,7 +223,7 @@ def validate_config_values(app: Sphinx) -> None:
 
 def convert_epub_css_files(app: Sphinx, config: Config) -> None:
     """This converts string styled epub_css_files to tuple styled one."""
-    epub_css_files = []  # type: List[Tuple[str, Dict]]
+    epub_css_files: List[Tuple[str, Dict]] = []
     for entry in config.epub_css_files:
         if isinstance(entry, str):
             epub_css_files.append((entry, {}))
diff --git a/sphinx/builders/gettext.py b/sphinx/builders/gettext.py
index 78ae06b74d5..be178ca244d 100644
--- a/sphinx/builders/gettext.py
+++ b/sphinx/builders/gettext.py
@@ -48,10 +48,10 @@ class Catalog:
     """Catalog of translatable messages."""
 
     def __init__(self) -> None:
-        self.messages = []  # type: List[str]
-                            # retain insertion order, a la OrderedDict
-        self.metadata = OrderedDict()   # type: Dict[str, List[Tuple[str, int, str]]]
-                                        # msgid -> file, line, uid
+        self.messages: List[str] = []  # retain insertion order, a la OrderedDict
+
+        # msgid -> file, line, uid
+        self.metadata: Dict[str, List[Tuple[str, int, str]]] = OrderedDict()
 
     def add(self, msg: str, origin: Union[Element, "MsgOrigin"]) -> None:
         if not hasattr(origin, 'uid'):
@@ -121,8 +121,7 @@ class I18nBuilder(Builder):
     """
     name = 'i18n'
     versioning_method = 'text'
-    versioning_compare = None   # type: bool
-                                # be set by `gettext_uuid`
+    versioning_compare: bool = None  # be set by `gettext_uuid`
     use_message_catalog = False
 
     def init(self) -> None:
@@ -130,7 +129,7 @@ def init(self) -> None:
         self.env.set_versioning_method(self.versioning_method,
                                        self.env.config.gettext_uuid)
         self.tags = I18nTags()
-        self.catalogs = defaultdict(Catalog)  # type: DefaultDict[str, Catalog]
+        self.catalogs: DefaultDict[str, Catalog] = defaultdict(Catalog)
 
     def get_target_uri(self, docname: str, typ: str = None) -> str:
         return ''
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 115f7353816..a62e46b438f 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -82,9 +82,9 @@ class Stylesheet(str):
     its filename (str).
     """
 
-    attributes = None   # type: Dict[str, str]
-    filename = None     # type: str
-    priority = None     # type: int
+    attributes: Dict[str, str] = None
+    filename: str = None
+    priority: int = None
 
     def __new__(cls, filename: str, *args: str, priority: int = 500, **attributes: Any
                 ) -> "Stylesheet":
@@ -108,9 +108,9 @@ class JavaScript(str):
     its filename (str).
     """
 
-    attributes = None   # type: Dict[str, str]
-    filename = None     # type: str
-    priority = None     # type: int
+    attributes: Dict[str, str] = None
+    filename: str = None
+    priority: int = None
 
     def __new__(cls, filename: str, priority: int = 500, **attributes: str) -> "JavaScript":
         self = str.__new__(cls, filename)
@@ -179,7 +179,7 @@ class StandaloneHTMLBuilder(Builder):
     allow_parallel = True
     out_suffix = '.html'
     link_suffix = '.html'  # defaults to matching out_suffix
-    indexer_format = js_index  # type: Any
+    indexer_format: Any = js_index
     indexer_dumps_unicode = True
     # create links to original images from images [True/False]
     html_scaled_image_link = True
@@ -195,26 +195,26 @@ class StandaloneHTMLBuilder(Builder):
     use_index = False
     download_support = True  # enable download role
 
-    imgpath = None          # type: str
-    domain_indices = []     # type: List[Tuple[str, Type[Index], List[Tuple[str, List[IndexEntry]]], bool]]  # NOQA
+    imgpath: str = None
+    domain_indices: List[Tuple[str, Type[Index], List[Tuple[str, List[IndexEntry]]], bool]] = []  # NOQA
 
     def __init__(self, app: Sphinx) -> None:
         super().__init__(app)
 
         # CSS files
-        self.css_files = []  # type: List[Dict[str, str]]
+        self.css_files: List[Dict[str, str]] = []
 
         # JS files
-        self.script_files = []  # type: List[JavaScript]
+        self.script_files: List[JavaScript] = []
 
     def init(self) -> None:
         self.build_info = self.create_build_info()
         # basename of images directory
         self.imagedir = '_images'
         # section numbers for headings in the currently visited document
-        self.secnumbers = {}  # type: Dict[str, Tuple[int, ...]]
+        self.secnumbers: Dict[str, Tuple[int, ...]] = {}
         # currently written docname
-        self.current_docname = None  # type: str
+        self.current_docname: str = None
 
         self.init_templates()
         self.init_highlighter()
@@ -436,10 +436,10 @@ def prepare_writing(self, docnames: Set[str]) -> None:
             self.load_indexer(docnames)
 
         self.docwriter = HTMLWriter(self)
-        self.docsettings = OptionParser(
+        self.docsettings: Any = OptionParser(
             defaults=self.env.settings,
             components=(self.docwriter,),
-            read_config_files=True).get_default_values()  # type: Any
+            read_config_files=True).get_default_values()
         self.docsettings.compact_lists = bool(self.config.html_compact_lists)
 
         # determine the additional indices to include
@@ -448,8 +448,7 @@ def prepare_writing(self, docnames: Set[str]) -> None:
         indices_config = self.config.html_domain_indices
         if indices_config:
             for domain_name in sorted(self.env.domains):
-                domain = None  # type: Domain
-                domain = self.env.domains[domain_name]
+                domain: Domain = self.env.domains[domain_name]
                 for indexcls in domain.indices:
                     indexname = '%s-%s' % (domain.name, indexcls.name)
                     if isinstance(indices_config, list):
@@ -474,7 +473,7 @@ def prepare_writing(self, docnames: Set[str]) -> None:
 
         self.relations = self.env.collect_relations()
 
-        rellinks = []  # type: List[Tuple[str, str, str, str]]
+        rellinks: List[Tuple[str, str, str, str]] = []
         if self.use_index:
             rellinks.append(('genindex', _('General Index'), 'I', _('index')))
         for indexname, indexcls, content, collapse in self.domain_indices:
@@ -1109,7 +1108,7 @@ def dump_search_index(self) -> None:
 
 def convert_html_css_files(app: Sphinx, config: Config) -> None:
     """This converts string styled html_css_files to tuple styled one."""
-    html_css_files = []  # type: List[Tuple[str, Dict]]
+    html_css_files: List[Tuple[str, Dict]] = []
     for entry in config.html_css_files:
         if isinstance(entry, str):
             html_css_files.append((entry, {}))
@@ -1126,7 +1125,7 @@ def convert_html_css_files(app: Sphinx, config: Config) -> None:
 
 def convert_html_js_files(app: Sphinx, config: Config) -> None:
     """This converts string styled html_js_files to tuple styled one."""
-    html_js_files = []  # type: List[Tuple[str, Dict]]
+    html_js_files: List[Tuple[str, Dict]] = []
     for entry in config.html_js_files:
         if isinstance(entry, str):
             html_js_files.append((entry, {}))
diff --git a/sphinx/builders/latex/__init__.py b/sphinx/builders/latex/__init__.py
index e1945422e8d..a37a35e61de 100644
--- a/sphinx/builders/latex/__init__.py
+++ b/sphinx/builders/latex/__init__.py
@@ -122,10 +122,10 @@ class LaTeXBuilder(Builder):
     default_translator_class = LaTeXTranslator
 
     def init(self) -> None:
-        self.babel = None           # type: ExtBabel
-        self.context = {}           # type: Dict[str, Any]
-        self.docnames = []          # type: Iterable[str]
-        self.document_data = []     # type: List[Tuple[str, str, str, str, str, bool]]
+        self.babel: ExtBabel = None
+        self.context: Dict[str, Any] = {}
+        self.docnames: Iterable[str] = {}
+        self.document_data: List[Tuple[str, str, str, str, str, bool]] = []
         self.themes = ThemeFactory(self.app)
         texescape.init()
 
@@ -153,7 +153,7 @@ def init_document_data(self) -> None:
                               'will be written'))
             return
         # assign subdirs to titles
-        self.titles = []  # type: List[Tuple[str, str]]
+        self.titles: List[Tuple[str, str]] = []
         for entry in preliminary_document_data:
             docname = entry[0]
             if docname not in self.env.all_docs:
@@ -262,10 +262,10 @@ def write_stylesheet(self) -> None:
 
     def write(self, *ignored: Any) -> None:
         docwriter = LaTeXWriter(self)
-        docsettings = OptionParser(
+        docsettings: Any = OptionParser(
             defaults=self.env.settings,
             components=(docwriter,),
-            read_config_files=True).get_default_values()  # type: Any
+            read_config_files=True).get_default_values()
 
         self.init_document_data()
         self.write_stylesheet()
@@ -356,7 +356,7 @@ def assemble_doctree(self, indexfile: str, toctree_only: bool, appendices: List[
         for pendingnode in largetree.traverse(addnodes.pending_xref):
             docname = pendingnode['refdocname']
             sectname = pendingnode['refsectname']
-            newnodes = [nodes.emphasis(sectname, sectname)]  # type: List[Node]
+            newnodes: List[Node] = [nodes.emphasis(sectname, sectname)]
             for subdir, title in self.titles:
                 if docname.startswith(subdir):
                     newnodes.append(nodes.Text(_(' (in '), _(' (in ')))
diff --git a/sphinx/builders/latex/constants.py b/sphinx/builders/latex/constants.py
index e929736a75f..f5e69225d00 100644
--- a/sphinx/builders/latex/constants.py
+++ b/sphinx/builders/latex/constants.py
@@ -71,7 +71,7 @@
 
 LUALATEX_DEFAULT_FONTPKG = XELATEX_DEFAULT_FONTPKG
 
-DEFAULT_SETTINGS = {
+DEFAULT_SETTINGS: Dict[str, Any] = {
     'latex_engine':    'pdflatex',
     'papersize':       '',
     'pointsize':       '',
@@ -121,9 +121,9 @@
     'figure_align':    'htbp',
     'tocdepth':        '',
     'secnumdepth':     '',
-}  # type: Dict[str, Any]
+}
 
-ADDITIONAL_SETTINGS = {
+ADDITIONAL_SETTINGS: Dict[Any, Dict[str, Any]] = {
     'pdflatex': {
         'inputenc':     '\\usepackage[utf8]{inputenc}',
         'utf8extra':   ('\\ifdefined\\DeclareUnicodeCharacter\n'
@@ -202,7 +202,7 @@
     ('xelatex', 'el'): {
         'fontpkg':      XELATEX_GREEK_DEFAULT_FONTPKG,
     },
-}  # type: Dict[Any, Dict[str, Any]]
+}
 
 
 SHORTHANDOFF = r'''
diff --git a/sphinx/builders/latex/theming.py b/sphinx/builders/latex/theming.py
index 5af79e8a234..d5c53a58ba3 100644
--- a/sphinx/builders/latex/theming.py
+++ b/sphinx/builders/latex/theming.py
@@ -106,7 +106,7 @@ class ThemeFactory:
     """A factory class for LaTeX Themes."""
 
     def __init__(self, app: Sphinx) -> None:
-        self.themes = {}  # type: Dict[str, Theme]
+        self.themes: Dict[str, Theme] = {}
         self.theme_paths = [path.join(app.srcdir, p) for p in app.config.latex_theme_path]
         self.config = app.config
         self.load_builtin_themes(app.config)
diff --git a/sphinx/builders/latex/transforms.py b/sphinx/builders/latex/transforms.py
index 0a74eded488..a07393690dd 100644
--- a/sphinx/builders/latex/transforms.py
+++ b/sphinx/builders/latex/transforms.py
@@ -33,7 +33,7 @@ class FootnoteDocnameUpdater(SphinxTransform):
 
     def apply(self, **kwargs: Any) -> None:
         matcher = NodeMatcher(*self.TARGET_NODES)
-        for node in self.document.traverse(matcher):  # type: nodes.Element
+        for node in self.document.traverse(matcher):  # type: Element
             node['docname'] = self.env.docname
 
 
@@ -65,7 +65,7 @@ class ShowUrlsTransform(SphinxPostTransform):
     def run(self, **kwargs: Any) -> None:
         try:
             # replace id_prefix temporarily
-            settings = self.document.settings  # type: Any
+            settings: Any = self.document.settings
             id_prefix = settings.id_prefix
             settings.id_prefix = 'show_urls'
 
@@ -157,9 +157,9 @@ class FootnoteCollector(nodes.NodeVisitor):
     """Collect footnotes and footnote references on the document"""
 
     def __init__(self, document: nodes.document) -> None:
-        self.auto_footnotes = []            # type: List[nodes.footnote]
-        self.used_footnote_numbers = set()  # type: Set[str]
-        self.footnote_refs = []             # type: List[nodes.footnote_reference]
+        self.auto_footnotes: List[nodes.footnote] = []
+        self.used_footnote_numbers: Set[str] = set()
+        self.footnote_refs: List[nodes.footnote_reference] = []
         super().__init__(document)
 
     def unknown_visit(self, node: Node) -> None:
@@ -358,11 +358,11 @@ def run(self, **kwargs: Any) -> None:
 
 class LaTeXFootnoteVisitor(nodes.NodeVisitor):
     def __init__(self, document: nodes.document, footnotes: List[nodes.footnote]) -> None:
-        self.appeared = set()       # type: Set[Tuple[str, str]]
-        self.footnotes = footnotes  # type: List[nodes.footnote]
-        self.pendings = []          # type: List[nodes.footnote]
-        self.table_footnotes = []   # type: List[nodes.footnote]
-        self.restricted = None      # type: nodes.Element
+        self.appeared: Set[Tuple[str, str]] = set()
+        self.footnotes: List[nodes.footnote] = footnotes
+        self.pendings: List[nodes.footnote] = []
+        self.table_footnotes: List[nodes.footnote] = []
+        self.restricted: Element = None
         super().__init__(document)
 
     def unknown_visit(self, node: Node) -> None:
diff --git a/sphinx/builders/linkcheck.py b/sphinx/builders/linkcheck.py
index bd81bcee6df..05e12c1730e 100644
--- a/sphinx/builders/linkcheck.py
+++ b/sphinx/builders/linkcheck.py
@@ -9,7 +9,6 @@
 """
 
 import json
-import queue
 import re
 import socket
 import time
@@ -18,6 +17,7 @@
 from email.utils import parsedate_to_datetime
 from html.parser import HTMLParser
 from os import path
+from queue import PriorityQueue, Queue
 from threading import Thread
 from typing import (Any, Dict, Generator, List, NamedTuple, Optional, Pattern, Set, Tuple,
                     Union, cast)
@@ -120,16 +120,16 @@ class CheckExternalLinksBuilder(DummyBuilder):
                 '%(outdir)s/output.txt')
 
     def init(self) -> None:
-        self.hyperlinks = {}    # type: Dict[str, Hyperlink]
-        self._good = set()       # type: Set[str]
-        self._broken = {}        # type: Dict[str, str]
-        self._redirected = {}    # type: Dict[str, Tuple[str, int]]
+        self.hyperlinks: Dict[str, Hyperlink] = {}
+        self._good: Set[str] = set()
+        self._broken: Dict[str, str] = {}
+        self._redirected: Dict[str, Tuple[str, int]] = {}
         # set a timeout for non-responding servers
         socket.setdefaulttimeout(5.0)
 
         # create queues and worker threads
-        self._wqueue = queue.PriorityQueue()  # type: queue.PriorityQueue[CheckRequestType]
-        self._rqueue = queue.Queue()  # type: queue.Queue
+        self._wqueue: PriorityQueue[CheckRequestType] = PriorityQueue()
+        self._rqueue: Queue = Queue()
 
     @property
     def anchors_ignore(self) -> List[Pattern]:
@@ -204,7 +204,7 @@ def limit_rate(self, response: Response) -> Optional[float]:
                                                   None, None, {})
         return worker.limit_rate(response)
 
-    def rqueue(self, response: Response) -> queue.Queue:
+    def rqueue(self, response: Response) -> Queue:
         warnings.warn(
             "%s.%s is deprecated." % (self.__class__.__name__, "rqueue"),
             RemovedInSphinx50Warning,
@@ -220,7 +220,7 @@ def workers(self, response: Response) -> List[Thread]:
         )
         return []
 
-    def wqueue(self, response: Response) -> queue.Queue:
+    def wqueue(self, response: Response) -> Queue:
         warnings.warn(
             "%s.%s is deprecated." % (self.__class__.__name__, "wqueue"),
             RemovedInSphinx50Warning,
@@ -313,8 +313,8 @@ def __init__(self, env: BuildEnvironment, config: Config,
         self.builder = builder
         self.config = config
         self.env = env
-        self.rate_limits = {}  # type: Dict[str, RateLimit]
-        self.workers = []  # type: List[Thread]
+        self.rate_limits: Dict[str, RateLimit] = {}
+        self.workers: List[Thread] = []
 
         self.to_ignore = [re.compile(x) for x in self.config.linkcheck_ignore]
 
@@ -322,8 +322,8 @@ def __init__(self, env: BuildEnvironment, config: Config,
             self.rqueue = builder._rqueue
             self.wqueue = builder._wqueue
         else:
-            self.rqueue = queue.Queue()
-            self.wqueue = queue.PriorityQueue()
+            self.rqueue = Queue()
+            self.wqueue = PriorityQueue()
 
     def invoke_threads(self) -> None:
         for i in range(self.config.linkcheck_workers):
@@ -364,8 +364,8 @@ def is_ignored_uri(self, uri: str) -> bool:
 class HyperlinkAvailabilityCheckWorker(Thread):
     """A worker class for checking the availability of hyperlinks."""
 
-    def __init__(self, env: BuildEnvironment, config: Config, rqueue: queue.Queue,
-                 wqueue: queue.Queue, rate_limits: Dict[str, RateLimit],
+    def __init__(self, env: BuildEnvironment, config: Config, rqueue: Queue,
+                 wqueue: Queue, rate_limits: Dict[str, RateLimit],
                  builder: CheckExternalLinksBuilder = None) -> None:
         # Warning: builder argument will be removed in the sphinx-5.0.
         # Don't use it from extensions.
diff --git a/sphinx/builders/manpage.py b/sphinx/builders/manpage.py
index f994309e1af..b993a2df490 100644
--- a/sphinx/builders/manpage.py
+++ b/sphinx/builders/manpage.py
@@ -38,7 +38,7 @@ class ManualPageBuilder(Builder):
     epilog = __('The manual pages are in %(outdir)s.')
 
     default_translator_class = ManualPageTranslator
-    supported_image_types = []  # type: List[str]
+    supported_image_types: List[str] = []
 
     def init(self) -> None:
         if not self.config.man_pages:
@@ -56,10 +56,10 @@ def get_target_uri(self, docname: str, typ: str = None) -> str:
     @progress_message(__('writing'))
     def write(self, *ignored: Any) -> None:
         docwriter = ManualPageWriter(self)
-        docsettings = OptionParser(
+        docsettings: Any = OptionParser(
             defaults=self.env.settings,
             components=(docwriter,),
-            read_config_files=True).get_default_values()  # type: Any
+            read_config_files=True).get_default_values()
 
         for info in self.config.man_pages:
             docname, name, description, authors, section = info
@@ -90,7 +90,7 @@ def write(self, *ignored: Any) -> None:
                 encoding='utf-8')
 
             tree = self.env.get_doctree(docname)
-            docnames = set()  # type: Set[str]
+            docnames: Set[str] = set()
             largetree = inline_all_toctrees(self, docnames, docname, tree,
                                             darkgreen, [docname])
             largetree.settings = docsettings
diff --git a/sphinx/builders/singlehtml.py b/sphinx/builders/singlehtml.py
index 1ef618dd0a2..03d25965b80 100644
--- a/sphinx/builders/singlehtml.py
+++ b/sphinx/builders/singlehtml.py
@@ -93,7 +93,7 @@ def assemble_toc_secnumbers(self) -> Dict[str, Dict[str, Tuple[int, ...]]]:
         #
         #       There are related codes in inline_all_toctres() and
         #       HTMLTranslter#add_secnumber().
-        new_secnumbers = {}  # type: Dict[str, Tuple[int, ...]]
+        new_secnumbers: Dict[str, Tuple[int, ...]] = {}
         for docname, secnums in self.env.toc_secnumbers.items():
             for id, secnum in secnums.items():
                 alias = "%s/%s" % (docname, id)
@@ -111,7 +111,7 @@ def assemble_toc_fignumbers(self) -> Dict[str, Dict[str, Dict[str, Tuple[int, ..
         #
         #       There are related codes in inline_all_toctres() and
         #       HTMLTranslter#add_fignumber().
-        new_fignumbers = {}  # type: Dict[str, Dict[str, Tuple[int, ...]]]
+        new_fignumbers: Dict[str, Dict[str, Tuple[int, ...]]] = {}
         # {'foo': {'figure': {'id2': (2,), 'id1': (1,)}}, 'bar': {'figure': {'id1': (3,)}}}
         for docname, fignumlist in self.env.toc_fignumbers.items():
             for figtype, fignums in fignumlist.items():
diff --git a/sphinx/builders/texinfo.py b/sphinx/builders/texinfo.py
index bb2039e61ef..8bd211f2245 100644
--- a/sphinx/builders/texinfo.py
+++ b/sphinx/builders/texinfo.py
@@ -15,6 +15,7 @@
 from docutils import nodes
 from docutils.frontend import OptionParser
 from docutils.io import FileOutput
+from docutils.nodes import Node
 
 from sphinx import addnodes, package_dir
 from sphinx.application import Sphinx
@@ -154,7 +155,7 @@ def assemble_doctree(self, indexfile: str, toctree_only: bool, appendices: List[
         for pendingnode in largetree.traverse(addnodes.pending_xref):
             docname = pendingnode['refdocname']
             sectname = pendingnode['refsectname']
-            newnodes = [nodes.emphasis(sectname, sectname)]  # type: List[nodes.Node]
+            newnodes: List[Node] = [nodes.emphasis(sectname, sectname)]
             for subdir, title in self.titles:
                 if docname.startswith(subdir):
                     newnodes.append(nodes.Text(_(' (in '), _(' (in ')))
diff --git a/sphinx/builders/text.py b/sphinx/builders/text.py
index ae770818c17..2ac1b287858 100644
--- a/sphinx/builders/text.py
+++ b/sphinx/builders/text.py
@@ -33,11 +33,11 @@ class TextBuilder(Builder):
     allow_parallel = True
     default_translator_class = TextTranslator
 
-    current_docname = None  # type: str
+    current_docname: str = None
 
     def init(self) -> None:
         # section numbers for headings in the currently visited document
-        self.secnumbers = {}  # type: Dict[str, Tuple[int, ...]]
+        self.secnumbers: Dict[str, Tuple[int, ...]] = {}
 
     def get_outdated_docs(self) -> Iterator[str]:
         for docname in self.env.found_docs:
diff --git a/sphinx/builders/xml.py b/sphinx/builders/xml.py
index 88dfe83a919..865820c364c 100644
--- a/sphinx/builders/xml.py
+++ b/sphinx/builders/xml.py
@@ -37,7 +37,7 @@ class XMLBuilder(Builder):
     out_suffix = '.xml'
     allow_parallel = True
 
-    _writer_class = XMLWriter  # type: Union[Type[XMLWriter], Type[PseudoXMLWriter]]
+    _writer_class: Union[Type[XMLWriter], Type[PseudoXMLWriter]] = XMLWriter
     default_translator_class = XMLTranslator
 
     def init(self) -> None:

From a523a896635b5fc5e48cd12a7c034ebcbc71a43b Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 13 Mar 2021 17:10:50 +0900
Subject: [PATCH 189/305] refactor: Add a type alias for the option_spec of
 directives; OptionSpec

---
 CHANGES                            |  1 +
 doc/extdev/deprecated.rst          |  5 +++++
 sphinx/directives/__init__.py      |  8 ++++----
 sphinx/directives/code.py          |  7 ++++---
 sphinx/directives/other.py         | 13 +++++++------
 sphinx/directives/patches.py       |  5 +++--
 sphinx/domains/c.py                | 13 +++++++------
 sphinx/domains/changeset.py        |  3 ++-
 sphinx/domains/cpp.py              | 13 +++++++------
 sphinx/domains/index.py            |  3 ++-
 sphinx/domains/javascript.py       |  5 +++--
 sphinx/domains/python.py           | 22 +++++++++++-----------
 sphinx/domains/rst.py              |  3 ++-
 sphinx/domains/std.py              | 10 +++++-----
 sphinx/ext/autodoc/__init__.py     | 18 ++++++++++--------
 sphinx/ext/autosummary/__init__.py |  3 ++-
 sphinx/ext/doctest.py              | 15 ++++++++++-----
 sphinx/ext/graphviz.py             |  5 +++--
 sphinx/ext/ifconfig.py             |  3 ++-
 sphinx/ext/inheritance_diagram.py  |  3 ++-
 sphinx/ext/todo.py                 |  5 +++--
 sphinx/util/typing.py              | 15 ++++++++++++---
 22 files changed, 107 insertions(+), 71 deletions(-)

diff --git a/CHANGES b/CHANGES
index d59dc9f52bd..4d5dc162376 100644
--- a/CHANGES
+++ b/CHANGES
@@ -57,6 +57,7 @@ Deprecated
 * ``sphinx.util.pycompat.convert_with_2to3()``
 * ``sphinx.util.pycompat.execfile_()``
 * ``sphinx.util.smartypants``
+* ``sphinx.util.typing.DirectiveOption``
 
 Features added
 --------------
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index 96bc84ff3bc..3fdb55e2c17 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -72,6 +72,11 @@ The following is a list of deprecated interfaces.
      - 6.0
      - ``docutils.utils.smartyquotes``
 
+   * - ``sphinx.util.typing.DirectiveOption``
+     - 4.0
+     - 6.0
+     - N/A
+
    * - pending_xref node for viewcode extension
      - 3.5
      - 5.0
diff --git a/sphinx/directives/__init__.py b/sphinx/directives/__init__.py
index d4c82c9f3ee..f4014480993 100644
--- a/sphinx/directives/__init__.py
+++ b/sphinx/directives/__init__.py
@@ -21,7 +21,7 @@
 from sphinx.util import docutils
 from sphinx.util.docfields import DocFieldTransformer, Field, TypedField
 from sphinx.util.docutils import SphinxDirective
-from sphinx.util.typing import DirectiveOption
+from sphinx.util.typing import OptionSpec
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -58,9 +58,9 @@ class ObjectDescription(SphinxDirective, Generic[T]):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {
+    option_spec: OptionSpec = {
         'noindex': directives.flag,
-    }  # type: Dict[str, DirectiveOption]
+    }
 
     # types of doc fields that this directive handles, see sphinx.util.docfields
     doc_field_types = []    # type: List[Field]
@@ -251,7 +251,7 @@ class DefaultDomain(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         domain_name = self.arguments[0].lower()
diff --git a/sphinx/directives/code.py b/sphinx/directives/code.py
index f5cd92b82b9..04b81cef576 100644
--- a/sphinx/directives/code.py
+++ b/sphinx/directives/code.py
@@ -22,6 +22,7 @@
 from sphinx.locale import __
 from sphinx.util import logging, parselinenos
 from sphinx.util.docutils import SphinxDirective
+from sphinx.util.typing import OptionSpec
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -39,7 +40,7 @@ class Highlight(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {
+    option_spec: OptionSpec = {
         'force': directives.flag,
         'linenothreshold': directives.positive_int,
     }
@@ -103,7 +104,7 @@ class CodeBlock(SphinxDirective):
     required_arguments = 0
     optional_arguments = 1
     final_argument_whitespace = False
-    option_spec = {
+    option_spec: OptionSpec = {
         'force': directives.flag,
         'linenos': directives.flag,
         'dedent': optional_int,
@@ -379,7 +380,7 @@ class LiteralInclude(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {
+    option_spec: OptionSpec = {
         'dedent': optional_int,
         'linenos': directives.flag,
         'lineno-start': int,
diff --git a/sphinx/directives/other.py b/sphinx/directives/other.py
index 7dd6252e2ad..1daa3c4a5a2 100644
--- a/sphinx/directives/other.py
+++ b/sphinx/directives/other.py
@@ -23,6 +23,7 @@
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.matching import Matcher, patfilter
 from sphinx.util.nodes import explicit_title_re
+from sphinx.util.typing import OptionSpec
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -162,7 +163,7 @@ class Author(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         if not self.config.show_authors:
@@ -202,7 +203,7 @@ class TabularColumns(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         node = addnodes.tabular_col_spec()
@@ -219,7 +220,7 @@ class Centered(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         if not self.arguments:
@@ -241,7 +242,7 @@ class Acks(SphinxDirective):
     required_arguments = 0
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         node = addnodes.acks()
@@ -262,7 +263,7 @@ class HList(SphinxDirective):
     required_arguments = 0
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {
+    option_spec: OptionSpec = {
         'columns': int,
     }
 
@@ -298,7 +299,7 @@ class Only(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         node = addnodes.only()
diff --git a/sphinx/directives/patches.py b/sphinx/directives/patches.py
index 1c3cfd853bc..b4c9784747d 100644
--- a/sphinx/directives/patches.py
+++ b/sphinx/directives/patches.py
@@ -25,6 +25,7 @@
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import set_source_info
 from sphinx.util.osutil import SEP, os_path, relpath
+from sphinx.util.typing import OptionSpec
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -140,7 +141,7 @@ class Code(SphinxDirective):
     This is compatible with docutils' :rst:dir:`code` directive.
     """
     optional_arguments = 1
-    option_spec = {
+    option_spec: OptionSpec = {
         'class': directives.class_option,
         'force': directives.flag,
         'name': directives.unchanged,
@@ -184,7 +185,7 @@ class MathDirective(SphinxDirective):
     required_arguments = 0
     optional_arguments = 1
     final_argument_whitespace = True
-    option_spec = {
+    option_spec: OptionSpec = {
         'label': directives.unchanged,
         'name': directives.unchanged,
         'class': directives.class_option,
diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index 0fecbad6d41..1b7a5fb60d1 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -39,6 +39,7 @@
 from sphinx.util.docfields import Field, TypedField
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import make_refnode
+from sphinx.util.typing import OptionSpec
 
 logger = logging.getLogger(__name__)
 T = TypeVar('T')
@@ -3095,7 +3096,7 @@ class CObject(ObjectDescription[ASTDeclaration]):
               names=('rtype',)),
     ]
 
-    option_spec = {
+    option_spec: OptionSpec = {
         'noindexentry': directives.flag,
     }
 
@@ -3335,7 +3336,7 @@ class CNamespaceObject(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         rootSymbol = self.env.domaindata['c']['root_symbol']
@@ -3365,7 +3366,7 @@ class CNamespacePushObject(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         if self.arguments[0].strip() in ('NULL', '0', 'nullptr'):
@@ -3396,7 +3397,7 @@ class CNamespacePopObject(SphinxDirective):
     required_arguments = 0
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         stack = self.env.temp_data.get('c:namespace_stack', None)
@@ -3550,10 +3551,10 @@ def apply(self, **kwargs: Any) -> None:
 
 
 class CAliasObject(ObjectDescription):
-    option_spec = {
+    option_spec: OptionSpec = {
         'maxdepth': directives.nonnegative_int,
         'noroot': directives.flag,
-    }  # type: Dict
+    }
 
     def run(self) -> List[Node]:
         """
diff --git a/sphinx/domains/changeset.py b/sphinx/domains/changeset.py
index 33234d6e03f..23a3375ced5 100644
--- a/sphinx/domains/changeset.py
+++ b/sphinx/domains/changeset.py
@@ -17,6 +17,7 @@
 from sphinx.domains import Domain
 from sphinx.locale import _
 from sphinx.util.docutils import SphinxDirective
+from sphinx.util.typing import OptionSpec
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -53,7 +54,7 @@ class VersionChange(SphinxDirective):
     required_arguments = 1
     optional_arguments = 1
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         node = addnodes.versionmodified()
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index 3bd764de573..9637654c94a 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -39,6 +39,7 @@
 from sphinx.util.docfields import Field, GroupedField
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import make_refnode
+from sphinx.util.typing import OptionSpec
 
 logger = logging.getLogger(__name__)
 T = TypeVar('T')
@@ -6707,7 +6708,7 @@ class CPPObject(ObjectDescription[ASTDeclaration]):
               names=('returns', 'return')),
     ]
 
-    option_spec = {
+    option_spec: OptionSpec = {
         'noindexentry': directives.flag,
         'tparam-line-spec': directives.flag,
     }
@@ -6973,7 +6974,7 @@ class CPPNamespaceObject(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         rootSymbol = self.env.domaindata['cpp']['root_symbol']
@@ -7004,7 +7005,7 @@ class CPPNamespacePushObject(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         if self.arguments[0].strip() in ('NULL', '0', 'nullptr'):
@@ -7036,7 +7037,7 @@ class CPPNamespacePopObject(SphinxDirective):
     required_arguments = 0
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         stack = self.env.temp_data.get('cpp:namespace_stack', None)
@@ -7213,10 +7214,10 @@ def apply(self, **kwargs: Any) -> None:
 
 
 class CPPAliasObject(ObjectDescription):
-    option_spec = {
+    option_spec: OptionSpec = {
         'maxdepth': directives.nonnegative_int,
         'noroot': directives.flag,
-    }  # type: Dict
+    }
 
     def run(self) -> List[Node]:
         """
diff --git a/sphinx/domains/index.py b/sphinx/domains/index.py
index fd1a7661384..9ecfae439cf 100644
--- a/sphinx/domains/index.py
+++ b/sphinx/domains/index.py
@@ -20,6 +20,7 @@
 from sphinx.util import logging, split_index_msg
 from sphinx.util.docutils import ReferenceRole, SphinxDirective
 from sphinx.util.nodes import process_index_entry
+from sphinx.util.typing import OptionSpec
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -67,7 +68,7 @@ class IndexDirective(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {
+    option_spec: OptionSpec = {
         'name': directives.unchanged,
     }
 
diff --git a/sphinx/domains/javascript.py b/sphinx/domains/javascript.py
index f612fb91492..b34cff50984 100644
--- a/sphinx/domains/javascript.py
+++ b/sphinx/domains/javascript.py
@@ -28,6 +28,7 @@
 from sphinx.util.docfields import Field, GroupedField, TypedField
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import make_id, make_refnode
+from sphinx.util.typing import OptionSpec
 
 logger = logging.getLogger(__name__)
 
@@ -47,7 +48,7 @@ class JSObject(ObjectDescription[Tuple[str, str]]):
     #: based on directive nesting
     allow_nesting = False
 
-    option_spec = {
+    option_spec: OptionSpec = {
         'noindex': directives.flag,
         'noindexentry': directives.flag,
     }
@@ -253,7 +254,7 @@ class JSModule(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {
+    option_spec: OptionSpec = {
         'noindex': directives.flag
     }
 
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 40a67f82cc7..a1e892f4c6c 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -38,7 +38,7 @@
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.inspect import signature_from_str
 from sphinx.util.nodes import find_pending_xref_condition, make_id, make_refnode
-from sphinx.util.typing import TextlikeNode
+from sphinx.util.typing import OptionSpec, TextlikeNode
 
 logger = logging.getLogger(__name__)
 
@@ -357,7 +357,7 @@ class PyObject(ObjectDescription[Tuple[str, str]]):
     :cvar allow_nesting: Class is an object that allows for nested namespaces
     :vartype allow_nesting: bool
     """
-    option_spec = {
+    option_spec: OptionSpec = {
         'noindex': directives.flag,
         'noindexentry': directives.flag,
         'module': directives.unchanged,
@@ -575,7 +575,7 @@ def after_content(self) -> None:
 class PyFunction(PyObject):
     """Description of a function."""
 
-    option_spec = PyObject.option_spec.copy()
+    option_spec: OptionSpec = PyObject.option_spec.copy()
     option_spec.update({
         'async': directives.flag,
     })
@@ -629,7 +629,7 @@ def needs_arglist(self) -> bool:
 class PyVariable(PyObject):
     """Description of a variable."""
 
-    option_spec = PyObject.option_spec.copy()
+    option_spec: OptionSpec = PyObject.option_spec.copy()
     option_spec.update({
         'type': directives.unchanged,
         'value': directives.unchanged,
@@ -662,7 +662,7 @@ class PyClasslike(PyObject):
     Description of a class-like object (classes, interfaces, exceptions).
     """
 
-    option_spec = PyObject.option_spec.copy()
+    option_spec: OptionSpec = PyObject.option_spec.copy()
     option_spec.update({
         'final': directives.flag,
     })
@@ -689,7 +689,7 @@ def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str:
 class PyMethod(PyObject):
     """Description of a method."""
 
-    option_spec = PyObject.option_spec.copy()
+    option_spec: OptionSpec = PyObject.option_spec.copy()
     option_spec.update({
         'abstractmethod': directives.flag,
         'async': directives.flag,
@@ -750,7 +750,7 @@ def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str:
 class PyClassMethod(PyMethod):
     """Description of a classmethod."""
 
-    option_spec = PyObject.option_spec.copy()
+    option_spec: OptionSpec = PyObject.option_spec.copy()
 
     def run(self) -> List[Node]:
         self.name = 'py:method'
@@ -762,7 +762,7 @@ def run(self) -> List[Node]:
 class PyStaticMethod(PyMethod):
     """Description of a staticmethod."""
 
-    option_spec = PyObject.option_spec.copy()
+    option_spec: OptionSpec = PyObject.option_spec.copy()
 
     def run(self) -> List[Node]:
         self.name = 'py:method'
@@ -790,7 +790,7 @@ def needs_arglist(self) -> bool:
 class PyAttribute(PyObject):
     """Description of an attribute."""
 
-    option_spec = PyObject.option_spec.copy()
+    option_spec: OptionSpec = PyObject.option_spec.copy()
     option_spec.update({
         'type': directives.unchanged,
         'value': directives.unchanged,
@@ -857,7 +857,7 @@ class PyModule(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {
+    option_spec: OptionSpec = {
         'platform': lambda x: x,
         'synopsis': lambda x: x,
         'noindex': directives.flag,
@@ -921,7 +921,7 @@ class PyCurrentModule(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         modname = self.arguments[0].strip()
diff --git a/sphinx/domains/rst.py b/sphinx/domains/rst.py
index 07bf46b752d..6b4f1c0ff8a 100644
--- a/sphinx/domains/rst.py
+++ b/sphinx/domains/rst.py
@@ -25,6 +25,7 @@
 from sphinx.roles import XRefRole
 from sphinx.util import logging
 from sphinx.util.nodes import make_id, make_refnode
+from sphinx.util.typing import OptionSpec
 
 logger = logging.getLogger(__name__)
 
@@ -117,7 +118,7 @@ class ReSTDirectiveOption(ReSTMarkup):
     """
     Description of an option for reST directive.
     """
-    option_spec = ReSTMarkup.option_spec.copy()
+    option_spec: OptionSpec = ReSTMarkup.option_spec.copy()
     option_spec.update({
         'type': directives.unchanged,
     })
diff --git a/sphinx/domains/std.py b/sphinx/domains/std.py
index 8b10c854770..274c29c87a3 100644
--- a/sphinx/domains/std.py
+++ b/sphinx/domains/std.py
@@ -30,7 +30,7 @@
 from sphinx.util import docname_join, logging, ws_re
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import clean_astext, make_id, make_refnode
-from sphinx.util.typing import RoleFunction
+from sphinx.util.typing import OptionSpec, RoleFunction
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -132,7 +132,7 @@ class Target(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         # normalize whitespace in fullname like XRefRole does
@@ -265,7 +265,7 @@ class Program(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         program = ws_re.sub('-', self.arguments[0].strip())
@@ -329,7 +329,7 @@ class Glossary(SphinxDirective):
     required_arguments = 0
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {
+    option_spec: OptionSpec = {
         'sorted': directives.flag,
     }
 
@@ -482,7 +482,7 @@ class ProductionList(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         domain = cast(StandardDomain, self.env.get_domain('std'))
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 0b570930149..2abe412349e 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -33,7 +33,7 @@
 from sphinx.util.docstrings import extract_metadata, prepare_docstring
 from sphinx.util.inspect import (evaluate_signature, getdoc, object_description, safe_getattr,
                                  stringify_signature)
-from sphinx.util.typing import get_type_hints, restify
+from sphinx.util.typing import OptionSpec, get_type_hints, restify
 from sphinx.util.typing import stringify as stringify_typehint
 
 if TYPE_CHECKING:
@@ -309,7 +309,9 @@ class Documenter:
     #: true if the generated content may contain titles
     titles_allowed = False
 
-    option_spec = {'noindex': bool_option}  # type: Dict[str, Callable]
+    option_spec: OptionSpec = {
+        'noindex': bool_option
+    }
 
     def get_attr(self, obj: Any, name: str, *defargs: Any) -> Any:
         """getattr() override for types such as Zope interfaces."""
@@ -970,7 +972,7 @@ class ModuleDocumenter(Documenter):
     content_indent = ''
     titles_allowed = True
 
-    option_spec = {
+    option_spec: OptionSpec = {
         'members': members_option, 'undoc-members': bool_option,
         'noindex': bool_option, 'inherited-members': inherited_members_option,
         'show-inheritance': bool_option, 'synopsis': identity,
@@ -978,7 +980,7 @@ class ModuleDocumenter(Documenter):
         'member-order': member_order_option, 'exclude-members': exclude_members_option,
         'private-members': members_option, 'special-members': members_option,
         'imported-members': bool_option, 'ignore-module-all': bool_option
-    }  # type: Dict[str, Callable]
+    }
 
     def __init__(self, *args: Any) -> None:
         super().__init__(*args)
@@ -1419,13 +1421,13 @@ class ClassDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter):  # type:
     """
     objtype = 'class'
     member_order = 20
-    option_spec = {
+    option_spec: OptionSpec = {
         'members': members_option, 'undoc-members': bool_option,
         'noindex': bool_option, 'inherited-members': inherited_members_option,
         'show-inheritance': bool_option, 'member-order': member_order_option,
         'exclude-members': exclude_members_option,
         'private-members': members_option, 'special-members': members_option,
-    }  # type: Dict[str, Callable]
+    }
 
     _signature_class = None  # type: Any
     _signature_method_name = None  # type: str
@@ -1874,7 +1876,7 @@ class DataDocumenter(GenericAliasMixin, NewTypeMixin, TypeVarMixin,
     objtype = 'data'
     member_order = 40
     priority = -10
-    option_spec = dict(ModuleLevelDocumenter.option_spec)
+    option_spec: OptionSpec = dict(ModuleLevelDocumenter.option_spec)
     option_spec["annotation"] = annotation_option
     option_spec["no-value"] = bool_option
 
@@ -2358,7 +2360,7 @@ class AttributeDocumenter(GenericAliasMixin, NewTypeMixin, SlotsMixin,  # type:
     """
     objtype = 'attribute'
     member_order = 60
-    option_spec = dict(ModuleLevelDocumenter.option_spec)
+    option_spec: OptionSpec = dict(ModuleLevelDocumenter.option_spec)
     option_spec["annotation"] = annotation_option
     option_spec["no-value"] = bool_option
 
diff --git a/sphinx/ext/autosummary/__init__.py b/sphinx/ext/autosummary/__init__.py
index 1a0fd240927..3cb5bc798d5 100644
--- a/sphinx/ext/autosummary/__init__.py
+++ b/sphinx/ext/autosummary/__init__.py
@@ -85,6 +85,7 @@
 from sphinx.util.docutils import (NullReporter, SphinxDirective, SphinxRole, new_document,
                                   switch_source_input)
 from sphinx.util.matching import Matcher
+from sphinx.util.typing import OptionSpec
 from sphinx.writers.html import HTMLTranslator
 
 logger = logging.getLogger(__name__)
@@ -225,7 +226,7 @@ class Autosummary(SphinxDirective):
     optional_arguments = 0
     final_argument_whitespace = False
     has_content = True
-    option_spec = {
+    option_spec: OptionSpec = {
         'caption': directives.unchanged_required,
         'toctree': directives.unchanged,
         'nosignatures': directives.flag,
diff --git a/sphinx/ext/doctest.py b/sphinx/ext/doctest.py
index e48fca24860..e7ee8c67da8 100644
--- a/sphinx/ext/doctest.py
+++ b/sphinx/ext/doctest.py
@@ -31,6 +31,7 @@
 from sphinx.util.console import bold  # type: ignore
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.osutil import relpath
+from sphinx.util.typing import OptionSpec
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -150,15 +151,19 @@ def run(self) -> List[Node]:
 
 
 class TestsetupDirective(TestDirective):
-    option_spec = {'skipif': directives.unchanged_required}  # type: Dict
+    option_spec: OptionSpec = {
+        'skipif': directives.unchanged_required
+    }
 
 
 class TestcleanupDirective(TestDirective):
-    option_spec = {'skipif': directives.unchanged_required}  # type: Dict
+    option_spec: OptionSpec = {
+        'skipif': directives.unchanged_required
+    }
 
 
 class DoctestDirective(TestDirective):
-    option_spec = {
+    option_spec: OptionSpec = {
         'hide': directives.flag,
         'no-trim-doctest-flags': directives.flag,
         'options': directives.unchanged,
@@ -169,7 +174,7 @@ class DoctestDirective(TestDirective):
 
 
 class TestcodeDirective(TestDirective):
-    option_spec = {
+    option_spec: OptionSpec = {
         'hide': directives.flag,
         'no-trim-doctest-flags': directives.flag,
         'pyversion': directives.unchanged_required,
@@ -179,7 +184,7 @@ class TestcodeDirective(TestDirective):
 
 
 class TestoutputDirective(TestDirective):
-    option_spec = {
+    option_spec: OptionSpec = {
         'hide': directives.flag,
         'no-trim-doctest-flags': directives.flag,
         'options': directives.unchanged,
diff --git a/sphinx/ext/graphviz.py b/sphinx/ext/graphviz.py
index f102850866b..f10edfaae8b 100644
--- a/sphinx/ext/graphviz.py
+++ b/sphinx/ext/graphviz.py
@@ -30,6 +30,7 @@
 from sphinx.util.i18n import search_image_for_language
 from sphinx.util.nodes import set_source_info
 from sphinx.util.osutil import ensuredir
+from sphinx.util.typing import OptionSpec
 from sphinx.writers.html import HTMLTranslator
 from sphinx.writers.latex import LaTeXTranslator
 from sphinx.writers.manpage import ManualPageTranslator
@@ -113,7 +114,7 @@ class Graphviz(SphinxDirective):
     required_arguments = 0
     optional_arguments = 1
     final_argument_whitespace = False
-    option_spec = {
+    option_spec: OptionSpec = {
         'alt': directives.unchanged,
         'align': align_spec,
         'caption': directives.unchanged,
@@ -181,7 +182,7 @@ class GraphvizSimple(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {
+    option_spec: OptionSpec = {
         'alt': directives.unchanged,
         'align': align_spec,
         'caption': directives.unchanged,
diff --git a/sphinx/ext/ifconfig.py b/sphinx/ext/ifconfig.py
index df85450288f..0e42984da68 100644
--- a/sphinx/ext/ifconfig.py
+++ b/sphinx/ext/ifconfig.py
@@ -28,6 +28,7 @@
 from sphinx.application import Sphinx
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import nested_parse_with_titles
+from sphinx.util.typing import OptionSpec
 
 
 class ifconfig(nodes.Element):
@@ -40,7 +41,7 @@ class IfConfig(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         node = ifconfig()
diff --git a/sphinx/ext/inheritance_diagram.py b/sphinx/ext/inheritance_diagram.py
index 63a171087e9..62b80ac39df 100644
--- a/sphinx/ext/inheritance_diagram.py
+++ b/sphinx/ext/inheritance_diagram.py
@@ -53,6 +53,7 @@ class E(B): pass
                                  render_dot_texinfo)
 from sphinx.util import md5
 from sphinx.util.docutils import SphinxDirective
+from sphinx.util.typing import OptionSpec
 from sphinx.writers.html import HTMLTranslator
 from sphinx.writers.latex import LaTeXTranslator
 from sphinx.writers.texinfo import TexinfoTranslator
@@ -331,7 +332,7 @@ class InheritanceDiagram(SphinxDirective):
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = True
-    option_spec = {
+    option_spec: OptionSpec = {
         'parts': int,
         'private-bases': directives.flag,
         'caption': directives.unchanged,
diff --git a/sphinx/ext/todo.py b/sphinx/ext/todo.py
index e0fdd31e0d3..e7a2cb51afd 100644
--- a/sphinx/ext/todo.py
+++ b/sphinx/ext/todo.py
@@ -27,6 +27,7 @@
 from sphinx.locale import _, __
 from sphinx.util import logging, texescape
 from sphinx.util.docutils import SphinxDirective, new_document
+from sphinx.util.typing import OptionSpec
 from sphinx.writers.html import HTMLTranslator
 from sphinx.writers.latex import LaTeXTranslator
 
@@ -51,7 +52,7 @@ class Todo(BaseAdmonition, SphinxDirective):
     required_arguments = 0
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {
+    option_spec: OptionSpec = {
         'class': directives.class_option,
         'name': directives.unchanged,
     }
@@ -110,7 +111,7 @@ class TodoList(SphinxDirective):
     required_arguments = 0
     optional_arguments = 0
     final_argument_whitespace = False
-    option_spec = {}  # type: Dict
+    option_spec: OptionSpec = {}
 
     def run(self) -> List[Node]:
         # Simply insert an empty todolist node which will be replaced later
diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py
index afd2f805a9e..128fbd5428d 100644
--- a/sphinx/util/typing.py
+++ b/sphinx/util/typing.py
@@ -16,6 +16,8 @@
 from docutils import nodes
 from docutils.parsers.rst.states import Inliner
 
+from sphinx.deprecation import RemovedInSphinx60Warning, deprecated_alias
+
 if sys.version_info > (3, 7):
     from typing import ForwardRef
 else:
@@ -40,9 +42,6 @@ def _evaluate(self, globalns: Dict, localns: Dict) -> Any:
     from typing import Type  # NOQA # for python3.5.1
 
 
-# An entry of Directive.option_spec
-DirectiveOption = Callable[[str], Any]
-
 # Text like nodes which are initialized with text and rawsource
 TextlikeNode = Union[nodes.Text, nodes.TextElement]
 
@@ -56,6 +55,9 @@ def _evaluate(self, globalns: Dict, localns: Dict) -> Any:
 RoleFunction = Callable[[str, str, str, int, Inliner, Dict[str, Any], List[str]],
                         Tuple[List[nodes.Node], List[nodes.system_message]]]
 
+# A option spec for directive
+OptionSpec = Dict[str, Callable[[Optional[str]], Any]]
+
 # title getter functions for enumerable nodes (see sphinx.domains.std)
 TitleGetter = Callable[[nodes.Node], str]
 
@@ -405,3 +407,10 @@ def _stringify_py36(annotation: Any) -> str:
                 return 'Union[%s]' % param_str
 
     return qualname
+
+
+deprecated_alias('sphinx.util.typing',
+                 {
+                     'DirectiveOption': Callable[[str], Any],
+                 },
+                 RemovedInSphinx60Warning)

From 75f5122996ea7eb340d31bb3006efde7d2a351f6 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 11 Mar 2021 02:01:17 +0900
Subject: [PATCH 190/305] Fix #7383: autodoc: Support typehints for properties

py:property directive now outputs py:property directive to describe
its type annotation.
---
 CHANGES                                       |  1 +
 sphinx/ext/autodoc/__init__.py                | 16 +++++++++--
 .../test-ext-autodoc/target/properties.py     |  6 ++++
 tests/test_ext_autodoc.py                     |  9 ++----
 tests/test_ext_autodoc_autoclass.py           | 21 ++++++++++++++
 tests/test_ext_autodoc_autoproperty.py        | 28 +++++++++++++++++++
 tests/test_ext_autodoc_configs.py             | 12 +++-----
 7 files changed, 77 insertions(+), 16 deletions(-)
 create mode 100644 tests/roots/test-ext-autodoc/target/properties.py
 create mode 100644 tests/test_ext_autodoc_autoproperty.py

diff --git a/CHANGES b/CHANGES
index ee9f48733ad..9b740574fe1 100644
--- a/CHANGES
+++ b/CHANGES
@@ -62,6 +62,7 @@ Features added
 --------------
 
 * #8924: autodoc: Support ``bound`` argument for TypeVar
+* #7383: autodoc: Support typehints for properties
 * #7549: autosummary: Enable :confval:`autosummary_generate` by default
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 0b570930149..5799bbc24f1 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -2526,7 +2526,6 @@ class PropertyDocumenter(DocstringStripSignatureMixin, ClassLevelDocumenter):  #
     Specialized Documenter subclass for properties.
     """
     objtype = 'property'
-    directivetype = 'method'
     member_order = 60
 
     # before AttributeDocumenter
@@ -2549,7 +2548,20 @@ def add_directive_header(self, sig: str) -> None:
         sourcename = self.get_sourcename()
         if inspect.isabstractmethod(self.object):
             self.add_line('   :abstractmethod:', sourcename)
-        self.add_line('   :property:', sourcename)
+
+        if safe_getattr(self.object, 'fget', None):
+            try:
+                signature = inspect.signature(self.object.fget,
+                                              type_aliases=self.config.autodoc_type_aliases)
+                if signature.return_annotation is not Parameter.empty:
+                    objrepr = stringify_typehint(signature.return_annotation)
+                    self.add_line('   :type: ' + objrepr, sourcename)
+            except TypeError as exc:
+                logger.warning(__("Failed to get a function signature for %s: %s"),
+                               self.fullname, exc)
+                return None
+            except ValueError:
+                raise
 
 
 class NewTypeAttributeDocumenter(AttributeDocumenter):
diff --git a/tests/roots/test-ext-autodoc/target/properties.py b/tests/roots/test-ext-autodoc/target/properties.py
new file mode 100644
index 00000000000..409fc2b5d61
--- /dev/null
+++ b/tests/roots/test-ext-autodoc/target/properties.py
@@ -0,0 +1,6 @@
+class Foo:
+    """docstring"""
+
+    @property
+    def prop(self) -> int:
+        """docstring"""
diff --git a/tests/test_ext_autodoc.py b/tests/test_ext_autodoc.py
index d9986e9ca55..7c6f4e0d674 100644
--- a/tests/test_ext_autodoc.py
+++ b/tests/test_ext_autodoc.py
@@ -1033,9 +1033,8 @@ def test_autodoc_descriptor(app):
         '      Descriptor instance docstring.',
         '',
         '',
-        '   .. py:method:: Class.prop',
+        '   .. py:property:: Class.prop',
         '      :module: target.descriptor',
-        '      :property:',
         '',
         '      Property.',
         ''
@@ -1055,9 +1054,8 @@ def test_autodoc_cached_property(app):
         '   :module: target.cached_property',
         '',
         '',
-        '   .. py:method:: Foo.prop',
+        '   .. py:property:: Foo.prop',
         '      :module: target.cached_property',
-        '      :property:',
         '',
     ]
 
@@ -1516,10 +1514,9 @@ def test_abstractmethods(app):
         '      :module: target.abstractmethods',
         '',
         '',
-        '   .. py:method:: Base.prop',
+        '   .. py:property:: Base.prop',
         '      :module: target.abstractmethods',
         '      :abstractmethod:',
-        '      :property:',
         '',
         '',
         '   .. py:method:: Base.staticmeth()',
diff --git a/tests/test_ext_autodoc_autoclass.py b/tests/test_ext_autodoc_autoclass.py
index 538b36881f8..9402633872e 100644
--- a/tests/test_ext_autodoc_autoclass.py
+++ b/tests/test_ext_autodoc_autoclass.py
@@ -199,6 +199,27 @@ def test_decorators(app):
     ]
 
 
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_properties(app):
+    options = {"members": None}
+    actual = do_autodoc(app, 'class', 'target.properties.Foo', options)
+    assert list(actual) == [
+        '',
+        '.. py:class:: Foo()',
+        '   :module: target.properties',
+        '',
+        '   docstring',
+        '',
+        '',
+        '   .. py:property:: Foo.prop',
+        '      :module: target.properties',
+        '      :type: int',
+        '',
+        '      docstring',
+        '',
+    ]
+
+
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_slots_attribute(app):
     options = {"members": None}
diff --git a/tests/test_ext_autodoc_autoproperty.py b/tests/test_ext_autodoc_autoproperty.py
new file mode 100644
index 00000000000..ee25aa8b71b
--- /dev/null
+++ b/tests/test_ext_autodoc_autoproperty.py
@@ -0,0 +1,28 @@
+"""
+    test_ext_autodoc_autoproperty
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Test the autodoc extension.  This tests mainly the Documenters; the auto
+    directives are tested in a test source file translated by test_build.
+
+    :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import pytest
+
+from .test_ext_autodoc import do_autodoc
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_properties(app):
+    actual = do_autodoc(app, 'property', 'target.properties.Foo.prop')
+    assert list(actual) == [
+        '',
+        '.. py:property:: Foo.prop',
+        '   :module: target.properties',
+        '   :type: int',
+        '',
+        '   docstring',
+        '',
+    ]
diff --git a/tests/test_ext_autodoc_configs.py b/tests/test_ext_autodoc_configs.py
index 06bf39c24c4..cc34143ca36 100644
--- a/tests/test_ext_autodoc_configs.py
+++ b/tests/test_ext_autodoc_configs.py
@@ -261,16 +261,14 @@ def test_autodoc_docstring_signature(app):
         '          indented line',
         '',
         '',
-        '   .. py:method:: DocstringSig.prop1',
+        '   .. py:property:: DocstringSig.prop1',
         '      :module: target',
-        '      :property:',
         '',
         '      First line of docstring',
         '',
         '',
-        '   .. py:method:: DocstringSig.prop2',
+        '   .. py:property:: DocstringSig.prop2',
         '      :module: target',
-        '      :property:',
         '',
         '      First line of docstring',
         '      Second line of docstring',
@@ -305,17 +303,15 @@ def test_autodoc_docstring_signature(app):
         '          indented line',
         '',
         '',
-        '   .. py:method:: DocstringSig.prop1',
+        '   .. py:property:: DocstringSig.prop1',
         '      :module: target',
-        '      :property:',
         '',
         '      DocstringSig.prop1(self)',
         '      First line of docstring',
         '',
         '',
-        '   .. py:method:: DocstringSig.prop2',
+        '   .. py:property:: DocstringSig.prop2',
         '      :module: target',
-        '      :property:',
         '',
         '      First line of docstring',
         '      Second line of docstring',

From 6c7480b3f63a726995e9d20e8a3c8c4ebecc1111 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 9 Mar 2021 00:51:29 +0900
Subject: [PATCH 191/305] Fix #7119: autodoc: Broken doctree was generated by
 builtin_resolver

The builtin_resolver() generates broken doctree unexpectedly if it
contains pending_xref_condition nodes.
---
 sphinx/domains/python.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 40a67f82cc7..1b5e18cdf8c 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -1301,6 +1301,10 @@ def istyping(s: str) -> bool:
 
         return s in typing.__all__  # type: ignore
 
+    content = find_pending_xref_condition(node, 'resolved')
+    if content:
+        contnode = content.children[0]
+
     if node.get('refdomain') != 'py':
         return None
     elif node.get('reftype') in ('class', 'obj') and node.get('reftarget') == 'None':

From b6d143118d35c2f138c15349fee707aec14f4349 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Sat, 13 Mar 2021 16:51:52 +0100
Subject: [PATCH 192/305] LaTeX: modify \pysigline and \pysiglinewithargsret

Fix #7241
Fix #8980
Fix #8995
---
 sphinx/texinputs/sphinxlatexobjects.sty | 37 ++++++++++++++++++-------
 1 file changed, 27 insertions(+), 10 deletions(-)

diff --git a/sphinx/texinputs/sphinxlatexobjects.sty b/sphinx/texinputs/sphinxlatexobjects.sty
index 26e2862c116..810d3f2f89f 100644
--- a/sphinx/texinputs/sphinxlatexobjects.sty
+++ b/sphinx/texinputs/sphinxlatexobjects.sty
@@ -58,11 +58,14 @@
 
 % {fulllineitems} is the main environment for object descriptions.
 %
-\newcommand{\py@itemnewline}[1]{%
-  \kern\labelsep
-  \@tempdima\linewidth
-  \advance\@tempdima \labelwidth\makebox[\@tempdima][l]{#1}%
-  \kern-\labelsep
+% With 4.0.0 \pysigline (and \pysiglinewithargsret), used in a fulllineitems
+% environment the #1 will already be of the width which is computed here, i.e.
+% the available width on line, so the \makebox becomes a bit superfluous
+\newcommand{\py@itemnewline}[1]{% macro used as \makelabel in fulllineitems
+% Memo: this presupposes \itemindent is 0pt
+  \kern\labelsep  % because \@labels core latex box does \hskip-\labelsep
+  \makebox[\dimexpr\linewidth+\labelwidth\relax][l]{#1}%
+  \kern-\labelsep % because at end of \@labels box there is \hskip\labelsep
 }
 
 \newenvironment{fulllineitems}{%
@@ -76,13 +79,27 @@
 %
 \newlength{\py@argswidth}
 \newcommand{\py@sigparams}[2]{%
-  \parbox[t]{\py@argswidth}{#1\sphinxcode{)}#2}}
-\newcommand{\pysigline}[1]{\item[{#1}]}
+  % The \py@argswidth has been computed in \pysiglinewithargsret to make this
+  % occupy full available width on line.
+  \parbox[t]{\py@argswidth}{\raggedright #1\sphinxcode{)}#2\strut}%
+  % final strut is to help get correct vertical separation in case of multi-line
+  % box with the item contents. 
+}
+\newcommand{\pysigline}[1]{%
+% the \py@argswidth is available we use it despite its name (no "args" here)
+% the \relax\relax is because \py@argswidth is a "skip" variable and the first
+% \relax only ends its "dimen" part
+  \py@argswidth=\dimexpr\linewidth+\labelwidth\relax\relax
+  \item[{\parbox[t]{\py@argswidth}{\raggedright #1\strut}}]
+% this strange incantation is because at its root LaTeX in fact did not
+% imagine a multi-line label, it is always wrapped in a horizontal box at core
+% LaTeX level and we have to find tricks to get correct interline distances.
+  \leavevmode\par\nobreak\vskip-\parskip\prevdepth\dp\strutbox}
 \newcommand{\pysiglinewithargsret}[3]{%
   \settowidth{\py@argswidth}{#1\sphinxcode{(}}%
-  \addtolength{\py@argswidth}{-2\py@argswidth}%
-  \addtolength{\py@argswidth}{\linewidth}%
-  \item[{#1\sphinxcode{(}\py@sigparams{#2}{#3}}]}
+  \py@argswidth=\dimexpr\linewidth+\labelwidth-\py@argswidth\relax\relax
+  \item[{#1\sphinxcode{(}\py@sigparams{#2}{#3}}]
+  \leavevmode\par\nobreak\vskip-\parskip\prevdepth\dp\strutbox}
 \newcommand{\pysigstartmultiline}{%
  \def\pysigstartmultiline{\vskip\smallskipamount\parskip\z@skip\itemsep\z@skip}%
  \edef\pysigstopmultiline

From 9a4b4b5934614e04ef784b11188e25b07bb10fa4 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Sat, 13 Mar 2021 16:57:06 +0100
Subject: [PATCH 193/305] Update CHANGES

---
 CHANGES | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CHANGES b/CHANGES
index ee9f48733ad..fc341c6c5d0 100644
--- a/CHANGES
+++ b/CHANGES
@@ -92,6 +92,7 @@ Bugs fixed
 * #8915: html theme: The translation of sphinx_rtd_theme does not work
 * #8342: Emit a warning if a unknown domain is given for directive or role (ex.
   ``:unknown:doc:``)
+* #7241: LaTeX: No wrapping for ``cpp:enumerator``
 * #8711: LaTeX: backticks in code-blocks trigger latexpdf build warning (and font
   change) with late TeXLive 2019
 * #8253: LaTeX: Figures with no size defined get overscaled (compared to images
@@ -101,6 +102,9 @@ Bugs fixed
   Pygments style
 * #8925: LaTeX: 3.5.0 ``verbatimmaxunderfull`` setting does not work as
   expected
+* #8980: LaTeX: missing line break in ``\pysigline``
+* #8995: LaTeX: legacy ``\pysiglinewithargsret`` does not compute correctly
+  available  horizontal space and should use a ragged right style
 * #8911: C++: remove the longest matching prefix in
   :confval:`cpp_index_common_prefix` instead of the first that matches.
 * C, properly reject function declarations when a keyword is used

From e45d0797cbfae5425659fa5890ec2331a68799d6 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 13 Mar 2021 20:01:25 +0100
Subject: [PATCH 194/305] C++, always try to resolve name in sizeof...

---
 sphinx/domains/cpp.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index 3bd764de573..e0a7ecf95af 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -1250,7 +1250,7 @@ def get_id(self, version: int) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         signode.append(nodes.Text('sizeof...('))
-        self.identifier.describe_signature(signode, mode, env,
+        self.identifier.describe_signature(signode, 'markType', env,
                                            symbol=symbol, prefix="", templateArgs="")
         signode.append(nodes.Text(')'))
 

From 57220411dafcff0fbb7e871eb7244115cdf842b4 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sun, 14 Mar 2021 10:11:03 +0100
Subject: [PATCH 195/305] C++, fix linking in some declarators

---
 CHANGES               |  2 ++
 sphinx/domains/cpp.py | 29 ++++++++++++++++++++---------
 2 files changed, 22 insertions(+), 9 deletions(-)

diff --git a/CHANGES b/CHANGES
index d59dc9f52bd..d8b79b2dfa9 100644
--- a/CHANGES
+++ b/CHANGES
@@ -107,6 +107,8 @@ Bugs fixed
 * #8933: viewcode: Failed to create back-links on parallel build
 * #8960: C and C++, fix rendering of (member) function pointer types in
   function parameter lists.
+* C++, fix linking of names in array declarators and pointer to member
+  (function) declarators.
 
 Testing
 --------
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index e0a7ecf95af..52b9ad23c18 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -179,7 +179,6 @@
         declarator ->
               ptr-declarator
             | noptr-declarator parameters-and-qualifiers trailing-return-type
-              (TODO: for now we don't support trailing-eturn-type)
         ptr-declarator ->
               noptr-declarator
             | ptr-operator ptr-declarator
@@ -718,8 +717,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
             res.append('')
         for i in range(len(self.names)):
             n = self.names[i]
-            t = self.templates[i]
-            if t:
+            if self.templates[i]:
                 res.append("template " + transform(n))
             else:
                 res.append(transform(n))
@@ -730,10 +728,23 @@ def describe_signature(self, signode: TextElement, mode: str,
         verify_description_mode(mode)
         # just print the name part, with template args, not template params
         if mode == 'noneIsName':
-            signode += nodes.Text(str(self))
+            if self.rooted:
+                signode += nodes.Text('::')
+            for i in range(len(self.names)):
+                if i != 0:
+                    signode += nodes.Text('::')
+                n = self.names[i]
+                if self.templates[i]:
+                    signode += nodes.Text("template")
+                    signode += nodes.Text(" ")
+                n.describe_signature(signode, mode, env, '', symbol)
         elif mode == 'param':
-            name = str(self)
-            signode += nodes.emphasis(name, name)
+            assert not self.rooted, str(self)
+            assert len(self.names) == 1
+            assert not self.templates[0]
+            node = nodes.emphasis()
+            self.names[0].describe_signature(node, 'noneIsName', env, '', symbol)
+            signode += node
         elif mode == 'markType' or mode == 'lastIsName' or mode == 'markName':
             # Each element should be a pending xref targeting the complete
             # prefix. however, only the identifier part should be a link, such
@@ -2199,7 +2210,7 @@ def describe_signature(self, signode: TextElement, mode: str,
         verify_description_mode(mode)
         signode.append(nodes.Text("["))
         if self.size:
-            self.size.describe_signature(signode, mode, env, symbol)
+            self.size.describe_signature(signode, 'markType', env, symbol)
         signode.append(nodes.Text("]"))
 
 
@@ -2667,7 +2678,7 @@ def is_function_type(self) -> bool:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        self.className.describe_signature(signode, mode, env, symbol)
+        self.className.describe_signature(signode, 'markType', env, symbol)
         signode += nodes.Text('::*')
 
         def _add_anno(signode: TextElement, text: str) -> None:
@@ -6171,7 +6182,7 @@ def _parse_type(self, named: Union[bool, str], outer: str = None) -> ASTType:
                                                       typed=typed)
         else:
             paramMode = 'type'
-            if outer == 'member':  # i.e., member
+            if outer == 'member':
                 named = True
             elif outer == 'operatorCast':
                 paramMode = 'operatorCast'

From 58b6b45993d9b188d34c489588b5be82eeadc533 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sun, 14 Mar 2021 10:25:29 +0100
Subject: [PATCH 196/305] C, fix linking of names in array declarators

---
 CHANGES             |  1 +
 sphinx/domains/c.py | 17 +++++++++++++----
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/CHANGES b/CHANGES
index d8b79b2dfa9..90e8998d3c4 100644
--- a/CHANGES
+++ b/CHANGES
@@ -109,6 +109,7 @@ Bugs fixed
   function parameter lists.
 * C++, fix linking of names in array declarators and pointer to member
   (function) declarators.
+* C, fix linking of names in array declarators.
 
 Testing
 --------
diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index 0fecbad6d41..0c5f41ba16e 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -182,10 +182,19 @@ def describe_signature(self, signode: TextElement, mode: str,
         verify_description_mode(mode)
         # just print the name part, with template args, not template params
         if mode == 'noneIsName':
-            signode += nodes.Text(str(self))
+            if self.rooted:
+                signode += nodes.Text('.')
+            for i in range(len(self.names)):
+                if i != 0:
+                    signode += nodes.Text('.')
+                n = self.names[i]
+                n.describe_signature(signode, mode, env, '', symbol)
         elif mode == 'param':
-            name = str(self)
-            signode += nodes.emphasis(name, name)
+            assert not self.rooted, str(self)
+            assert len(self.names) == 1
+            node = nodes.emphasis()
+            self.names[0].describe_signature(node, 'noneIsName', env, '', symbol)
+            signode += node
         elif mode == 'markType' or mode == 'lastIsName' or mode == 'markName':
             # Each element should be a pending xref targeting the complete
             # prefix.
@@ -869,7 +878,7 @@ def _add(signode: TextElement, text: str) -> bool:
         elif self.size:
             if addSpace:
                 signode += nodes.Text(' ')
-            self.size.describe_signature(signode, mode, env, symbol)
+            self.size.describe_signature(signode, 'markType', env, symbol)
         signode.append(nodes.Text("]"))
 
 

From dfc759e0392591de10f1ce064a89c7d52aa7aa85 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sun, 14 Mar 2021 10:29:06 +0100
Subject: [PATCH 197/305] Missing CHANGES item

---
 CHANGES | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 90e8998d3c4..7ffd8cfb758 100644
--- a/CHANGES
+++ b/CHANGES
@@ -107,8 +107,8 @@ Bugs fixed
 * #8933: viewcode: Failed to create back-links on parallel build
 * #8960: C and C++, fix rendering of (member) function pointer types in
   function parameter lists.
-* C++, fix linking of names in array declarators and pointer to member
-  (function) declarators.
+* C++, fix linking of names in array declarators, pointer to member
+  (function) declarators, and in the argument to ``sizeof...``.
 * C, fix linking of names in array declarators.
 
 Testing

From 5e0e6c8898c7e64b234024254ed0ab50f42ff195 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Sun, 14 Mar 2021 11:18:03 +0100
Subject: [PATCH 198/305] Refactor some internal LaTeX code

Codeline wrapping in literal blocks (possibly hard-wrap in presence of
unbreakable long strings) requires a measurement step. Spring 2021 LaTeX
adds quite some overhead to each and every paragraph to insert hooks at
begin and end of paragraphs. For technical reasons, our measurement
(which uses a paragraph in a scratch box) could be broken by the "after
para" hook. Work around that.
---
 sphinx/texinputs/sphinxlatexliterals.sty | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/sphinx/texinputs/sphinxlatexliterals.sty b/sphinx/texinputs/sphinxlatexliterals.sty
index a2943b2dc2c..4d0312fc653 100644
--- a/sphinx/texinputs/sphinxlatexliterals.sty
+++ b/sphinx/texinputs/sphinxlatexliterals.sty
@@ -318,6 +318,26 @@
 % box does not store in an accessible way what was the maximal
 % line-width during paragraph building.
 %
+% Avoid LaTeX 2021 alteration of \@@par which potentially could break our
+% measurement step (typically if the para/after hook is configured to use
+% \vspace).  Of course, breakage could happen only from user or package
+% adding things to basic Sphinx latex.  And perhaps spring LaTeX 2021 will
+% provide a non-hooked \@@par, but this should work anyway and can't be
+% beaten for speed.
+\ltx@ifundefined{tex_par:D}
+% We could use \@ifl@t@r\fmtversion{2020/02/02}{use \tex_par:D}{use \@@par}.
+  {\let\spx@par\@@par}% \@@par is then expected to be TeX's original \par
+  {\expandafter\let\expandafter\spx@par\csname tex_par:D\endcsname}
+% More hesitation for avoiding the at-start-of-par hooks for our
+% measurement : 1. with old LaTeX, we can not avoid hooks from everyhook
+% or similar packages, 2. and perhaps the hooks add stuff which we should
+% actually measure.  Ideally, hooks are for inserting things in margin
+% which do not change spacing.  Most everything else in fact should not be
+% executed in our scratch box for measurement, such as counter stepping.
+\ltx@ifundefined{tex_everypar:D}
+  {\let\spx@everypar\everypar}
+  {\expandafter\let\expandafter\spx@everypar\csname tex_everypar:D\endcsname}
+%
 % If the max width exceeds the linewidth by more than verbatimmaxoverfull
 % character widths, or if the min width plus verbatimmaxunderfull character
 % widths is inferior to linewidth, then we apply the "force wrapping" with
@@ -329,7 +349,7 @@
     \setbox\spx@image@box
     \vtop{\raggedright\hyphenpenalty\z@\exhyphenpenalty\z@
           \doublehyphendemerits\z@\finalhyphendemerits\z@
-          \strut #1\strut\@@par
+          \spx@everypar{}\noindent\strut #1\strut\spx@par
           \spx@verb@getwidths}%
     \ifdim\spx@verb@maxwidth>
           \dimexpr\linewidth+\spx@opt@verbatimmaxoverfull\fontcharwd\font`X \relax

From 5b5730ef4e7a28216f1c402f7e2c955c077c5ac3 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 15 Mar 2021 00:46:19 +0900
Subject: [PATCH 199/305] Avoid a mypy warning

---
 sphinx/domains/python.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index 1b5e18cdf8c..7175c9b86f5 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -1303,7 +1303,7 @@ def istyping(s: str) -> bool:
 
     content = find_pending_xref_condition(node, 'resolved')
     if content:
-        contnode = content.children[0]
+        contnode = content.children[0]  # type: ignore
 
     if node.get('refdomain') != 'py':
         return None

From 0d73a03a3830a08ef2128c2046821193ea7d5709 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 15 Mar 2021 00:27:39 +0100
Subject: [PATCH 200/305] DOC: Minor cleanup of sphinx-build doc

The moved sentence clearly belongs to the discussion of the builders.
---
 doc/man/sphinx-build.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/doc/man/sphinx-build.rst b/doc/man/sphinx-build.rst
index 1ef0e07dc3b..ca16b265aff 100644
--- a/doc/man/sphinx-build.rst
+++ b/doc/man/sphinx-build.rst
@@ -19,13 +19,12 @@ files, including ``conf.py``.
 :program:`sphinx-build` can create documentation in different formats.  A
 format is selected by specifying the builder name on the command line; it
 defaults to HTML.  Builders can also perform other tasks related to
-documentation processing.
+documentation processing.  For a list of available builders, refer to
+:option:`sphinx-build -b`.
 
 By default, everything that is outdated is built.  Output only for selected
 files can be built by specifying individual filenames.
 
-For a list of available options, refer to :option:`sphinx-build -b`.
-
 Options
 -------
 

From 1d4c414319598320f95eed245e4a2f9ad3e5a668 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 15 Mar 2021 13:11:07 +0900
Subject: [PATCH 201/305] refactor: Use PEP-526 based variable annotation
 (sphinx.ext)

---
 sphinx/ext/apidoc.py               |  2 +-
 sphinx/ext/autodoc/__init__.py     | 52 +++++++++++++++---------------
 sphinx/ext/autodoc/directive.py    |  4 +--
 sphinx/ext/autodoc/importer.py     |  6 ++--
 sphinx/ext/autodoc/mock.py         |  8 ++---
 sphinx/ext/autodoc/typehints.py    |  2 +-
 sphinx/ext/autosummary/generate.py |  2 +-
 sphinx/ext/coverage.py             | 16 ++++-----
 sphinx/ext/graphviz.py             |  4 +--
 sphinx/ext/inheritance_diagram.py  |  6 ++--
 sphinx/ext/intersphinx.py          |  4 +--
 sphinx/ext/linkcode.py             |  2 +-
 sphinx/ext/napoleon/__init__.py    |  2 +-
 sphinx/ext/napoleon/docstring.py   | 22 ++++++-------
 sphinx/ext/napoleon/iterators.py   |  4 +--
 15 files changed, 68 insertions(+), 68 deletions(-)

diff --git a/sphinx/ext/apidoc.py b/sphinx/ext/apidoc.py
index 6affde942eb..d9a9648c68e 100644
--- a/sphinx/ext/apidoc.py
+++ b/sphinx/ext/apidoc.py
@@ -215,7 +215,7 @@ def walk(rootpath: str, excludes: List[str], opts: Any
         # remove hidden ('.') and private ('_') directories, as well as
         # excluded dirs
         if includeprivate:
-            exclude_prefixes = ('.',)  # type: Tuple[str, ...]
+            exclude_prefixes: Tuple[str, ...] = ('.',)
         else:
             exclude_prefixes = ('.', '_')
 
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 2410ccec33a..fe6b483d4b5 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -325,28 +325,28 @@ def can_document_member(cls, member: Any, membername: str, isattr: bool, parent:
 
     def __init__(self, directive: "DocumenterBridge", name: str, indent: str = '') -> None:
         self.directive = directive
-        self.config = directive.env.config  # type: Config
-        self.env = directive.env    # type: BuildEnvironment
+        self.config: Config = directive.env.config
+        self.env: BuildEnvironment = directive.env
         self.options = directive.genopt
         self.name = name
         self.indent = indent
         # the module and object path within the module, and the fully
         # qualified name (all set after resolve_name succeeds)
-        self.modname = None         # type: str
-        self.module = None          # type: ModuleType
-        self.objpath = None         # type: List[str]
-        self.fullname = None        # type: str
+        self.modname: str = None
+        self.module: ModuleType = None
+        self.objpath: List[str] = None
+        self.fullname: str = None
         # extra signature items (arguments and return annotation,
         # also set after resolve_name succeeds)
-        self.args = None            # type: str
-        self.retann = None          # type: str
+        self.args: str = None
+        self.retann: str = None
         # the object to document (set after import_object succeeds)
-        self.object = None          # type: Any
-        self.object_name = None     # type: str
+        self.object: Any = None
+        self.object_name: str = None
         # the parent/owner of the object to document
-        self.parent = None          # type: Any
+        self.parent: Any = None
         # the module analyzer to get at attribute docs, or None
-        self.analyzer = None        # type: ModuleAnalyzer
+        self.analyzer: ModuleAnalyzer = None
 
     @property
     def documenters(self) -> Dict[str, Type["Documenter"]]:
@@ -822,7 +822,7 @@ def document_members(self, all_members: bool = False) -> None:
         members_check_module, members = self.get_object_members(want_all)
 
         # document non-skipped members
-        memberdocumenters = []  # type: List[Tuple[Documenter, bool]]
+        memberdocumenters: List[Tuple[Documenter, bool]] = []
         for (mname, member, isattr) in self.filter_members(members, want_all):
             classes = [cls for cls in self.documenters.values()
                        if cls.can_document_member(member, mname, isattr, self)]
@@ -904,7 +904,7 @@ def generate(self, more_content: Optional[StringList] = None, real_modname: str
         # This is used for situations where you have a module that collects the
         # functions and classes of internal submodules.
         guess_modname = self.get_real_modname()
-        self.real_modname = real_modname or guess_modname  # type: str
+        self.real_modname: str = real_modname or guess_modname
 
         # try to also get a source code analyzer for attribute docs
         try:
@@ -985,7 +985,7 @@ class ModuleDocumenter(Documenter):
     def __init__(self, *args: Any) -> None:
         super().__init__(*args)
         merge_members_option(self.options)
-        self.__all__ = None  # type: Optional[Sequence[str]]
+        self.__all__: Optional[Sequence[str]] = None
 
     @classmethod
     def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
@@ -1042,7 +1042,7 @@ def get_module_members(self) -> Dict[str, ObjectMember]:
         else:
             attr_docs = {}
 
-        members = {}  # type: Dict[str, ObjectMember]
+        members: Dict[str, ObjectMember] = {}
         for name in dir(self.object):
             try:
                 value = safe_getattr(self.object, name, None)
@@ -1167,8 +1167,8 @@ class DocstringSignatureMixin:
     Mixin for FunctionDocumenter and MethodDocumenter to provide the
     feature of reading the signature from the docstring.
     """
-    _new_docstrings = None  # type: List[List[str]]
-    _signatures = None      # type: List[str]
+    _new_docstrings: List[List[str]] = None
+    _signatures: List[str] = None
 
     def _find_signature(self) -> Tuple[str, str]:
         # candidates of the object name
@@ -1429,8 +1429,8 @@ class ClassDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter):  # type:
         'private-members': members_option, 'special-members': members_option,
     }
 
-    _signature_class = None  # type: Any
-    _signature_method_name = None  # type: str
+    _signature_class: Any = None
+    _signature_method_name: str = None
 
     def __init__(self, *args: Any) -> None:
         super().__init__(*args)
@@ -1727,12 +1727,12 @@ def can_document_member(cls, member: Any, membername: str, isattr: bool, parent:
 
 class DataDocumenterMixinBase:
     # define types of instance variables
-    config = None  # type: Config
-    env = None  # type: BuildEnvironment
-    modname = None  # type: str
-    parent = None  # type: Any
-    object = None  # type: Any
-    objpath = None  # type: List[str]
+    config: Config = None
+    env: BuildEnvironment = None
+    modname: str = None
+    parent: Any = None
+    object: Any = None
+    objpath: List[str] = None
 
     def should_suppress_directive_header(self) -> bool:
         """Check directive header should be suppressed."""
diff --git a/sphinx/ext/autodoc/directive.py b/sphinx/ext/autodoc/directive.py
index 69177f27179..78e17b867b9 100644
--- a/sphinx/ext/autodoc/directive.py
+++ b/sphinx/ext/autodoc/directive.py
@@ -56,7 +56,7 @@ def __init__(self, env: BuildEnvironment, reporter: Reporter, options: Options,
         self._reporter = reporter
         self.genopt = options
         self.lineno = lineno
-        self.filename_set = set()  # type: Set[str]
+        self.filename_set: Set[str] = set()
         self.result = StringList()
         self.state = state
 
@@ -101,7 +101,7 @@ def parse_generated_content(state: RSTState, content: StringList, documenter: Do
     """Parse a generated content by Documenter."""
     with switch_source_input(state, content):
         if documenter.titles_allowed:
-            node = nodes.section()  # type: Element
+            node: Element = nodes.section()
             # necessary so that the child nodes get the right source/line set
             node.document = state.document
             nested_parse_with_titles(state, content, node)
diff --git a/sphinx/ext/autodoc/importer.py b/sphinx/ext/autodoc/importer.py
index 6660391630e..ebb60b38bdb 100644
--- a/sphinx/ext/autodoc/importer.py
+++ b/sphinx/ext/autodoc/importer.py
@@ -147,7 +147,7 @@ def get_module_members(module: Any) -> List[Tuple[str, Any]]:
     warnings.warn('sphinx.ext.autodoc.importer.get_module_members() is deprecated.',
                   RemovedInSphinx50Warning)
 
-    members = {}  # type: Dict[str, Tuple[str, Any]]
+    members: Dict[str, Tuple[str, Any]] = {}
     for name in dir(module):
         try:
             value = safe_getattr(module, name, None)
@@ -177,7 +177,7 @@ def get_object_members(subject: Any, objpath: List[str], attrgetter: Callable,
     # the members directly defined in the class
     obj_dict = attrgetter(subject, '__dict__', {})
 
-    members = {}  # type: Dict[str, Attribute]
+    members: Dict[str, Attribute] = {}
 
     # enum members
     if isenumclass(subject):
@@ -238,7 +238,7 @@ def get_class_members(subject: Any, objpath: List[str], attrgetter: Callable
     # the members directly defined in the class
     obj_dict = attrgetter(subject, '__dict__', {})
 
-    members = {}  # type: Dict[str, ObjectMember]
+    members: Dict[str, ObjectMember] = {}
 
     # enum members
     if isenumclass(subject):
diff --git a/sphinx/ext/autodoc/mock.py b/sphinx/ext/autodoc/mock.py
index 80e3d2b50ba..b562f47fd71 100644
--- a/sphinx/ext/autodoc/mock.py
+++ b/sphinx/ext/autodoc/mock.py
@@ -27,7 +27,7 @@ class _MockObject:
 
     __display_name__ = '_MockObject'
     __sphinx_mock__ = True
-    __sphinx_decorator_args__ = ()  # type: Tuple[Any, ...]
+    __sphinx_decorator_args__: Tuple[Any, ...] = ()
 
     def __new__(cls, *args: Any, **kwargs: Any) -> Any:
         if len(args) == 3 and isinstance(args[1], tuple):
@@ -86,8 +86,8 @@ class _MockModule(ModuleType):
 
     def __init__(self, name: str) -> None:
         super().__init__(name)
-        self.__all__ = []  # type: List[str]
-        self.__path__ = []  # type: List[str]
+        self.__all__: List[str] = []
+        self.__path__: List[str] = []
 
     def __getattr__(self, name: str) -> _MockObject:
         return _make_subclass(name, self.__name__)()
@@ -118,7 +118,7 @@ def __init__(self, modnames: List[str]) -> None:
         super().__init__()
         self.modnames = modnames
         self.loader = MockLoader(self)
-        self.mocked_modules = []  # type: List[str]
+        self.mocked_modules: List[str] = []
 
     def find_spec(self, fullname: str, path: Optional[Sequence[Union[bytes, str]]],
                   target: ModuleType = None) -> Optional[ModuleSpec]:
diff --git a/sphinx/ext/autodoc/typehints.py b/sphinx/ext/autodoc/typehints.py
index 533b71e4200..9811bdb554c 100644
--- a/sphinx/ext/autodoc/typehints.py
+++ b/sphinx/ext/autodoc/typehints.py
@@ -80,7 +80,7 @@ def insert_field_list(node: Element) -> nodes.field_list:
 
 
 def modify_field_list(node: nodes.field_list, annotations: Dict[str, str]) -> None:
-    arguments = {}  # type: Dict[str, Dict[str, bool]]
+    arguments: Dict[str, Dict[str, bool]] = {}
     fields = cast(Iterable[nodes.field], node)
     for field in fields:
         field_name = field[0].astext()
diff --git a/sphinx/ext/autosummary/generate.py b/sphinx/ext/autosummary/generate.py
index 59f526744d1..2b17ccbb967 100644
--- a/sphinx/ext/autosummary/generate.py
+++ b/sphinx/ext/autosummary/generate.py
@@ -59,7 +59,7 @@ class DummyApplication:
     def __init__(self, translator: NullTranslations) -> None:
         self.config = Config()
         self.registry = SphinxComponentRegistry()
-        self.messagelog = []  # type: List[str]
+        self.messagelog: List[str] = []
         self.srcdir = "/"
         self.translator = translator
         self.verbosity = 0
diff --git a/sphinx/ext/coverage.py b/sphinx/ext/coverage.py
index f052b8810a9..75460348e45 100644
--- a/sphinx/ext/coverage.py
+++ b/sphinx/ext/coverage.py
@@ -53,19 +53,19 @@ class CoverageBuilder(Builder):
                 'results in %(outdir)s' + path.sep + 'python.txt.')
 
     def init(self) -> None:
-        self.c_sourcefiles = []  # type: List[str]
+        self.c_sourcefiles: List[str] = []
         for pattern in self.config.coverage_c_path:
             pattern = path.join(self.srcdir, pattern)
             self.c_sourcefiles.extend(glob.glob(pattern))
 
-        self.c_regexes = []  # type: List[Tuple[str, Pattern]]
+        self.c_regexes: List[Tuple[str, Pattern]] = []
         for (name, exp) in self.config.coverage_c_regexes.items():
             try:
                 self.c_regexes.append((name, re.compile(exp)))
             except Exception:
                 logger.warning(__('invalid regex %r in coverage_c_regexes'), exp)
 
-        self.c_ignorexps = {}  # type: Dict[str, List[Pattern]]
+        self.c_ignorexps: Dict[str, List[Pattern]] = {}
         for (name, exps) in self.config.coverage_ignore_c_items.items():
             self.c_ignorexps[name] = compile_regex_list('coverage_ignore_c_items',
                                                         exps)
@@ -82,11 +82,11 @@ def get_outdated_docs(self) -> str:
         return 'coverage overview'
 
     def write(self, *ignored: Any) -> None:
-        self.py_undoc = {}  # type: Dict[str, Dict[str, Any]]
+        self.py_undoc: Dict[str, Dict[str, Any]] = {}
         self.build_py_coverage()
         self.write_py_coverage()
 
-        self.c_undoc = {}  # type: Dict[str, Set[Tuple[str, str]]]
+        self.c_undoc: Dict[str, Set[Tuple[str, str]]] = {}
         self.build_c_coverage()
         self.write_c_coverage()
 
@@ -94,7 +94,7 @@ def build_c_coverage(self) -> None:
         # Fetch all the info from the header files
         c_objects = self.env.domaindata['c']['objects']
         for filename in self.c_sourcefiles:
-            undoc = set()  # type: Set[Tuple[str, str]]
+            undoc: Set[Tuple[str, str]] = set()
             with open(filename) as f:
                 for line in f:
                     for key, regex in self.c_regexes:
@@ -161,7 +161,7 @@ def build_py_coverage(self) -> None:
                 continue
 
             funcs = []
-            classes = {}  # type: Dict[str, List[str]]
+            classes: Dict[str, List[str]] = {}
 
             for name, obj in inspect.getmembers(mod):
                 # diverse module attributes are ignored:
@@ -200,7 +200,7 @@ def build_py_coverage(self) -> None:
                             classes[name] = []
                             continue
 
-                        attrs = []  # type: List[str]
+                        attrs: List[str] = []
 
                         for attr_name in dir(obj):
                             if attr_name not in obj.__dict__:
diff --git a/sphinx/ext/graphviz.py b/sphinx/ext/graphviz.py
index f10edfaae8b..b1c5ca481ff 100644
--- a/sphinx/ext/graphviz.py
+++ b/sphinx/ext/graphviz.py
@@ -50,10 +50,10 @@ class ClickableMapDefinition:
     href_re = re.compile('href=".*?"')
 
     def __init__(self, filename: str, content: str, dot: str = '') -> None:
-        self.id = None  # type: str
+        self.id: str = None
         self.filename = filename
         self.content = content.splitlines()
-        self.clickable = []  # type: List[str]
+        self.clickable: List[str] = []
 
         self.parse(dot=dot)
 
diff --git a/sphinx/ext/inheritance_diagram.py b/sphinx/ext/inheritance_diagram.py
index 62b80ac39df..377f85d3a76 100644
--- a/sphinx/ext/inheritance_diagram.py
+++ b/sphinx/ext/inheritance_diagram.py
@@ -155,7 +155,7 @@ def __init__(self, class_names: List[str], currmodule: str, show_builtins: bool
 
     def _import_classes(self, class_names: List[str], currmodule: str) -> List[Any]:
         """Import a list of classes."""
-        classes = []  # type: List[Any]
+        classes: List[Any] = []
         for name in class_names:
             classes.extend(import_classes(name, currmodule))
         return classes
@@ -199,7 +199,7 @@ def recurse(cls: Any) -> None:
             except Exception:  # might raise AttributeError for strange classes
                 pass
 
-            baselist = []  # type: List[str]
+            baselist: List[str] = []
             all_classes[cls] = (nodename, fullname, baselist, tooltip)
 
             if fullname in top_classes:
@@ -293,7 +293,7 @@ def generate_dot(self, name: str, urls: Dict = {}, env: BuildEnvironment = None,
             n_attrs.update(env.config.inheritance_node_attrs)
             e_attrs.update(env.config.inheritance_edge_attrs)
 
-        res = []  # type: List[str]
+        res: List[str] = []
         res.append('digraph %s {\n' % name)
         res.append(self._format_graph_attrs(g_attrs))
 
diff --git a/sphinx/ext/intersphinx.py b/sphinx/ext/intersphinx.py
index a01bcc37ab6..5c6af2dfb75 100644
--- a/sphinx/ext/intersphinx.py
+++ b/sphinx/ext/intersphinx.py
@@ -264,7 +264,7 @@ def missing_reference(app: Sphinx, env: BuildEnvironment, node: pending_xref,
     """Attempt to resolve a missing reference via intersphinx references."""
     target = node['reftarget']
     inventories = InventoryAdapter(env)
-    objtypes = None  # type: List[str]
+    objtypes: List[str] = None
     if node['reftype'] == 'any':
         # we search anything!
         objtypes = ['%s:%s' % (domain.name, objtype)
@@ -398,7 +398,7 @@ def inspect_main(argv: List[str]) -> None:
         sys.exit(1)
 
     class MockConfig:
-        intersphinx_timeout = None  # type: int
+        intersphinx_timeout: int = None
         tls_verify = False
         user_agent = None
 
diff --git a/sphinx/ext/linkcode.py b/sphinx/ext/linkcode.py
index 5c118a9fbbf..6aaea0e9e52 100644
--- a/sphinx/ext/linkcode.py
+++ b/sphinx/ext/linkcode.py
@@ -41,7 +41,7 @@ def doctree_read(app: Sphinx, doctree: Node) -> None:
 
     for objnode in doctree.traverse(addnodes.desc):
         domain = objnode.get('domain')
-        uris = set()  # type: Set[str]
+        uris: Set[str] = set()
         for signode in objnode:
             if not isinstance(signode, addnodes.desc_signature):
                 continue
diff --git a/sphinx/ext/napoleon/__init__.py b/sphinx/ext/napoleon/__init__.py
index 4a8c2135aa7..ba8f62a1833 100644
--- a/sphinx/ext/napoleon/__init__.py
+++ b/sphinx/ext/napoleon/__init__.py
@@ -388,7 +388,7 @@ def _process_docstring(app: Sphinx, what: str, name: str, obj: Any,
 
     """
     result_lines = lines
-    docstring = None  # type: GoogleDocstring
+    docstring: GoogleDocstring = None
     if app.config.napoleon_numpy_docstring:
         docstring = NumpyDocstring(result_lines, app.config, app, what, name,
                                    obj, options)
diff --git a/sphinx/ext/napoleon/docstring.py b/sphinx/ext/napoleon/docstring.py
index 734adc49504..50c7309a510 100644
--- a/sphinx/ext/napoleon/docstring.py
+++ b/sphinx/ext/napoleon/docstring.py
@@ -162,13 +162,13 @@ def __init__(self, docstring: Union[str, List[str]], config: SphinxConfig = None
         else:
             lines = docstring
         self._line_iter = modify_iter(lines, modifier=lambda s: s.rstrip())
-        self._parsed_lines = []  # type: List[str]
+        self._parsed_lines: List[str] = []
         self._is_in_section = False
         self._section_indent = 0
         if not hasattr(self, '_directive_sections'):
-            self._directive_sections = []  # type: List[str]
+            self._directive_sections: List[str] = []
         if not hasattr(self, '_sections'):
-            self._sections = {
+            self._sections: Dict[str, Callable] = {
                 'args': self._parse_parameters_section,
                 'arguments': self._parse_parameters_section,
                 'attention': partial(self._parse_admonition, 'attention'),
@@ -203,7 +203,7 @@ def __init__(self, docstring: Union[str, List[str]], config: SphinxConfig = None
                 'warns': self._parse_warns_section,
                 'yield': self._parse_yields_section,
                 'yields': self._parse_yields_section,
-            }  # type: Dict[str, Callable]
+            }
 
         self._load_custom_sections()
 
@@ -461,7 +461,7 @@ def _format_fields(self, field_type: str, fields: List[Tuple[str, str, List[str]
         field_type = ':%s:' % field_type.strip()
         padding = ' ' * len(field_type)
         multi = len(fields) > 1
-        lines = []  # type: List[str]
+        lines: List[str] = []
         for _name, _type, _desc in fields:
             field = self._format_field(_name, _type, _desc)
             if multi:
@@ -585,7 +585,7 @@ def _parse(self) -> None:
         if self._name and self._what in ('attribute', 'data', 'property'):
             # Implicit stop using StopIteration no longer allowed in
             # Python 3.7; see PEP 479
-            res = []  # type: List[str]
+            res: List[str] = []
             try:
                 res = self._parse_attribute_docstring()
             except StopIteration:
@@ -703,7 +703,7 @@ def _parse_keyword_arguments_section(self, section: str) -> List[str]:
             return self._format_fields(_('Keyword Arguments'), fields)
 
     def _parse_methods_section(self, section: str) -> List[str]:
-        lines = []  # type: List[str]
+        lines: List[str] = []
         for _name, _type, _desc in self._consume_fields(parse_type=False):
             lines.append('.. method:: %s' % _name)
             if self._opt and 'noindex' in self._opt:
@@ -737,7 +737,7 @@ def _parse_parameters_section(self, section: str) -> List[str]:
 
     def _parse_raises_section(self, section: str) -> List[str]:
         fields = self._consume_fields(parse_type=False, prefer_type=True)
-        lines = []  # type: List[str]
+        lines: List[str] = []
         for _name, _type, _desc in fields:
             m = self._name_rgx.match(_type)
             if m and m.group('name'):
@@ -774,7 +774,7 @@ def _parse_returns_section(self, section: str) -> List[str]:
         else:
             use_rtype = self._config.napoleon_use_rtype
 
-        lines = []  # type: List[str]
+        lines: List[str] = []
         for _name, _type, _desc in fields:
             if use_rtype:
                 field = self._format_field(_name, '', _desc)
@@ -1281,7 +1281,7 @@ def translate(func, description, role):
             return new_func, description, role
 
         current_func = None
-        rest = []  # type: List[str]
+        rest: List[str] = []
 
         for line in content:
             if not line.strip():
@@ -1316,7 +1316,7 @@ def translate(func, description, role):
             for func, description, role in items
         ]
 
-        lines = []  # type: List[str]
+        lines: List[str] = []
         last_had_desc = True
         for name, desc, role in items:
             if role:
diff --git a/sphinx/ext/napoleon/iterators.py b/sphinx/ext/napoleon/iterators.py
index e0f5cca9c30..0e865ad8198 100644
--- a/sphinx/ext/napoleon/iterators.py
+++ b/sphinx/ext/napoleon/iterators.py
@@ -49,8 +49,8 @@ class peek_iter:
     """
     def __init__(self, *args: Any) -> None:
         """__init__(o, sentinel=None)"""
-        self._iterable = iter(*args)        # type: Iterable
-        self._cache = collections.deque()   # type: collections.deque
+        self._iterable: Iterable = iter(*args)
+        self._cache: collections.deque = collections.deque()
         if len(args) == 2:
             self.sentinel = args[1]
         else:

From 7e0295dbd7cc83d9512b308c56967b844e5cc528 Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Mon, 15 Mar 2021 11:06:33 +0100
Subject: [PATCH 202/305] LaTeX: partially revert #8997 \pysigline

Reason is that mark-up such as this:

   .. attribute:: state
                  state_machine

      The state and state machine which controls the parsing.  Used for
      ``nested_parse``.

generates two `\pysigline` each with `\phantomsection`. The latex code
to get good vertical spacing between label and its description, if label
``\parbox`` is multi-line, cause in this context the two (generally,
single-line) labels to be stacked vertically with no spacing.

This commit keeps the ``\parbox`` which fixes #8980, but drops the
attempt to correct vertical distance to description, so as to not alter
the possibly more common use case of items with common description.
---
 sphinx/texinputs/sphinxlatexobjects.sty | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/sphinx/texinputs/sphinxlatexobjects.sty b/sphinx/texinputs/sphinxlatexobjects.sty
index 810d3f2f89f..e00881e53af 100644
--- a/sphinx/texinputs/sphinxlatexobjects.sty
+++ b/sphinx/texinputs/sphinxlatexobjects.sty
@@ -91,14 +91,20 @@
 % \relax only ends its "dimen" part
   \py@argswidth=\dimexpr\linewidth+\labelwidth\relax\relax
   \item[{\parbox[t]{\py@argswidth}{\raggedright #1\strut}}]
-% this strange incantation is because at its root LaTeX in fact did not
-% imagine a multi-line label, it is always wrapped in a horizontal box at core
-% LaTeX level and we have to find tricks to get correct interline distances.
-  \leavevmode\par\nobreak\vskip-\parskip\prevdepth\dp\strutbox}
+% contrarily to \pysiglinewithargsret, we do not do this:
+%  \leavevmode\par\nobreak\vskip-\parskip\prevdepth\dp\strutbox
+% which would give exact vertical spacing if item parbox is multi-line,
+% as it affects negatively more common situation of \pysigline
+% used twice or more in a row for labels sharing common description,
+% due to bad interaction with the \phantomsection in the mark-up
+}
 \newcommand{\pysiglinewithargsret}[3]{%
   \settowidth{\py@argswidth}{#1\sphinxcode{(}}%
   \py@argswidth=\dimexpr\linewidth+\labelwidth-\py@argswidth\relax\relax
   \item[{#1\sphinxcode{(}\py@sigparams{#2}{#3}}]
+% this strange incantation is because at its root LaTeX in fact did not
+% imagine a multi-line label, it is always wrapped in a horizontal box at core
+% LaTeX level and we have to find tricks to get correct interline distances.
   \leavevmode\par\nobreak\vskip-\parskip\prevdepth\dp\strutbox}
 \newcommand{\pysigstartmultiline}{%
  \def\pysigstartmultiline{\vskip\smallskipamount\parskip\z@skip\itemsep\z@skip}%

From 45f56dd7acafe85d30db183af21a9dcb068c5e88 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 16 Mar 2021 01:28:07 +0900
Subject: [PATCH 203/305] Fix #9008: Fix typo

---
 doc/usage/quickstart.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/quickstart.rst b/doc/usage/quickstart.rst
index 1d7e540a6a4..3cd6ac99369 100644
--- a/doc/usage/quickstart.rst
+++ b/doc/usage/quickstart.rst
@@ -13,7 +13,7 @@ Sphinx focuses on documentation, in particular handwritten documentation,
 however, Sphinx can also be used to generate blogs, homepages and even books.
 Much of Sphinx's power comes from the richness of its default plain-text markup
 format, :doc:`reStructuredText </usage/restructuredtext/index>`, along with
-it's :doc:`significant extensibility capabilities </development/index>`.
+its :doc:`significant extensibility capabilities </development/index>`.
 
 The goal of this document is to give you a quick taste of what Sphinx is and
 how you might use it. When you're done here, you can check out the

From 3937ea816ffcf381d3af0356f58083639f69e0f7 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 16 Mar 2021 01:33:27 +0900
Subject: [PATCH 204/305] Fix #9009: LaTeX: "release" value with underscore
 leads to invalid LaTeX

The "release" variable is not escaped on the LaTeX output.
---
 CHANGES                            | 1 +
 sphinx/templates/latex/latex.tex_t | 2 +-
 tests/test_build_latex.py          | 4 ++--
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index f449442bb47..5ccb86c9876 100644
--- a/CHANGES
+++ b/CHANGES
@@ -107,6 +107,7 @@ Bugs fixed
 * #8980: LaTeX: missing line break in ``\pysigline``
 * #8995: LaTeX: legacy ``\pysiglinewithargsret`` does not compute correctly
   available  horizontal space and should use a ragged right style
+* #9009: LaTeX: "release" value with underscore leads to invalid LaTeX
 * #8911: C++: remove the longest matching prefix in
   :confval:`cpp_index_common_prefix` instead of the first that matches.
 * C, properly reject function declarations when a keyword is used
diff --git a/sphinx/templates/latex/latex.tex_t b/sphinx/templates/latex/latex.tex_t
index 43ad04b0e14..a9fba98d020 100644
--- a/sphinx/templates/latex/latex.tex_t
+++ b/sphinx/templates/latex/latex.tex_t
@@ -71,7 +71,7 @@
 
 \title{<%= title %>}
 \date{<%= date %>}
-\release{<%= release %>}
+\release{<%= release | e %>}
 \author{<%= author %>}
 <%- if logofilename %>
 \newcommand{\sphinxlogo}{\sphinxincludegraphics{<%= logofilename %>}\par}
diff --git a/tests/test_build_latex.py b/tests/test_build_latex.py
index c8c94b44bd3..bb1904d2c2f 100644
--- a/tests/test_build_latex.py
+++ b/tests/test_build_latex.py
@@ -277,14 +277,14 @@ def test_latex_title_after_admonitions(app, status, warning):
 
 
 @pytest.mark.sphinx('latex', testroot='basic',
-                    confoverrides={'release': '1.0'})
+                    confoverrides={'release': '1.0_0'})
 def test_latex_release(app, status, warning):
     app.builder.build_all()
     result = (app.outdir / 'test.tex').read_text()
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
-    assert r'\release{1.0}' in result
+    assert r'\release{1.0\_0}' in result
     assert r'\renewcommand{\releasename}{Release}' in result
 
 

From 8c7e7797310ee6667f4e1214518b0e67fdb2a4c6 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Wed, 17 Mar 2021 23:35:41 +0900
Subject: [PATCH 205/305] Fix #8992: autodoc: Failed to resolve
 types.TracebackType type annotation

The builtin module, ``types.TracebackType`` does not have correct module
name.  This allows to refer it automatically.
---
 CHANGES                   |  1 +
 sphinx/util/typing.py     | 18 ++++++++++++------
 tests/test_util_typing.py |  5 ++++-
 3 files changed, 17 insertions(+), 7 deletions(-)

diff --git a/CHANGES b/CHANGES
index 5ccb86c9876..5327660c0ef 100644
--- a/CHANGES
+++ b/CHANGES
@@ -89,6 +89,7 @@ Bugs fixed
 * #8917: autodoc: Raises a warning if function has wrong __globals__ value
 * #8415: autodoc: a TypeVar imported from other module is not resolved (in
   Python 3.7 or above)
+* #8992: autodoc: Failed to resolve types.TracebackType type annotation
 * #8905: html: html_add_permalinks=None and html_add_permalinks="" are ignored
 * #8380: html search: Paragraphs in search results are not identified as ``<p>``
 * #8915: html theme: The translation of sphinx_rtd_theme does not work
diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py
index 128fbd5428d..450bc40e689 100644
--- a/sphinx/util/typing.py
+++ b/sphinx/util/typing.py
@@ -11,6 +11,7 @@
 import sys
 import typing
 from struct import Struct
+from types import TracebackType
 from typing import Any, Callable, Dict, Generator, List, Optional, Tuple, TypeVar, Union
 
 from docutils import nodes
@@ -42,6 +43,13 @@ def _evaluate(self, globalns: Dict, localns: Dict) -> Any:
     from typing import Type  # NOQA # for python3.5.1
 
 
+# builtin classes that have incorrect __module__
+INVALID_BUILTIN_CLASSES = {
+    Struct: 'struct.Struct',  # Before Python 3.9
+    TracebackType: 'types.TracebackType',
+}
+
+
 # Text like nodes which are initialized with text and rawsource
 TextlikeNode = Union[nodes.Text, nodes.TextElement]
 
@@ -101,9 +109,8 @@ def restify(cls: Optional["Type"]) -> str:
         return ':obj:`None`'
     elif cls is Ellipsis:
         return '...'
-    elif cls is Struct:
-        # Before Python 3.9, struct.Struct class has incorrect __module__.
-        return ':class:`struct.Struct`'
+    elif cls in INVALID_BUILTIN_CLASSES:
+        return ':class:`%s`' % INVALID_BUILTIN_CLASSES[cls]
     elif inspect.isNewType(cls):
         return ':class:`%s`' % cls.__name__
     elif types_Union and isinstance(cls, types_Union):
@@ -276,14 +283,13 @@ def stringify(annotation: Any) -> str:
         return repr(annotation)
     elif annotation is NoneType:
         return 'None'
+    elif annotation in INVALID_BUILTIN_CLASSES:
+        return INVALID_BUILTIN_CLASSES[annotation]
     elif (getattr(annotation, '__module__', None) == 'builtins' and
           hasattr(annotation, '__qualname__')):
         return annotation.__qualname__
     elif annotation is Ellipsis:
         return '...'
-    elif annotation is Struct:
-        # Before Python 3.9, struct.Struct class has incorrect __module__.
-        return 'struct.Struct'
 
     if sys.version_info >= (3, 7):  # py37+
         return _stringify_py37(annotation)
diff --git a/tests/test_util_typing.py b/tests/test_util_typing.py
index 97732965e89..5a5808ac5d4 100644
--- a/tests/test_util_typing.py
+++ b/tests/test_util_typing.py
@@ -11,6 +11,7 @@
 import sys
 from numbers import Integral
 from struct import Struct
+from types import TracebackType
 from typing import (Any, Callable, Dict, Generator, List, NewType, Optional, Tuple, TypeVar,
                     Union)
 
@@ -45,6 +46,7 @@ def test_restify():
     assert restify(None) == ":obj:`None`"
     assert restify(Integral) == ":class:`numbers.Integral`"
     assert restify(Struct) == ":class:`struct.Struct`"
+    assert restify(TracebackType) == ":class:`types.TracebackType`"
     assert restify(Any) == ":obj:`Any`"
 
 
@@ -133,7 +135,8 @@ def test_stringify():
     assert stringify(str) == "str"
     assert stringify(None) == "None"
     assert stringify(Integral) == "numbers.Integral"
-    assert restify(Struct) == ":class:`struct.Struct`"
+    assert stringify(Struct) == "struct.Struct"
+    assert stringify(TracebackType) == "types.TracebackType"
     assert stringify(Any) == "Any"
 
 

From cb654d287b0296a5acc539f962c7ef1ecc4a523f Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 21 Mar 2021 00:52:49 +0900
Subject: [PATCH 206/305] Rename DocumenterBridge.filename_set to
 record_dependencies

DocumenterBridge.filename_set has been used since its beginning.  On the
other hand, in docutils, record_dependencies attribute is well-used to
store the list of dependency files.  So this renames it to docutils'
standard attribute.
---
 CHANGES                         |  1 +
 doc/extdev/deprecated.rst       |  5 +++++
 sphinx/ext/autodoc/__init__.py  |  6 +++---
 sphinx/ext/autodoc/directive.py | 12 +++++++++---
 tests/test_ext_autodoc.py       |  2 +-
 5 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/CHANGES b/CHANGES
index b14d1fa572a..ae3c552806d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -51,6 +51,7 @@ Deprecated
 * ``sphinx.directives.patches.CSVTable``
 * ``sphinx.directives.patches.ListTable``
 * ``sphinx.directives.patches.RSTTable``
+* ``sphinx.ext.autodoc.directive.DocumenterBridge.filename_set``
 * ``sphinx.registry.SphinxComponentRegistry.get_source_input()``
 * ``sphinx.registry.SphinxComponentRegistry.source_inputs``
 * ``sphinx.transforms.FigureAligner``
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index 3fdb55e2c17..519d40f9561 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -42,6 +42,11 @@ The following is a list of deprecated interfaces.
      - 6.0
      - ``docutils.parsers.rst.diretives.tables.RSTTable``
 
+   * - ``sphinx.ext.autodoc.directive.DocumenterBridge.filename_set``
+     - 4.0
+     - 6.0
+     - ``sphinx.ext.autodoc.directive.DocumenterBridge.record_dependencies``
+
    * - ``sphinx.registry.SphinxComponentRegistry.get_source_input()``
      - 4.0
      - 6.0
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index fe6b483d4b5..a01402090bc 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -918,15 +918,15 @@ def generate(self, more_content: Optional[StringList] = None, real_modname: str
             self.analyzer = None
             # at least add the module.__file__ as a dependency
             if hasattr(self.module, '__file__') and self.module.__file__:
-                self.directive.filename_set.add(self.module.__file__)
+                self.directive.record_dependencies.add(self.module.__file__)
         else:
-            self.directive.filename_set.add(self.analyzer.srcname)
+            self.directive.record_dependencies.add(self.analyzer.srcname)
 
         if self.real_modname != guess_modname:
             # Add module to dependency list if target object is defined in other module.
             try:
                 analyzer = ModuleAnalyzer.for_module(guess_modname)
-                self.directive.filename_set.add(analyzer.srcname)
+                self.directive.record_dependencies.add(analyzer.srcname)
             except PycodeError:
                 pass
 
diff --git a/sphinx/ext/autodoc/directive.py b/sphinx/ext/autodoc/directive.py
index 78e17b867b9..a6608698db1 100644
--- a/sphinx/ext/autodoc/directive.py
+++ b/sphinx/ext/autodoc/directive.py
@@ -16,7 +16,7 @@
 from docutils.utils import Reporter, assemble_option_dict
 
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx50Warning
+from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning
 from sphinx.environment import BuildEnvironment
 from sphinx.ext.autodoc import Documenter, Options
 from sphinx.util import logging
@@ -56,13 +56,19 @@ def __init__(self, env: BuildEnvironment, reporter: Reporter, options: Options,
         self._reporter = reporter
         self.genopt = options
         self.lineno = lineno
-        self.filename_set: Set[str] = set()
+        self.record_dependencies: Set[str] = set()
         self.result = StringList()
         self.state = state
 
     def warn(self, msg: str) -> None:
         logger.warning(msg, location=(self.env.docname, self.lineno))
 
+    @property
+    def filename_set(self) -> Set:
+        warnings.warn('DocumenterBridge.filename_set is deprecated.',
+                      RemovedInSphinx60Warning, stacklevel=2)
+        return self.record_dependencies
+
     @property
     def reporter(self) -> Reporter:
         warnings.warn('DocumenterBridge.reporter is deprecated.',
@@ -158,7 +164,7 @@ def run(self) -> List[Node]:
 
         # record all filenames as dependencies -- this will at least
         # partially make automatic invalidation possible
-        for fn in params.filename_set:
+        for fn in params.record_dependencies:
             self.state.document.settings.record_dependencies.add(fn)
 
         result = parse_generated_content(self.state, params.result, documenter)
diff --git a/tests/test_ext_autodoc.py b/tests/test_ext_autodoc.py
index 7c6f4e0d674..8ea799f4973 100644
--- a/tests/test_ext_autodoc.py
+++ b/tests/test_ext_autodoc.py
@@ -68,7 +68,7 @@ def make_directive_bridge(env):
         env = env,
         genopt = options,
         result = ViewList(),
-        filename_set = set(),
+        record_dependencies = set(),
         state = Mock(),
     )
     directive.state.document.settings.tab_width = 8

From 6007bbf797000e818daa220aa39e46c744240024 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 21 Mar 2021 01:09:03 +0900
Subject: [PATCH 207/305] Deprecate DocumenterBridge.warn()

Since 1.6, sphinx.util.logging module became the default logging
interface of Sphinx. It allows sphinx-components to output log
without the app (or env) object.  According to the policy,
DocumenterBridge.warn() is no longer needed and should be replaced by
the logging module.
---
 CHANGES                         | 1 +
 doc/extdev/deprecated.rst       | 5 +++++
 sphinx/ext/autodoc/directive.py | 3 +++
 3 files changed, 9 insertions(+)

diff --git a/CHANGES b/CHANGES
index ae3c552806d..ee7e33cb1b0 100644
--- a/CHANGES
+++ b/CHANGES
@@ -52,6 +52,7 @@ Deprecated
 * ``sphinx.directives.patches.ListTable``
 * ``sphinx.directives.patches.RSTTable``
 * ``sphinx.ext.autodoc.directive.DocumenterBridge.filename_set``
+* ``sphinx.ext.autodoc.directive.DocumenterBridge.warn()``
 * ``sphinx.registry.SphinxComponentRegistry.get_source_input()``
 * ``sphinx.registry.SphinxComponentRegistry.source_inputs``
 * ``sphinx.transforms.FigureAligner``
diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst
index 519d40f9561..9e17b9fb4f0 100644
--- a/doc/extdev/deprecated.rst
+++ b/doc/extdev/deprecated.rst
@@ -47,6 +47,11 @@ The following is a list of deprecated interfaces.
      - 6.0
      - ``sphinx.ext.autodoc.directive.DocumenterBridge.record_dependencies``
 
+   * - ``sphinx.ext.autodoc.directive.DocumenterBridge.warn()``
+     - 4.0
+     - 6.0
+     - :ref:`logging-api`
+
    * - ``sphinx.registry.SphinxComponentRegistry.get_source_input()``
      - 4.0
      - 6.0
diff --git a/sphinx/ext/autodoc/directive.py b/sphinx/ext/autodoc/directive.py
index a6608698db1..8ed622d23e7 100644
--- a/sphinx/ext/autodoc/directive.py
+++ b/sphinx/ext/autodoc/directive.py
@@ -61,6 +61,9 @@ def __init__(self, env: BuildEnvironment, reporter: Reporter, options: Options,
         self.state = state
 
     def warn(self, msg: str) -> None:
+        warnings.warn('DocumenterBridge.warn is deprecated.  Plase use sphinx.util.logging '
+                      'module instead.',
+                      RemovedInSphinx60Warning, stacklevel=2)
         logger.warning(msg, location=(self.env.docname, self.lineno))
 
     @property

From 035019629a8d67f83b1556f7d0ba06ea55f7a284 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 19 Mar 2021 01:02:58 +0900
Subject: [PATCH 208/305] refactor: Use PEP-526 based variable annotation
 (sphinx.domains)

---
 sphinx/domains/__init__.py   | 40 ++++++++---------
 sphinx/domains/c.py          | 62 +++++++++++++-------------
 sphinx/domains/changeset.py  |  6 +--
 sphinx/domains/cpp.py        | 84 ++++++++++++++++++------------------
 sphinx/domains/javascript.py |  8 ++--
 sphinx/domains/math.py       |  4 +-
 sphinx/domains/python.py     | 27 ++++++------
 sphinx/domains/rst.py        |  6 +--
 sphinx/domains/std.py        | 41 +++++++++---------
 9 files changed, 139 insertions(+), 139 deletions(-)

diff --git a/sphinx/domains/__init__.py b/sphinx/domains/__init__.py
index d241b1523b7..8f3e6a9552c 100644
--- a/sphinx/domains/__init__.py
+++ b/sphinx/domains/__init__.py
@@ -50,8 +50,8 @@ class ObjType:
 
     def __init__(self, lname: str, *roles: Any, **attrs: Any) -> None:
         self.lname = lname
-        self.roles = roles                      # type: Tuple
-        self.attrs = self.known_attrs.copy()    # type: Dict
+        self.roles: Tuple = roles
+        self.attrs: Dict = self.known_attrs.copy()
         self.attrs.update(attrs)
 
 
@@ -88,9 +88,9 @@ class Index(ABC):
        :rst:role:`ref` role.
     """
 
-    name = None  # type: str
-    localname = None  # type: str
-    shortname = None  # type: str
+    name: str = None
+    localname: str = None
+    shortname: str = None
 
     def __init__(self, domain: "Domain") -> None:
         if self.name is None or self.localname is None:
@@ -181,31 +181,31 @@ class Domain:
     #: domain label: longer, more descriptive (used in messages)
     label = ''
     #: type (usually directive) name -> ObjType instance
-    object_types = {}       # type: Dict[str, ObjType]
+    object_types: Dict[str, ObjType] = {}
     #: directive name -> directive class
-    directives = {}         # type: Dict[str, Any]
+    directives: Dict[str, Any] = {}
     #: role name -> role callable
-    roles = {}              # type: Dict[str, Union[RoleFunction, XRefRole]]
+    roles: Dict[str, Union[RoleFunction, XRefRole]] = {}
     #: a list of Index subclasses
-    indices = []            # type: List[Type[Index]]
+    indices: List[Type[Index]] = []
     #: role name -> a warning message if reference is missing
-    dangling_warnings = {}  # type: Dict[str, str]
+    dangling_warnings: Dict[str, str] = {}
     #: node_class -> (enum_node_type, title_getter)
-    enumerable_nodes = {}   # type: Dict[Type[Node], Tuple[str, Callable]]
+    enumerable_nodes: Dict[Type[Node], Tuple[str, Callable]] = {}
 
     #: data value for a fresh environment
-    initial_data = {}       # type: Dict
+    initial_data: Dict = {}
     #: data value
-    data = None             # type: Dict
+    data: Dict = None
     #: data version, bump this when the format of `self.data` changes
     data_version = 0
 
     def __init__(self, env: "BuildEnvironment") -> None:
-        self.env = env              # type: BuildEnvironment
-        self._role_cache = {}       # type: Dict[str, Callable]
-        self._directive_cache = {}  # type: Dict[str, Callable]
-        self._role2type = {}        # type: Dict[str, List[str]]
-        self._type2role = {}        # type: Dict[str, str]
+        self.env: BuildEnvironment = env
+        self._role_cache: Dict[str, Callable] = {}
+        self._directive_cache: Dict[str, Callable] = {}
+        self._role2type: Dict[str, List[str]] = {}
+        self._type2role: Dict[str, str] = {}
 
         # convert class variables to instance one (to enhance through API)
         self.object_types = dict(self.object_types)
@@ -226,8 +226,8 @@ def __init__(self, env: "BuildEnvironment") -> None:
             for rolename in obj.roles:
                 self._role2type.setdefault(rolename, []).append(name)
             self._type2role[name] = obj.roles[0] if obj.roles else ''
-        self.objtypes_for_role = self._role2type.get    # type: Callable[[str], List[str]]
-        self.role_for_objtype = self._type2role.get     # type: Callable[[str], str]
+        self.objtypes_for_role: Callable[[str], List[str]] = self._role2type.get
+        self.role_for_objtype: Callable[[str], str] = self._type2role.get
 
     def setup(self) -> None:
         """Set up domain object."""
diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index ed02701d426..72b9746ac1d 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -725,7 +725,7 @@ def mergeWith(self, other: "ASTDeclSpecsSimple") -> "ASTDeclSpecsSimple":
                                   self.attrs + other.attrs)
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        res = []  # type: List[str]
+        res: List[str] = []
         res.extend(transform(attr) for attr in self.attrs)
         if self.storage:
             res.append(self.storage)
@@ -779,7 +779,7 @@ def __init__(self, outer: str,
         self.trailingTypeSpec = trailing
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        res = []  # type: List[str]
+        res: List[str] = []
         l = transform(self.leftSpecs)
         if len(l) > 0:
             res.append(l)
@@ -797,7 +797,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        modifiers = []  # type: List[Node]
+        modifiers: List[Node] = []
 
         def _add(modifiers: List[Node], text: str) -> None:
             if len(modifiers) > 0:
@@ -1369,9 +1369,9 @@ def __init__(self, objectType: str, directiveType: str,
         self.declaration = declaration
         self.semicolon = semicolon
 
-        self.symbol = None  # type: Symbol
+        self.symbol: Symbol = None
         # set by CObject._add_enumerator_to_parent
-        self.enumeratorScopedSymbol = None  # type: Symbol
+        self.enumeratorScopedSymbol: Symbol = None
 
     def clone(self) -> "ASTDeclaration":
         return ASTDeclaration(self.objectType, self.directiveType,
@@ -1503,8 +1503,8 @@ def __init__(self, parent: "Symbol", ident: ASTIdentifier,
                  declaration: ASTDeclaration, docname: str, line: int) -> None:
         self.parent = parent
         # declarations in a single directive are linked together
-        self.siblingAbove = None  # type: Symbol
-        self.siblingBelow = None  # type: Symbol
+        self.siblingAbove: Symbol = None
+        self.siblingBelow: Symbol = None
         self.ident = ident
         self.declaration = declaration
         self.docname = docname
@@ -1513,8 +1513,8 @@ def __init__(self, parent: "Symbol", ident: ASTIdentifier,
         self._assert_invariants()
 
         # Remember to modify Symbol.remove if modifications to the parent change.
-        self._children = []  # type: List[Symbol]
-        self._anonChildren = []  # type: List[Symbol]
+        self._children: List[Symbol] = []
+        self._anonChildren: List[Symbol] = []
         # note: _children includes _anonChildren
         if self.parent:
             self.parent._children.append(self)
@@ -2195,7 +2195,7 @@ def _parse_primary_expression(self) -> ASTExpression:
         # "(" expression ")"
         # id-expression -> we parse this with _parse_nested_name
         self.skip_ws()
-        res = self._parse_literal()  # type: ASTExpression
+        res: ASTExpression = self._parse_literal()
         if res is not None:
             return res
         res = self._parse_paren_expression()
@@ -2270,7 +2270,7 @@ def _parse_postfix_expression(self) -> ASTPostfixExpr:
         prefix = self._parse_primary_expression()
 
         # and now parse postfixes
-        postFixes = []  # type: List[ASTPostfixOp]
+        postFixes: List[ASTPostfixOp] = []
         while True:
             self.skip_ws()
             if self.skip_string_and_ws('['):
@@ -2488,7 +2488,7 @@ def _parse_expression_fallback(
         else:
             # TODO: add handling of more bracket-like things, and quote handling
             brackets = {'(': ')', '{': '}', '[': ']'}
-            symbols = []  # type: List[str]
+            symbols: List[str] = []
             while not self.eof:
                 if (len(symbols) == 0 and self.current_char in end):
                     break
@@ -2504,7 +2504,7 @@ def _parse_expression_fallback(
         return ASTFallbackExpr(value.strip())
 
     def _parse_nested_name(self) -> ASTNestedName:
-        names = []  # type: List[Any]
+        names: List[Any] = []
 
         self.skip_ws()
         rooted = False
@@ -2857,7 +2857,7 @@ def _parse_initializer(self, outer: str = None, allowFallback: bool = True
             return ASTInitializer(bracedInit)
 
         if outer == 'member':
-            fallbackEnd = []  # type: List[str]
+            fallbackEnd: List[str] = []
         elif outer is None:  # function parameter
             fallbackEnd = [',', ')']
         else:
@@ -3004,7 +3004,7 @@ def parser() -> ASTExpression:
 
     def parse_pre_v3_type_definition(self) -> ASTDeclaration:
         self.skip_ws()
-        declaration = None  # type: DeclarationType
+        declaration: DeclarationType = None
         if self.skip_word('struct'):
             typ = 'struct'
             declaration = self._parse_struct()
@@ -3027,7 +3027,7 @@ def parse_declaration(self, objectType: str, directiveType: str) -> ASTDeclarati
                                  'macro', 'struct', 'union', 'enum', 'enumerator', 'type'):
             raise Exception('Internal error, unknown directiveType "%s".' % directiveType)
 
-        declaration = None  # type: DeclarationType
+        declaration: DeclarationType = None
         if objectType == 'member':
             declaration = self._parse_type_with_init(named=True, outer='member')
         elif objectType == 'function':
@@ -3066,7 +3066,7 @@ def parse_xref_object(self) -> ASTNestedName:
 
     def parse_expression(self) -> Union[ASTExpression, ASTType]:
         pos = self.pos
-        res = None  # type: Union[ASTExpression, ASTType]
+        res: Union[ASTExpression, ASTType] = None
         try:
             res = self._parse_expression()
             self.skip_ws()
@@ -3213,7 +3213,7 @@ def run(self) -> List[Node]:
         return super().run()
 
     def handle_signature(self, sig: str, signode: TextElement) -> ASTDeclaration:
-        parentSymbol = self.env.temp_data['c:parent_symbol']  # type: Symbol
+        parentSymbol: Symbol = self.env.temp_data['c:parent_symbol']
 
         parser = DefinitionParser(sig, location=signode, config=self.env.config)
         try:
@@ -3277,10 +3277,10 @@ def handle_signature(self, sig: str, signode: TextElement) -> ASTDeclaration:
         return ast
 
     def before_content(self) -> None:
-        lastSymbol = self.env.temp_data['c:last_symbol']  # type: Symbol
+        lastSymbol: Symbol = self.env.temp_data['c:last_symbol']
         assert lastSymbol
         self.oldParentSymbol = self.env.temp_data['c:parent_symbol']
-        self.oldParentKey = self.env.ref_context['c:parent_key']  # type: LookupKey
+        self.oldParentKey: LookupKey = self.env.ref_context['c:parent_key']
         self.env.temp_data['c:parent_symbol'] = lastSymbol
         self.env.ref_context['c:parent_key'] = lastSymbol.get_lookup_key()
 
@@ -3351,7 +3351,7 @@ def run(self) -> List[Node]:
         rootSymbol = self.env.domaindata['c']['root_symbol']
         if self.arguments[0].strip() in ('NULL', '0', 'nullptr'):
             symbol = rootSymbol
-            stack = []  # type: List[Symbol]
+            stack: List[Symbol] = []
         else:
             parser = DefinitionParser(self.arguments[0],
                                       location=self.get_source_info(),
@@ -3462,7 +3462,7 @@ def _render_symbol(self, s: Symbol, maxdepth: int, skipThis: bool,
             maxdepth -= 1
             recurse = True
 
-        nodes = []  # type: List[Node]
+        nodes: List[Node] = []
         if not skipThis:
             signode = addnodes.desc_signature('', '')
             nodes.append(signode)
@@ -3470,7 +3470,7 @@ def _render_symbol(self, s: Symbol, maxdepth: int, skipThis: bool,
 
         if recurse:
             if skipThis:
-                childContainer = nodes  # type: Union[List[Node], addnodes.desc]
+                childContainer: Union[List[Node], addnodes.desc] = nodes
             else:
                 content = addnodes.desc_content()
                 desc = addnodes.desc()
@@ -3516,8 +3516,8 @@ def apply(self, **kwargs: Any) -> None:
                 node.replace_self(signode)
                 continue
 
-            rootSymbol = self.env.domains['c'].data['root_symbol']  # type: Symbol
-            parentSymbol = rootSymbol.direct_lookup(parentKey)  # type: Symbol
+            rootSymbol: Symbol = self.env.domains['c'].data['root_symbol']
+            parentSymbol: Symbol = rootSymbol.direct_lookup(parentKey)
             if not parentSymbol:
                 print("Target: ", sig)
                 print("ParentKey: ", parentKey)
@@ -3583,7 +3583,7 @@ def run(self) -> List[Node]:
         node['objtype'] = node['desctype'] = self.objtype
         node['noindex'] = True
 
-        self.names = []  # type: List[str]
+        self.names: List[str] = []
         aliasOptions = {
             'maxdepth': self.options.get('maxdepth', 1),
             'noroot': 'noroot' in self.options,
@@ -3661,7 +3661,7 @@ def __init__(self, asCode: bool) -> None:
         if asCode:
             # render the expression as inline code
             self.class_type = 'c-expr'
-            self.node_type = nodes.literal  # type: Type[TextElement]
+            self.node_type: Type[TextElement] = nodes.literal
         else:
             # render the expression as inline text
             self.class_type = 'c-texpr'
@@ -3740,10 +3740,10 @@ class CDomain(Domain):
         'expr': CExprRole(asCode=True),
         'texpr': CExprRole(asCode=False)
     }
-    initial_data = {
+    initial_data: Dict[str, Union[Symbol, Dict[str, Tuple[str, str, str]]]] = {
         'root_symbol': Symbol(None, None, None, None, None),
         'objects': {},  # fullname -> docname, node_id, objtype
-    }  # type: Dict[str, Union[Symbol, Dict[str, Tuple[str, str, str]]]]
+    }
 
     def clear_doc(self, docname: str) -> None:
         if Symbol.debug_show_tree:
@@ -3801,10 +3801,10 @@ def _resolve_xref_inner(self, env: BuildEnvironment, fromdocname: str, builder:
             logger.warning('Unparseable C cross-reference: %r\n%s', target, e,
                            location=node)
             return None, None
-        parentKey = node.get("c:parent_key", None)  # type: LookupKey
+        parentKey: LookupKey = node.get("c:parent_key", None)
         rootSymbol = self.data['root_symbol']
         if parentKey:
-            parentSymbol = rootSymbol.direct_lookup(parentKey)  # type: Symbol
+            parentSymbol: Symbol = rootSymbol.direct_lookup(parentKey)
             if not parentSymbol:
                 print("Target: ", target)
                 print("ParentKey: ", parentKey)
diff --git a/sphinx/domains/changeset.py b/sphinx/domains/changeset.py
index 23a3375ced5..1b31e0248a2 100644
--- a/sphinx/domains/changeset.py
+++ b/sphinx/domains/changeset.py
@@ -94,7 +94,7 @@ def run(self) -> List[Node]:
         domain = cast(ChangeSetDomain, self.env.get_domain('changeset'))
         domain.note_changeset(node)
 
-        ret = [node]  # type: List[Node]
+        ret: List[Node] = [node]
         ret += messages
         return ret
 
@@ -105,9 +105,9 @@ class ChangeSetDomain(Domain):
     name = 'changeset'
     label = 'changeset'
 
-    initial_data = {
+    initial_data: Dict = {
         'changes': {},      # version -> list of ChangeSet
-    }  # type: Dict
+    }
 
     @property
     def changesets(self) -> Dict[str, List[ChangeSet]]:
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index b9ba1f559ec..abe96179134 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -518,10 +518,10 @@
     '!': 'nt', 'not': 'nt',
     '~': 'co', 'compl': 'co'
 }
-_id_char_from_prefix = {
+_id_char_from_prefix: Dict[Optional[str], str] = {
     None: 'c', 'u8': 'c',
     'u': 'Ds', 'U': 'Di', 'L': 'w'
-}  # type: Dict[Any, str]
+}
 # these are ordered by preceedence
 _expression_bin_ops = [
     ['||', 'or'],
@@ -751,7 +751,7 @@ def describe_signature(self, signode: TextElement, mode: str,
             # prefix. however, only the identifier part should be a link, such
             # that template args can be a link as well.
             # For 'lastIsName' we should also prepend template parameter lists.
-            templateParams = []  # type: List[Any]
+            templateParams: List[Any] = []
             if mode == 'lastIsName':
                 assert symbol is not None
                 if symbol.declaration.templatePrefix is not None:
@@ -2057,7 +2057,7 @@ def mergeWith(self, other: "ASTDeclSpecsSimple") -> "ASTDeclSpecsSimple":
                                   self.attrs + other.attrs)
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        res = []  # type: List[str]
+        res: List[str] = []
         res.extend(transform(attr) for attr in self.attrs)
         if self.storage:
             res.append(self.storage)
@@ -2144,7 +2144,7 @@ def get_id(self, version: int) -> str:
         return ''.join(res)
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        res = []  # type: List[str]
+        res: List[str] = []
         l = transform(self.leftSpecs)
         if len(l) > 0:
             res.append(l)
@@ -3635,9 +3635,9 @@ def __init__(self, objectType: str, directiveType: str, visibility: str,
         self.trailingRequiresClause = trailingRequiresClause
         self.semicolon = semicolon
 
-        self.symbol = None  # type: Symbol
+        self.symbol: Symbol = None
         # set by CPPObject._add_enumerator_to_parent
-        self.enumeratorScopedSymbol = None  # type: Symbol
+        self.enumeratorScopedSymbol: Symbol = None
 
     def clone(self) -> "ASTDeclaration":
         templatePrefixClone = self.templatePrefix.clone() if self.templatePrefix else None
@@ -3857,8 +3857,8 @@ def __init__(self, parent: "Symbol", identOrOp: Union[ASTIdentifier, ASTOperator
                  docname: str, line: int) -> None:
         self.parent = parent
         # declarations in a single directive are linked together
-        self.siblingAbove = None  # type: Symbol
-        self.siblingBelow = None  # type: Symbol
+        self.siblingAbove: Symbol = None
+        self.siblingBelow: Symbol = None
         self.identOrOp = identOrOp
         self.templateParams = templateParams  # template<templateParams>
         self.templateArgs = templateArgs  # identifier<templateArgs>
@@ -3869,8 +3869,8 @@ def __init__(self, parent: "Symbol", identOrOp: Union[ASTIdentifier, ASTOperator
         self._assert_invariants()
 
         # Remember to modify Symbol.remove if modifications to the parent change.
-        self._children = []  # type: List[Symbol]
-        self._anonChildren = []  # type: List[Symbol]
+        self._children: List[Symbol] = []
+        self._anonChildren: List[Symbol] = []
         # note: _children includes _anonChildren
         if self.parent:
             self.parent._children.append(self)
@@ -3940,7 +3940,7 @@ def remove(self) -> None:
         self.parent = None
 
     def clear_doc(self, docname: str) -> None:
-        newChildren = []  # type: List[Symbol]
+        newChildren: List[Symbol] = []
         for sChild in self._children:
             sChild.clear_doc(docname)
             if sChild.declaration and sChild.docname == docname:
@@ -4972,7 +4972,7 @@ def _parse_primary_expression(self) -> ASTExpression:
         # fold-expression
         # id-expression -> we parse this with _parse_nested_name
         self.skip_ws()
-        res = self._parse_literal()  # type: ASTExpression
+        res: ASTExpression = self._parse_literal()
         if res is not None:
             return res
         self.skip_ws()
@@ -5000,7 +5000,7 @@ def _parse_initializer_list(self, name: str, open: str, close: str
         if self.skip_string(close):
             return [], False
 
-        exprs = []  # type: List[Union[ASTExpression, ASTBracedInitList]]
+        exprs: List[Union[ASTExpression, ASTBracedInitList]] = []
         trailingComma = False
         while True:
             self.skip_ws()
@@ -5079,7 +5079,7 @@ def _parse_postfix_expression(self) -> ASTPostfixExpr:
         #  | "typeid" "(" type-id ")"
 
         prefixType = None
-        prefix = None  # type: Any
+        prefix: Any = None
         self.skip_ws()
 
         cast = None
@@ -5162,7 +5162,7 @@ def parser() -> ASTExpression:
                     raise self._make_multi_error(errors, header) from eInner
 
         # and now parse postfixes
-        postFixes = []  # type: List[ASTPostfixOp]
+        postFixes: List[ASTPostfixOp] = []
         while True:
             self.skip_ws()
             if prefixType in ['expr', 'cast', 'typeid']:
@@ -5392,7 +5392,7 @@ def _parse_assignment_expression(self, inTemplate: bool) -> ASTExpression:
         #     logical-or-expression
         #   | logical-or-expression "?" expression ":" assignment-expression
         #   | logical-or-expression assignment-operator initializer-clause
-        exprs = []  # type: List[Union[ASTExpression, ASTBracedInitList]]
+        exprs: List[Union[ASTExpression, ASTBracedInitList]] = []
         ops = []
         orExpr = self._parse_logical_or_expression(inTemplate=inTemplate)
         exprs.append(orExpr)
@@ -5465,7 +5465,7 @@ def _parse_expression_fallback(self, end: List[str],
         else:
             # TODO: add handling of more bracket-like things, and quote handling
             brackets = {'(': ')', '{': '}', '[': ']', '<': '>'}
-            symbols = []  # type: List[str]
+            symbols: List[str] = []
             while not self.eof:
                 if (len(symbols) == 0 and self.current_char in end):
                     break
@@ -5528,7 +5528,7 @@ def _parse_template_argument_list(self) -> ASTTemplateArgs:
         if self.skip_string('>'):
             return ASTTemplateArgs([], False)
         prevErrors = []
-        templateArgs = []  # type: List[Union[ASTType, ASTTemplateArgConstant]]
+        templateArgs: List[Union[ASTType, ASTTemplateArgConstant]] = []
         packExpansion = False
         while 1:
             pos = self.pos
@@ -5580,8 +5580,8 @@ def _parse_template_argument_list(self) -> ASTTemplateArgs:
         return ASTTemplateArgs(templateArgs, packExpansion)
 
     def _parse_nested_name(self, memberPointer: bool = False) -> ASTNestedName:
-        names = []  # type: List[ASTNestedNameElement]
-        templates = []  # type: List[bool]
+        names: List[ASTNestedNameElement] = []
+        templates: List[bool] = []
 
         self.skip_ws()
         rooted = False
@@ -5594,7 +5594,7 @@ def _parse_nested_name(self, memberPointer: bool = False) -> ASTNestedName:
             else:
                 template = False
             templates.append(template)
-            identOrOp = None  # type: Union[ASTIdentifier, ASTOperator]
+            identOrOp: Union[ASTIdentifier, ASTOperator] = None
             if self.skip_word_and_ws('operator'):
                 identOrOp = self._parse_operator()
             else:
@@ -6097,7 +6097,7 @@ def _parse_initializer(self, outer: str = None, allowFallback: bool = True
             return ASTInitializer(bracedInit)
 
         if outer == 'member':
-            fallbackEnd = []  # type: List[str]
+            fallbackEnd: List[str] = []
         elif outer == 'templateParam':
             fallbackEnd = [',', '>']
         elif outer is None:  # function parameter
@@ -6376,7 +6376,7 @@ def _parse_template_paramter(self) -> ASTTemplateParam:
     def _parse_template_parameter_list(self) -> ASTTemplateParams:
         # only: '<' parameter-list '>'
         # we assume that 'template' has just been parsed
-        templateParams = []  # type: List[ASTTemplateParam]
+        templateParams: List[ASTTemplateParam] = []
         self.skip_ws()
         if not self.skip_string("<"):
             self.fail("Expected '<' after 'template'")
@@ -6499,11 +6499,11 @@ def parse_and_expr(self: DefinitionParser) -> ASTExpression:
 
     def _parse_template_declaration_prefix(self, objectType: str
                                            ) -> Optional[ASTTemplateDeclarationPrefix]:
-        templates = []  # type: List[Union[ASTTemplateParams, ASTTemplateIntroduction]]
+        templates: List[Union[ASTTemplateParams, ASTTemplateIntroduction]] = []
         while 1:
             self.skip_ws()
             # the saved position is only used to provide a better error message
-            params = None  # type: Union[ASTTemplateParams, ASTTemplateIntroduction]
+            params: Union[ASTTemplateParams, ASTTemplateIntroduction] = None
             pos = self.pos
             if self.skip_word("template"):
                 try:
@@ -6559,7 +6559,7 @@ def _check_template_consistency(self, nestedName: ASTNestedName,
                 msg += str(nestedName)
                 self.warn(msg)
 
-            newTemplates = []  # type: List[Union[ASTTemplateParams, ASTTemplateIntroduction]]
+            newTemplates: List[Union[ASTTemplateParams, ASTTemplateIntroduction]] = []
             for i in range(numExtra):
                 newTemplates.append(ASTTemplateParams([]))
             if templatePrefix and not isMemberInstantiation:
@@ -6579,7 +6579,7 @@ def parse_declaration(self, objectType: str, directiveType: str) -> ASTDeclarati
         templatePrefix = None
         requiresClause = None
         trailingRequiresClause = None
-        declaration = None  # type: Any
+        declaration: Any = None
 
         self.skip_ws()
         if self.match(_visibility_re):
@@ -6878,7 +6878,7 @@ def run(self) -> List[Node]:
         return super().run()
 
     def handle_signature(self, sig: str, signode: desc_signature) -> ASTDeclaration:
-        parentSymbol = self.env.temp_data['cpp:parent_symbol']  # type: Symbol
+        parentSymbol: Symbol = self.env.temp_data['cpp:parent_symbol']
 
         parser = DefinitionParser(sig, location=signode, config=self.env.config)
         try:
@@ -6925,10 +6925,10 @@ def handle_signature(self, sig: str, signode: desc_signature) -> ASTDeclaration:
         return ast
 
     def before_content(self) -> None:
-        lastSymbol = self.env.temp_data['cpp:last_symbol']  # type: Symbol
+        lastSymbol: Symbol = self.env.temp_data['cpp:last_symbol']
         assert lastSymbol
         self.oldParentSymbol = self.env.temp_data['cpp:parent_symbol']
-        self.oldParentKey = self.env.ref_context['cpp:parent_key']  # type: LookupKey
+        self.oldParentKey: LookupKey = self.env.ref_context['cpp:parent_key']
         self.env.temp_data['cpp:parent_symbol'] = lastSymbol
         self.env.ref_context['cpp:parent_key'] = lastSymbol.get_lookup_key()
 
@@ -6991,7 +6991,7 @@ def run(self) -> List[Node]:
         rootSymbol = self.env.domaindata['cpp']['root_symbol']
         if self.arguments[0].strip() in ('NULL', '0', 'nullptr'):
             symbol = rootSymbol
-            stack = []  # type: List[Symbol]
+            stack: List[Symbol] = []
         else:
             parser = DefinitionParser(self.arguments[0],
                                       location=self.get_source_info(),
@@ -7103,7 +7103,7 @@ def _render_symbol(self, s: Symbol, maxdepth: int, skipThis: bool,
             maxdepth -= 1
             recurse = True
 
-        nodes = []  # type: List[Node]
+        nodes: List[Node] = []
         if not skipThis:
             signode = addnodes.desc_signature('', '')
             nodes.append(signode)
@@ -7111,7 +7111,7 @@ def _render_symbol(self, s: Symbol, maxdepth: int, skipThis: bool,
 
         if recurse:
             if skipThis:
-                childContainer = nodes  # type: Union[List[Node], addnodes.desc]
+                childContainer: Union[List[Node], addnodes.desc] = nodes
             else:
                 content = addnodes.desc_content()
                 desc = addnodes.desc()
@@ -7160,15 +7160,15 @@ def apply(self, **kwargs: Any) -> None:
                 node.replace_self(signode)
                 continue
 
-            rootSymbol = self.env.domains['cpp'].data['root_symbol']  # type: Symbol
-            parentSymbol = rootSymbol.direct_lookup(parentKey)  # type: Symbol
+            rootSymbol: Symbol = self.env.domains['cpp'].data['root_symbol']
+            parentSymbol: Symbol = rootSymbol.direct_lookup(parentKey)
             if not parentSymbol:
                 print("Target: ", sig)
                 print("ParentKey: ", parentKey)
                 print(rootSymbol.dump(1))
             assert parentSymbol  # should be there
 
-            symbols = []  # type: List[Symbol]
+            symbols: List[Symbol] = []
             if isShorthand:
                 assert isinstance(ast, ASTNamespace)
                 ns = ast
@@ -7247,7 +7247,7 @@ def run(self) -> List[Node]:
         # 'desctype' is a backwards compatible attribute
         node['objtype'] = node['desctype'] = self.objtype
 
-        self.names = []  # type: List[str]
+        self.names: List[str] = []
         aliasOptions = {
             'maxdepth': self.options.get('maxdepth', 1),
             'noroot': 'noroot' in self.options,
@@ -7307,7 +7307,7 @@ def __init__(self, asCode: bool) -> None:
         if asCode:
             # render the expression as inline code
             self.class_type = 'cpp-expr'
-            self.node_type = nodes.literal  # type: Type[TextElement]
+            self.node_type: Type[TextElement] = nodes.literal
         else:
             # render the expression as inline text
             self.class_type = 'cpp-texpr'
@@ -7488,10 +7488,10 @@ def findWarning(e: Exception) -> Tuple[str, Exception]:
             logger.warning('Unparseable C++ cross-reference: %r\n%s', t, ex,
                            location=node)
             return None, None
-        parentKey = node.get("cpp:parent_key", None)  # type: LookupKey
+        parentKey: LookupKey = node.get("cpp:parent_key", None)
         rootSymbol = self.data['root_symbol']
         if parentKey:
-            parentSymbol = rootSymbol.direct_lookup(parentKey)  # type: Symbol
+            parentSymbol: Symbol = rootSymbol.direct_lookup(parentKey)
             if not parentSymbol:
                 print("Target: ", target)
                 print("ParentKey: ", parentKey.data)
@@ -7645,7 +7645,7 @@ def get_full_qualified_name(self, node: Element) -> str:
         target = node.get('reftarget', None)
         if target is None:
             return None
-        parentKey = node.get("cpp:parent_key", None)  # type: LookupKey
+        parentKey: LookupKey = node.get("cpp:parent_key", None)
         if parentKey is None or len(parentKey.data) <= 0:
             return None
 
diff --git a/sphinx/domains/javascript.py b/sphinx/domains/javascript.py
index b34cff50984..92d0e1d6183 100644
--- a/sphinx/domains/javascript.py
+++ b/sphinx/domains/javascript.py
@@ -42,7 +42,7 @@ class JSObject(ObjectDescription[Tuple[str, str]]):
     has_arguments = False
 
     #: what is displayed right before the documentation entry
-    display_prefix = None  # type: str
+    display_prefix: str = None
 
     #: If ``allow_nesting`` is ``True``, the object prefixes will be accumulated
     #: based on directive nesting
@@ -262,7 +262,7 @@ def run(self) -> List[Node]:
         mod_name = self.arguments[0].strip()
         self.env.ref_context['js:module'] = mod_name
         noindex = 'noindex' in self.options
-        ret = []  # type: List[Node]
+        ret: List[Node] = []
         if not noindex:
             domain = cast(JavaScriptDomain, self.env.get_domain('js'))
 
@@ -346,10 +346,10 @@ class JavaScriptDomain(Domain):
         'attr':  JSXRefRole(),
         'mod':   JSXRefRole(),
     }
-    initial_data = {
+    initial_data: Dict[str, Dict[str, Tuple[str, str]]] = {
         'objects': {},  # fullname -> docname, node_id, objtype
         'modules': {},  # modname  -> docname, node_id
-    }  # type: Dict[str, Dict[str, Tuple[str, str]]]
+    }
 
     @property
     def objects(self) -> Dict[str, Tuple[str, str, str]]:
diff --git a/sphinx/domains/math.py b/sphinx/domains/math.py
index 70a27e6422e..88db1ad0e7d 100644
--- a/sphinx/domains/math.py
+++ b/sphinx/domains/math.py
@@ -41,10 +41,10 @@ class MathDomain(Domain):
     name = 'math'
     label = 'mathematics'
 
-    initial_data = {
+    initial_data: Dict = {
         'objects': {},  # labelid -> (docname, eqno)
         'has_equations': {},  # docname -> bool
-    }  # type: Dict
+    }
     dangling_warnings = {
         'eq': 'equation not found: %(target)s',
     }
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index ace7cedf4ea..d0c5f7118bd 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -97,8 +97,8 @@ def type_to_xref(text: str, env: BuildEnvironment = None) -> addnodes.pending_xr
         # nested classes.  But python domain can't access the real python object because this
         # module should work not-dynamically.
         shortname = text.split('.')[-1]
-        contnodes = [pending_xref_condition('', shortname, condition='resolved'),
-                     pending_xref_condition('', text, condition='*')]  # type: List[Node]
+        contnodes: List[Node] = [pending_xref_condition('', shortname, condition='resolved'),
+                                 pending_xref_condition('', text, condition='*')]
     else:
         contnodes = [nodes.Text(text)]
 
@@ -112,7 +112,7 @@ def unparse(node: ast.AST) -> List[Node]:
         if isinstance(node, ast.Attribute):
             return [nodes.Text("%s.%s" % (unparse(node.value)[0], node.attr))]
         elif isinstance(node, ast.BinOp):
-            result = unparse(node.left)  # type: List[Node]
+            result: List[Node] = unparse(node.left)
             result.extend(unparse(node.op))
             result.extend(unparse(node.right))
             return result
@@ -239,7 +239,7 @@ def _pseudo_parse_arglist(signode: desc_signature, arglist: str) -> None:
     string literal (e.g. default argument value).
     """
     paramlist = addnodes.desc_parameterlist()
-    stack = [paramlist]  # type: List[Element]
+    stack: List[Element] = [paramlist]
     try:
         for argument in arglist.split(','):
             argument = argument.strip()
@@ -910,7 +910,7 @@ def run(self) -> List[Node]:
         modname = self.arguments[0].strip()
         noindex = 'noindex' in self.options
         self.env.ref_context['py:module'] = modname
-        ret = []  # type: List[Node]
+        ret: List[Node] = []
         if not noindex:
             # note module to the domain
             node_id = make_id(self.env, self.state.document, 'module', modname)
@@ -1021,10 +1021,9 @@ class PythonModuleIndex(Index):
 
     def generate(self, docnames: Iterable[str] = None
                  ) -> Tuple[List[Tuple[str, List[IndexEntry]]], bool]:
-        content = {}  # type: Dict[str, List[IndexEntry]]
+        content: Dict[str, List[IndexEntry]] = {}
         # list of prefixes to ignore
-        ignores = None  # type: List[str]
-        ignores = self.domain.env.config['modindex_common_prefix']  # type: ignore
+        ignores: List[str] = self.domain.env.config['modindex_common_prefix']  # type: ignore
         ignores = sorted(ignores, key=len, reverse=True)
         # list of all modules, sorted by module name
         modules = sorted(self.domain.data['modules'].items(),
@@ -1087,7 +1086,7 @@ class PythonDomain(Domain):
     """Python language domain."""
     name = 'py'
     label = 'Python'
-    object_types = {
+    object_types: Dict[str, ObjType] = {
         'function':     ObjType(_('function'),      'func', 'obj'),
         'data':         ObjType(_('data'),          'data', 'obj'),
         'class':        ObjType(_('class'),         'class', 'exc', 'obj'),
@@ -1098,7 +1097,7 @@ class PythonDomain(Domain):
         'attribute':    ObjType(_('attribute'),     'attr', 'obj'),
         'property':     ObjType(_('property'),      'attr', '_prop', 'obj'),
         'module':       ObjType(_('module'),        'mod', 'obj'),
-    }  # type: Dict[str, ObjType]
+    }
 
     directives = {
         'function':        PyFunction,
@@ -1126,10 +1125,10 @@ class PythonDomain(Domain):
         'mod':   PyXRefRole(),
         'obj':   PyXRefRole(),
     }
-    initial_data = {
+    initial_data: Dict[str, Dict[str, Tuple[Any]]] = {
         'objects': {},  # fullname -> docname, objtype
         'modules': {},  # modname -> docname, synopsis, platform, deprecated
-    }  # type: Dict[str, Dict[str, Tuple[Any]]]
+    }
     indices = [
         PythonModuleIndex,
     ]
@@ -1194,7 +1193,7 @@ def find_obj(self, env: BuildEnvironment, modname: str, classname: str,
         if not name:
             return []
 
-        matches = []  # type: List[Tuple[str, ObjectEntry]]
+        matches: List[Tuple[str, ObjectEntry]] = []
 
         newname = None
         if searchmode == 1:
@@ -1285,7 +1284,7 @@ def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Bui
                          ) -> List[Tuple[str, Element]]:
         modname = node.get('py:module')
         clsname = node.get('py:class')
-        results = []  # type: List[Tuple[str, Element]]
+        results: List[Tuple[str, Element]] = []
 
         # always search in "refspecific" mode with the :any: role
         matches = self.find_obj(env, modname, clsname, target, None, 1)
diff --git a/sphinx/domains/rst.py b/sphinx/domains/rst.py
index 6b4f1c0ff8a..d048c2dfbfb 100644
--- a/sphinx/domains/rst.py
+++ b/sphinx/domains/rst.py
@@ -218,9 +218,9 @@ class ReSTDomain(Domain):
         'dir':  XRefRole(),
         'role': XRefRole(),
     }
-    initial_data = {
+    initial_data: Dict[str, Dict[Tuple[str, str], str]] = {
         'objects': {},  # fullname -> docname, objtype
-    }  # type: Dict[str, Dict[Tuple[str, str], str]]
+    }
 
     @property
     def objects(self) -> Dict[Tuple[str, str], Tuple[str, str]]:
@@ -259,7 +259,7 @@ def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder
     def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
                          target: str, node: pending_xref, contnode: Element
                          ) -> List[Tuple[str, Element]]:
-        results = []  # type: List[Tuple[str, Element]]
+        results: List[Tuple[str, Element]] = []
         for objtype in self.object_types:
             todocname, node_id = self.objects.get((objtype, target), (None, None))
             if todocname:
diff --git a/sphinx/domains/std.py b/sphinx/domains/std.py
index 274c29c87a3..a21461dc3d8 100644
--- a/sphinx/domains/std.py
+++ b/sphinx/domains/std.py
@@ -50,8 +50,8 @@ class GenericObject(ObjectDescription[str]):
     """
     A generic x-ref directive registered with Sphinx.add_object_type().
     """
-    indextemplate = ''
-    parse_node = None  # type: Callable[[GenericObject, BuildEnvironment, str, desc_signature], str]  # NOQA
+    indextemplate: str = ''
+    parse_node: Callable[["GenericObject", "BuildEnvironment", str, desc_signature], str] = None  # NOQA
 
     def handle_signature(self, sig: str, signode: desc_signature) -> str:
         if self.parse_node:
@@ -148,7 +148,7 @@ def run(self) -> List[Node]:
             node['ids'].append(old_node_id)
 
         self.state.document.note_explicit_target(node)
-        ret = [node]  # type: List[Node]
+        ret: List[Node] = [node]
         if self.indextemplate:
             indexentry = self.indextemplate % (fullname,)
             indextype = 'single'
@@ -343,11 +343,11 @@ def run(self) -> List[Node]:
         # be* a definition list.
 
         # first, collect single entries
-        entries = []  # type: List[Tuple[List[Tuple[str, str, int]], StringList]]
+        entries: List[Tuple[List[Tuple[str, str, int]], StringList]] = []
         in_definition = True
         in_comment = False
         was_empty = True
-        messages = []  # type: List[Node]
+        messages: List[Node] = []
         for line, (source, lineno) in zip(self.content, self.content.items):
             # empty line -> add to last definition
             if not line:
@@ -402,9 +402,9 @@ def run(self) -> List[Node]:
         # now, parse all the entries into a big definition list
         items = []
         for terms, definition in entries:
-            termtexts = []          # type: List[str]
-            termnodes = []          # type: List[Node]
-            system_messages = []    # type: List[Node]
+            termtexts: List[str] = []
+            termnodes: List[Node] = []
+            system_messages: List[Node] = []
             for line, source, lineno in terms:
                 parts = split_term_classifiers(line)
                 # parse the term with inline markup
@@ -443,7 +443,7 @@ def run(self) -> List[Node]:
 def token_xrefs(text: str, productionGroup: str = '') -> List[Node]:
     if len(productionGroup) != 0:
         productionGroup += ':'
-    retnodes = []  # type: List[Node]
+    retnodes: List[Node] = []
     pos = 0
     for m in token_re.finditer(text):
         if m.start() > pos:
@@ -486,7 +486,7 @@ class ProductionList(SphinxDirective):
 
     def run(self) -> List[Node]:
         domain = cast(StandardDomain, self.env.get_domain('std'))
-        node = addnodes.productionlist()  # type: Element
+        node: Element = addnodes.productionlist()
         self.set_source_info(node)
         # The backslash handling is from ObjectDescription.get_signatures
         nl_escape_re = re.compile(r'\\\n')
@@ -559,7 +559,7 @@ class StandardDomain(Domain):
     name = 'std'
     label = 'Default'
 
-    object_types = {
+    object_types: Dict[str, ObjType] = {
         'term': ObjType(_('glossary term'), 'term', searchprio=-1),
         'token': ObjType(_('grammar token'), 'token', searchprio=-1),
         'label': ObjType(_('reference label'), 'ref', 'keyword',
@@ -567,17 +567,17 @@ class StandardDomain(Domain):
         'envvar': ObjType(_('environment variable'), 'envvar'),
         'cmdoption': ObjType(_('program option'), 'option'),
         'doc': ObjType(_('document'), 'doc', searchprio=-1)
-    }  # type: Dict[str, ObjType]
+    }
 
-    directives = {
+    directives: Dict[str, Type[Directive]] = {
         'program': Program,
         'cmdoption': Cmdoption,  # old name for backwards compatibility
         'option': Cmdoption,
         'envvar': EnvVar,
         'glossary': Glossary,
         'productionlist': ProductionList,
-    }  # type: Dict[str, Type[Directive]]
-    roles = {
+    }
+    roles: Dict[str, Union[RoleFunction, XRefRole]] = {
         'option':  OptionXRefRole(warn_dangling=True),
         'envvar':  EnvVarXRefRole(),
         # links to tokens in grammar productions
@@ -595,7 +595,7 @@ class StandardDomain(Domain):
         'keyword': XRefRole(warn_dangling=True),
         # links to documents
         'doc':     XRefRole(warn_dangling=True, innernodeclass=nodes.inline),
-    }  # type: Dict[str, Union[RoleFunction, XRefRole]]
+    }
 
     initial_data = {
         'progoptions': {},      # (program, name) -> docname, labelid
@@ -620,11 +620,12 @@ class StandardDomain(Domain):
         'option': 'unknown option: %(target)s',
     }
 
-    enumerable_nodes = {  # node_class -> (figtype, title_getter)
+    # node_class -> (figtype, title_getter)
+    enumerable_nodes: Dict[Type[Node], Tuple[str, Callable]] = {
         nodes.figure: ('figure', None),
         nodes.table: ('table', None),
         nodes.container: ('code-block', None),
-    }  # type: Dict[Type[Node], Tuple[str, Callable]]
+    }
 
     def __init__(self, env: "BuildEnvironment") -> None:
         super().__init__(env)
@@ -706,7 +707,7 @@ def anonlabels(self) -> Dict[str, Tuple[str, str]]:
         return self.data.setdefault('anonlabels', {})  # labelname -> docname, labelid
 
     def clear_doc(self, docname: str) -> None:
-        key = None  # type: Any
+        key: Any = None
         for key, (fn, _l) in list(self.progoptions.items()):
             if fn == docname:
                 del self.progoptions[key]
@@ -992,7 +993,7 @@ def _resolve_obj_xref(self, env: "BuildEnvironment", fromdocname: str,
     def resolve_any_xref(self, env: "BuildEnvironment", fromdocname: str,
                          builder: "Builder", target: str, node: pending_xref,
                          contnode: Element) -> List[Tuple[str, Element]]:
-        results = []  # type: List[Tuple[str, Element]]
+        results: List[Tuple[str, Element]] = []
         ltarget = target.lower()  # :ref: lowercases its target automatically
         for role in ('ref', 'option'):  # do not try "keyword"
             res = self.resolve_xref(env, fromdocname, builder, role,

From 555a52be82be3578470179f9047ed6abb943057e Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 23 Mar 2021 01:44:24 +0900
Subject: [PATCH 209/305] refactor: Use PEP-526 based variable annotation
 (sphinx.directives)

---
 sphinx/directives/__init__.py | 12 ++++++------
 sphinx/directives/code.py     |  4 ++--
 sphinx/directives/other.py    | 12 ++++++------
 sphinx/directives/patches.py  |  2 +-
 4 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/sphinx/directives/__init__.py b/sphinx/directives/__init__.py
index f4014480993..e1ccc8be7a5 100644
--- a/sphinx/directives/__init__.py
+++ b/sphinx/directives/__init__.py
@@ -63,13 +63,13 @@ class ObjectDescription(SphinxDirective, Generic[T]):
     }
 
     # types of doc fields that this directive handles, see sphinx.util.docfields
-    doc_field_types = []    # type: List[Field]
-    domain = None           # type: str
-    objtype = None          # type: str
-    indexnode = None        # type: addnodes.index
+    doc_field_types: List[Field] = []
+    domain: str = None
+    objtype: str = None
+    indexnode: addnodes.index = None
 
     # Warning: this might be removed in future version. Don't touch this from extensions.
-    _doc_field_type_map = {}  # type: Dict[str, Tuple[Field, bool]]
+    _doc_field_type_map: Dict[str, Tuple[Field, bool]] = {}
 
     def get_field_type_map(self) -> Dict[str, Tuple[Field, bool]]:
         if self._doc_field_type_map == {}:
@@ -173,7 +173,7 @@ def run(self) -> List[Node]:
         if self.domain:
             node['classes'].append(self.domain)
 
-        self.names = []  # type: List[T]
+        self.names: List[T] = []
         signatures = self.get_signatures()
         for i, sig in enumerate(signatures):
             # add a signature node for each signature in the current unit
diff --git a/sphinx/directives/code.py b/sphinx/directives/code.py
index 04b81cef576..12ab51c5880 100644
--- a/sphinx/directives/code.py
+++ b/sphinx/directives/code.py
@@ -142,7 +142,7 @@ def run(self) -> List[Node]:
             lines = dedent_lines(lines, self.options['dedent'], location=location)
             code = '\n'.join(lines)
 
-        literal = nodes.literal_block(code, code)  # type: Element
+        literal: Element = nodes.literal_block(code, code)
         if 'linenos' in self.options or 'lineno-start' in self.options:
             literal['linenos'] = True
         literal['classes'] += self.options.get('class', [])
@@ -422,7 +422,7 @@ def run(self) -> List[Node]:
             reader = LiteralIncludeReader(filename, self.options, self.config)
             text, lines = reader.read(location=location)
 
-            retnode = nodes.literal_block(text, text, source=filename)  # type: Element
+            retnode: Element = nodes.literal_block(text, text, source=filename)
             retnode['force'] = 'force' in self.options
             self.set_source_info(retnode)
             if self.options.get('diff'):  # if diff is set, set udiff
diff --git a/sphinx/directives/other.py b/sphinx/directives/other.py
index 1daa3c4a5a2..e131fe82053 100644
--- a/sphinx/directives/other.py
+++ b/sphinx/directives/other.py
@@ -90,7 +90,7 @@ def parse_content(self, toctree: addnodes.toctree) -> List[Node]:
         all_docnames = self.env.found_docs.copy()
         all_docnames.remove(self.env.docname)  # remove current document
 
-        ret = []  # type: List[Node]
+        ret: List[Node] = []
         excluded = Matcher(self.config.exclude_patterns)
         for entry in self.content:
             if not entry:
@@ -168,7 +168,7 @@ class Author(SphinxDirective):
     def run(self) -> List[Node]:
         if not self.config.show_authors:
             return []
-        para = nodes.paragraph(translatable=False)  # type: Element
+        para: Element = nodes.paragraph(translatable=False)
         emph = nodes.emphasis()
         para += emph
         if self.name == 'sectionauthor':
@@ -183,7 +183,7 @@ def run(self) -> List[Node]:
         inodes, messages = self.state.inline_text(self.arguments[0], self.lineno)
         emph.extend(inodes)
 
-        ret = [para]  # type: List[Node]
+        ret: List[Node] = [para]
         ret += messages
         return ret
 
@@ -225,11 +225,11 @@ class Centered(SphinxDirective):
     def run(self) -> List[Node]:
         if not self.arguments:
             return []
-        subnode = addnodes.centered()  # type: Element
+        subnode: Element = addnodes.centered()
         inodes, messages = self.state.inline_text(self.arguments[0], self.lineno)
         subnode.extend(inodes)
 
-        ret = [subnode]  # type: List[Node]
+        ret: List[Node] = [subnode]
         ret += messages
         return ret
 
@@ -309,7 +309,7 @@ def run(self) -> List[Node]:
 
         # Same as util.nested_parse_with_titles but try to handle nested
         # sections which should be raised higher up the doctree.
-        memo = self.state.memo  # type: Any
+        memo: Any = self.state.memo
         surrounding_title_styles = memo.title_styles
         surrounding_section_level = memo.section_level
         memo.title_styles = []
diff --git a/sphinx/directives/patches.py b/sphinx/directives/patches.py
index b4c9784747d..9a3034daea5 100644
--- a/sphinx/directives/patches.py
+++ b/sphinx/directives/patches.py
@@ -206,7 +206,7 @@ def run(self) -> List[Node]:
         self.add_name(node)
         self.set_source_info(node)
 
-        ret = [node]  # type: List[Node]
+        ret: List[Node] = [node]
         self.add_target(ret)
         return ret
 

From 7e6ea15b68960d809d742c18e0e9baa63a7d0d4c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 23 Mar 2021 01:45:04 +0900
Subject: [PATCH 210/305] refactor: Use PEP-526 based variable annotation
 (sphinx.transforms)

---
 sphinx/transforms/__init__.py                 |  6 ++---
 sphinx/transforms/compact_bullet_list.py      |  2 +-
 sphinx/transforms/i18n.py                     | 22 +++++++++----------
 sphinx/transforms/post_transforms/__init__.py |  8 +++----
 sphinx/transforms/post_transforms/code.py     |  2 +-
 sphinx/transforms/post_transforms/images.py   |  6 ++---
 6 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/sphinx/transforms/__init__.py b/sphinx/transforms/__init__.py
index 7788c8436d7..213742636f8 100644
--- a/sphinx/transforms/__init__.py
+++ b/sphinx/transforms/__init__.py
@@ -72,8 +72,8 @@ class SphinxTransformer(Transformer):
     A transformer for Sphinx.
     """
 
-    document = None  # type: nodes.document
-    env = None  # type: BuildEnvironment
+    document: nodes.document = None
+    env: "BuildEnvironment" = None
 
     def set_environment(self, env: "BuildEnvironment") -> None:
         self.env = env
@@ -170,7 +170,7 @@ class AutoNumbering(SphinxTransform):
     default_priority = 210
 
     def apply(self, **kwargs: Any) -> None:
-        domain = self.env.get_domain('std')  # type: StandardDomain
+        domain: StandardDomain = self.env.get_domain('std')
 
         for node in self.document.traverse(nodes.Element):
             if (domain.is_enumerable_node(node) and
diff --git a/sphinx/transforms/compact_bullet_list.py b/sphinx/transforms/compact_bullet_list.py
index 18042358e3b..e7f040a18a9 100644
--- a/sphinx/transforms/compact_bullet_list.py
+++ b/sphinx/transforms/compact_bullet_list.py
@@ -32,7 +32,7 @@ def visit_bullet_list(self, node: nodes.bullet_list) -> None:
         pass
 
     def visit_list_item(self, node: nodes.list_item) -> None:
-        children = []  # type: List[Node]
+        children: List[Node] = []
         for child in node.children:
             if not isinstance(child, nodes.Invisible):
                 children.append(child)
diff --git a/sphinx/transforms/i18n.py b/sphinx/transforms/i18n.py
index 8ac9cc4a873..8f6d37d8dbb 100644
--- a/sphinx/transforms/i18n.py
+++ b/sphinx/transforms/i18n.py
@@ -275,10 +275,10 @@ def apply(self, **kwargs: Any) -> None:
                 patch = patch.next_node()
 
             # ignore unexpected markups in translation message
-            unexpected = (
+            unexpected: Tuple[Type[Element], ...] = (
                 nodes.paragraph,    # expected form of translation
                 nodes.title         # generated by above "Subelements phase2"
-            )  # type: Tuple[Type[Element], ...]
+            )
 
             # following types are expected if
             # config.gettext_additional_targets is configured
@@ -296,8 +296,8 @@ def list_replace_or_append(lst: List[N], old: N, new: N) -> None:
                     lst.append(new)
 
             is_autofootnote_ref = NodeMatcher(nodes.footnote_reference, auto=Any)
-            old_foot_refs = node.traverse(is_autofootnote_ref)  # type: List[nodes.footnote_reference]  # NOQA
-            new_foot_refs = patch.traverse(is_autofootnote_ref)  # type: List[nodes.footnote_reference]  # NOQA
+            old_foot_refs: List[nodes.footnote_reference] = node.traverse(is_autofootnote_ref)
+            new_foot_refs: List[nodes.footnote_reference] = patch.traverse(is_autofootnote_ref)
             if len(old_foot_refs) != len(new_foot_refs):
                 old_foot_ref_rawsources = [ref.rawsource for ref in old_foot_refs]
                 new_foot_ref_rawsources = [ref.rawsource for ref in new_foot_refs]
@@ -305,7 +305,7 @@ def list_replace_or_append(lst: List[N], old: N, new: N) -> None:
                                   ' original: {0}, translated: {1}')
                                .format(old_foot_ref_rawsources, new_foot_ref_rawsources),
                                location=node)
-            old_foot_namerefs = {}  # type: Dict[str, List[nodes.footnote_reference]]
+            old_foot_namerefs: Dict[str, List[nodes.footnote_reference]] = {}
             for r in old_foot_refs:
                 old_foot_namerefs.setdefault(r.get('refname'), []).append(r)
             for newf in new_foot_refs:
@@ -339,8 +339,8 @@ def list_replace_or_append(lst: List[N], old: N, new: N) -> None:
             # * use translated refname for section refname.
             # * inline reference "`Python <...>`_" has no 'refname'.
             is_refnamed_ref = NodeMatcher(nodes.reference, refname=Any)
-            old_refs = node.traverse(is_refnamed_ref)  # type: List[nodes.reference]
-            new_refs = patch.traverse(is_refnamed_ref)  # type: List[nodes.reference]
+            old_refs: List[nodes.reference] = node.traverse(is_refnamed_ref)
+            new_refs: List[nodes.reference] = patch.traverse(is_refnamed_ref)
             if len(old_refs) != len(new_refs):
                 old_ref_rawsources = [ref.rawsource for ref in old_refs]
                 new_ref_rawsources = [ref.rawsource for ref in new_refs]
@@ -368,7 +368,7 @@ def list_replace_or_append(lst: List[N], old: N, new: N) -> None:
             is_refnamed_footnote_ref = NodeMatcher(nodes.footnote_reference, refname=Any)
             old_foot_refs = node.traverse(is_refnamed_footnote_ref)
             new_foot_refs = patch.traverse(is_refnamed_footnote_ref)
-            refname_ids_map = {}  # type: Dict[str, List[str]]
+            refname_ids_map: Dict[str, List[str]] = {}
             if len(old_foot_refs) != len(new_foot_refs):
                 old_foot_ref_rawsources = [ref.rawsource for ref in old_foot_refs]
                 new_foot_ref_rawsources = [ref.rawsource for ref in new_foot_refs]
@@ -385,8 +385,8 @@ def list_replace_or_append(lst: List[N], old: N, new: N) -> None:
 
             # citation should use original 'ids'.
             is_citation_ref = NodeMatcher(nodes.citation_reference, refname=Any)
-            old_cite_refs = node.traverse(is_citation_ref)  # type: List[nodes.citation_reference]  # NOQA
-            new_cite_refs = patch.traverse(is_citation_ref)  # type: List[nodes.citation_reference]  # NOQA
+            old_cite_refs: List[nodes.citation_reference] = node.traverse(is_citation_ref)
+            new_cite_refs: List[nodes.citation_reference] = patch.traverse(is_citation_ref)
             refname_ids_map = {}
             if len(old_cite_refs) != len(new_cite_refs):
                 old_cite_ref_rawsources = [ref.rawsource for ref in old_cite_refs]
@@ -456,7 +456,7 @@ def get_ref_key(node: addnodes.pending_xref) -> Tuple[str, str, str]:
         if 'index' in self.config.gettext_additional_targets:
             # Extract and translate messages for index entries.
             for node, entries in traverse_translatable_index(self.document):
-                new_entries = []   # type: List[Tuple[str, str, str, str, str]]
+                new_entries: List[Tuple[str, str, str, str, str]] = []
                 for type, msg, tid, main, key_ in entries:
                     msg_parts = split_index_msg(type, msg)
                     msgstr_parts = []
diff --git a/sphinx/transforms/post_transforms/__init__.py b/sphinx/transforms/post_transforms/__init__.py
index b10c25b3e58..653097cd887 100644
--- a/sphinx/transforms/post_transforms/__init__.py
+++ b/sphinx/transforms/post_transforms/__init__.py
@@ -38,8 +38,8 @@ class SphinxPostTransform(SphinxTransform):
     They do resolving references, convert images, special transformation for each output
     formats and so on.  This class helps to implement these post transforms.
     """
-    builders = ()   # type: Tuple[str, ...]
-    formats = ()    # type: Tuple[str, ...]
+    builders: Tuple[str, ...] = ()
+    formats: Tuple[str, ...] = ()
 
     def apply(self, **kwargs: Any) -> None:
         if self.is_supported():
@@ -104,7 +104,7 @@ def run(self, **kwargs: Any) -> None:
                 newnode = None
 
             if newnode:
-                newnodes = [newnode]  # type: List[Node]
+                newnodes: List[Node] = [newnode]
             else:
                 newnodes = [contnode]
                 if newnode is None and isinstance(node[0], addnodes.pending_xref_condition):
@@ -121,7 +121,7 @@ def resolve_anyref(self, refdoc: str, node: pending_xref, contnode: Element) ->
         """Resolve reference generated by the "any" role."""
         stddomain = self.env.get_domain('std')
         target = node['reftarget']
-        results = []  # type: List[Tuple[str, Element]]
+        results: List[Tuple[str, Element]] = []
         # first, try resolving as :doc:
         doc_ref = stddomain.resolve_xref(self.env, refdoc, self.app.builder,
                                          'doc', target, node, contnode)
diff --git a/sphinx/transforms/post_transforms/code.py b/sphinx/transforms/post_transforms/code.py
index a880c4cd4be..52bca8e12dd 100644
--- a/sphinx/transforms/post_transforms/code.py
+++ b/sphinx/transforms/post_transforms/code.py
@@ -49,7 +49,7 @@ def apply(self, **kwargs: Any) -> None:
 class HighlightLanguageVisitor(nodes.NodeVisitor):
     def __init__(self, document: nodes.document, default_language: str) -> None:
         self.default_setting = HighlightSetting(default_language, False, sys.maxsize)
-        self.settings = []  # type: List[HighlightSetting]
+        self.settings: List[HighlightSetting] = []
         super().__init__(document)
 
     def unknown_visit(self, node: Node) -> None:
diff --git a/sphinx/transforms/post_transforms/images.py b/sphinx/transforms/post_transforms/images.py
index 2603e0458df..f9b78837f16 100644
--- a/sphinx/transforms/post_transforms/images.py
+++ b/sphinx/transforms/post_transforms/images.py
@@ -75,7 +75,7 @@ def handle(self, node: nodes.image) -> None:
 
             headers = {}
             if os.path.exists(path):
-                timestamp = ceil(os.stat(path).st_mtime)  # type: float
+                timestamp: float = ceil(os.stat(path).st_mtime)
                 headers['If-Modified-Since'] = epoch_to_rfc1123(timestamp)
 
             r = requests.get(node['uri'], headers=headers)
@@ -178,7 +178,7 @@ class ImageConverter(BaseImageConverter):
     #:
     #: .. todo:: This should be refactored not to store the state without class
     #:           variable.
-    available = None  # type: Optional[bool]
+    available: Optional[bool] = None
 
     #: A conversion rules the image converter supports.
     #: It is represented as a list of pair of source image format (mimetype) and
@@ -189,7 +189,7 @@ class ImageConverter(BaseImageConverter):
     #:         ('image/gif', 'image/png'),
     #:         ('application/pdf', 'image/png'),
     #:     ]
-    conversion_rules = []  # type: List[Tuple[str, str]]
+    conversion_rules: List[Tuple[str, str]] = []
 
     def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)

From 000ae2e5000da9b9593560270398d8662f1e496d Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 25 Mar 2021 00:09:21 +0900
Subject: [PATCH 211/305] refactor: Use PEP-526 based variable annotation
 (sphinx.environment)

---
 sphinx/environment/__init__.py              | 129 ++++++++++----------
 sphinx/environment/adapters/indexentries.py |   4 +-
 sphinx/environment/adapters/toctree.py      |   8 +-
 sphinx/environment/collectors/__init__.py   |   2 +-
 sphinx/environment/collectors/asset.py      |   4 +-
 sphinx/environment/collectors/toctree.py    |  14 +--
 6 files changed, 79 insertions(+), 82 deletions(-)

diff --git a/sphinx/environment/__init__.py b/sphinx/environment/__init__.py
index 96b060cd6ec..0483dcdf9fa 100644
--- a/sphinx/environment/__init__.py
+++ b/sphinx/environment/__init__.py
@@ -42,7 +42,7 @@
 
 logger = logging.getLogger(__name__)
 
-default_settings = {
+default_settings: Dict[str, Any] = {
     'embed_stylesheet': False,
     'cloak_email_addresses': True,
     'pep_base_url': 'https://www.python.org/dev/peps/',
@@ -55,7 +55,7 @@
     'halt_level': 5,
     'file_insertion_enabled': True,
     'smartquotes_locales': [],
-}  # type: Dict[str, Any]
+}
 
 # This is increased every time an environment attribute is added
 # or changed to properly invalidate pickle files.
@@ -74,10 +74,10 @@
 }
 
 
-versioning_conditions = {
+versioning_conditions: Dict[str, Union[bool, Callable]] = {
     'none': False,
     'text': is_translatable,
-}  # type: Dict[str, Union[bool, Callable]]
+}
 
 
 class BuildEnvironment:
@@ -87,24 +87,24 @@ class BuildEnvironment:
     transformations to resolve links to them.
     """
 
-    domains = None  # type: Dict[str, Domain]
+    domains: Dict[str, Domain] = None
 
     # --------- ENVIRONMENT INITIALIZATION -------------------------------------
 
     def __init__(self, app: "Sphinx" = None):
-        self.app = None                  # type: Sphinx
-        self.doctreedir = None           # type: str
-        self.srcdir = None               # type: str
-        self.config = None               # type: Config
-        self.config_status = None        # type: int
-        self.config_status_extra = None  # type: str
-        self.events = None               # type: EventManager
-        self.project = None              # type: Project
-        self.version = None              # type: Dict[str, str]
+        self.app: Sphinx = None
+        self.doctreedir: str = None
+        self.srcdir: str = None
+        self.config: Config = None
+        self.config_status: int = None
+        self.config_status_extra: str = None
+        self.events: EventManager = None
+        self.project: Project = None
+        self.version: Dict[str, str] = None
 
         # the method of doctree versioning; see set_versioning_method
-        self.versioning_condition = None  # type: Union[bool, Callable]
-        self.versioning_compare = None  # type: bool
+        self.versioning_condition: Union[bool, Callable] = None
+        self.versioning_compare: bool = None
 
         # all the registered domains, set by the application
         self.domains = {}
@@ -116,70 +116,67 @@ def __init__(self, app: "Sphinx" = None):
         # All "docnames" here are /-separated and relative and exclude
         # the source suffix.
 
-        self.all_docs = {}          # type: Dict[str, float]
-                                    # docname -> mtime at the time of reading
-                                    # contains all read docnames
-        self.dependencies = defaultdict(set)    # type: Dict[str, Set[str]]
-                                    # docname -> set of dependent file
-                                    # names, relative to documentation root
-        self.included = defaultdict(set)        # type: Dict[str, Set[str]]
-                                    # docname -> set of included file
-                                    # docnames included from other documents
-        self.reread_always = set()  # type: Set[str]
-                                    # docnames to re-read unconditionally on
-                                    # next build
+        # docname -> mtime at the time of reading
+        # contains all read docnames
+        self.all_docs: Dict[str, float] = {}
+        # docname -> set of dependent file
+        # names, relative to documentation root
+        self.dependencies: Dict[str, Set[str]] = defaultdict(set)
+        # docname -> set of included file
+        # docnames included from other documents
+        self.included: Dict[str, Set[str]] = defaultdict(set)
+        # docnames to re-read unconditionally on next build
+        self.reread_always: Set[str] = set()
 
         # File metadata
-        self.metadata = defaultdict(dict)       # type: Dict[str, Dict[str, Any]]
-                                                # docname -> dict of metadata items
+        # docname -> dict of metadata items
+        self.metadata: Dict[str, Dict[str, Any]] = defaultdict(dict)
 
         # TOC inventory
-        self.titles = {}            # type: Dict[str, nodes.title]
-                                    # docname -> title node
-        self.longtitles = {}        # type: Dict[str, nodes.title]
-                                    # docname -> title node; only different if
-                                    # set differently with title directive
-        self.tocs = {}              # type: Dict[str, nodes.bullet_list]
-                                    # docname -> table of contents nodetree
-        self.toc_num_entries = {}   # type: Dict[str, int]
-                                    # docname -> number of real entries
+        # docname -> title node
+        self.titles: Dict[str, nodes.title] = {}
+        # docname -> title node; only different if
+        # set differently with title directive
+        self.longtitles: Dict[str, nodes.title] = {}
+        # docname -> table of contents nodetree
+        self.tocs: Dict[str, nodes.bullet_list] = {}
+        # docname -> number of real entries
+        self.toc_num_entries: Dict[str, int] = {}
 
         # used to determine when to show the TOC
         # in a sidebar (don't show if it's only one item)
-        self.toc_secnumbers = {}    # type: Dict[str, Dict[str, Tuple[int, ...]]]
-                                    # docname -> dict of sectionid -> number
-        self.toc_fignumbers = {}    # type: Dict[str, Dict[str, Dict[str, Tuple[int, ...]]]]
-                                    # docname -> dict of figtype ->
-                                    # dict of figureid -> number
-
-        self.toctree_includes = {}  # type: Dict[str, List[str]]
-                                    # docname -> list of toctree includefiles
-        self.files_to_rebuild = {}  # type: Dict[str, Set[str]]
-                                    # docname -> set of files
-                                    # (containing its TOCs) to rebuild too
-        self.glob_toctrees = set()  # type: Set[str]
-                                    # docnames that have :glob: toctrees
-        self.numbered_toctrees = set()  # type: Set[str]
-                                        # docnames that have :numbered: toctrees
+        # docname -> dict of sectionid -> number
+        self.toc_secnumbers: Dict[str, Dict[str, Tuple[int, ...]]] = {}
+        # docname -> dict of figtype -> dict of figureid -> number
+        self.toc_fignumbers: Dict[str, Dict[str, Dict[str, Tuple[int, ...]]]] = {}
+
+        # docname -> list of toctree includefiles
+        self.toctree_includes: Dict[str, List[str]] = {}
+        # docname -> set of files (containing its TOCs) to rebuild too
+        self.files_to_rebuild: Dict[str, Set[str]] = {}
+        # docnames that have :glob: toctrees
+        self.glob_toctrees: Set[str] = set()
+        # docnames that have :numbered: toctrees
+        self.numbered_toctrees: Set[str] = set()
 
         # domain-specific inventories, here to be pickled
-        self.domaindata = {}        # type: Dict[str, Dict]
-                                    # domainname -> domain-specific dict
+        # domainname -> domain-specific dict
+        self.domaindata: Dict[str, Dict] = {}
 
         # these map absolute path -> (docnames, unique filename)
-        self.images = FilenameUniqDict()    # type: FilenameUniqDict
-        self.dlfiles = DownloadFiles()      # type: DownloadFiles
-                                            # filename -> (set of docnames, destination)
+        self.images: FilenameUniqDict = FilenameUniqDict()
+        # filename -> (set of docnames, destination)
+        self.dlfiles: DownloadFiles = DownloadFiles()
 
         # the original URI for images
-        self.original_image_uri = {}  # type: Dict[str, str]
+        self.original_image_uri: Dict[str, str] = {}
 
         # temporary data storage while reading a document
-        self.temp_data = {}         # type: Dict[str, Any]
+        self.temp_data: Dict[str, Any] = {}
         # context for cross-references (e.g. current module or class)
         # this is similar to temp_data, but will for example be copied to
         # attributes of "any" cross references
-        self.ref_context = {}       # type: Dict[str, Any]
+        self.ref_context: Dict[str, Any] = {}
 
         # set up environment
         if app:
@@ -269,7 +266,7 @@ def set_versioning_method(self, method: Union[str, Callable], compare: bool) ->
         raise an exception if the user tries to use an environment with an
         incompatible versioning method.
         """
-        condition = None  # type: Union[bool, Callable]
+        condition: Union[bool, Callable] = None
         if callable(method):
             condition = method
         else:
@@ -385,8 +382,8 @@ def get_outdated_files(self, config_changed: bool) -> Tuple[Set[str], Set[str],
         # clear all files no longer present
         removed = set(self.all_docs) - self.found_docs
 
-        added = set()  # type: Set[str]
-        changed = set()  # type: Set[str]
+        added: Set[str] = set()
+        changed: Set[str] = set()
 
         if config_changed:
             # config values affect e.g. substitutions
@@ -438,7 +435,7 @@ def get_outdated_files(self, config_changed: bool) -> Tuple[Set[str], Set[str],
         return added, changed, removed
 
     def check_dependents(self, app: "Sphinx", already: Set[str]) -> Generator[str, None, None]:
-        to_rewrite = []  # type: List[str]
+        to_rewrite: List[str] = []
         for docnames in self.events.emit('env-get-updated', self):
             to_rewrite.extend(docnames)
         for docname in set(to_rewrite):
diff --git a/sphinx/environment/adapters/indexentries.py b/sphinx/environment/adapters/indexentries.py
index e662bfe4a5e..5b751014307 100644
--- a/sphinx/environment/adapters/indexentries.py
+++ b/sphinx/environment/adapters/indexentries.py
@@ -31,7 +31,7 @@ def create_index(self, builder: Builder, group_entries: bool = True,
                      _fixre: Pattern = re.compile(r'(.*) ([(][^()]*[)])')
                      ) -> List[Tuple[str, List[Tuple[str, Any]]]]:
         """Create the real index from the collected index entries."""
-        new = {}  # type: Dict[str, List]
+        new: Dict[str, List] = {}
 
         def add_entry(word: str, subword: str, main: str, link: bool = True,
                       dic: Dict = new, key: str = None) -> None:
@@ -126,7 +126,7 @@ def keyfunc(entry: Tuple[str, List]) -> Tuple[Tuple[int, str], str]:
             #     (in module foo)
             #     (in module bar)
             oldkey = ''
-            oldsubitems = None  # type: Dict[str, List]
+            oldsubitems: Dict[str, List] = None
             i = 0
             while i < len(newlist):
                 key, (targets, subitems, _key) = newlist[i]
diff --git a/sphinx/environment/adapters/toctree.py b/sphinx/environment/adapters/toctree.py
index d12055b8438..2214bf51918 100644
--- a/sphinx/environment/adapters/toctree.py
+++ b/sphinx/environment/adapters/toctree.py
@@ -102,7 +102,7 @@ def _toctree_add_classes(node: Element, depth: int) -> None:
                         if not subnode['anchorname']:
                             # give the whole branch a 'current' class
                             # (useful for styling it differently)
-                            branchnode = subnode  # type: Element
+                            branchnode: Element = subnode
                             while branchnode:
                                 branchnode['classes'].append('current')
                                 branchnode = branchnode.parent
@@ -119,7 +119,7 @@ def _entries_from_toctree(toctreenode: addnodes.toctree, parents: List[str],
                                   ) -> List[Element]:
             """Return TOC entries for a toctree node."""
             refs = [(e[0], e[1]) for e in toctreenode['entries']]
-            entries = []  # type: List[Element]
+            entries: List[Element] = []
             for (title, ref) in refs:
                 try:
                     refdoc = None
@@ -268,7 +268,7 @@ def get_toctree_ancestors(self, docname: str) -> List[str]:
         for p, children in self.env.toctree_includes.items():
             for child in children:
                 parent[child] = p
-        ancestors = []  # type: List[str]
+        ancestors: List[str] = []
         d = docname
         while d in parent and d not in ancestors:
             ancestors.append(d)
@@ -316,7 +316,7 @@ def get_toctree_for(self, docname: str, builder: "Builder", collapse: bool,
                         **kwargs: Any) -> Element:
         """Return the global TOC nodetree."""
         doctree = self.env.get_doctree(self.env.config.root_doc)
-        toctrees = []  # type: List[Element]
+        toctrees: List[Element] = []
         if 'includehidden' not in kwargs:
             kwargs['includehidden'] = True
         if 'maxdepth' not in kwargs or not kwargs['maxdepth']:
diff --git a/sphinx/environment/collectors/__init__.py b/sphinx/environment/collectors/__init__.py
index aa254bd9a1c..e2709101885 100644
--- a/sphinx/environment/collectors/__init__.py
+++ b/sphinx/environment/collectors/__init__.py
@@ -27,7 +27,7 @@ class EnvironmentCollector:
     entries and toctrees, etc.
     """
 
-    listener_ids = None  # type: Dict[str, int]
+    listener_ids: Dict[str, int] = None
 
     def enable(self, app: "Sphinx") -> None:
         assert self.listener_ids is None
diff --git a/sphinx/environment/collectors/asset.py b/sphinx/environment/collectors/asset.py
index b8d7ae4c0f3..0a696aa8dee 100644
--- a/sphinx/environment/collectors/asset.py
+++ b/sphinx/environment/collectors/asset.py
@@ -48,7 +48,7 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
             # choose the best image from these candidates.  The special key * is
             # set if there is only single candidate to be used by a writer.
             # The special key ? is set for nonlocal URIs.
-            candidates = {}  # type: Dict[str, str]
+            candidates: Dict[str, str] = {}
             node['candidates'] = candidates
             imguri = node['uri']
             if imguri.startswith('data:'):
@@ -94,7 +94,7 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
 
     def collect_candidates(self, env: BuildEnvironment, imgpath: str,
                            candidates: Dict[str, str], node: Node) -> None:
-        globbed = {}  # type: Dict[str, List[str]]
+        globbed: Dict[str, List[str]] = {}
         for filename in glob(imgpath):
             new_imgpath = relative_path(path.join(env.srcdir, 'dummy'),
                                         filename)
diff --git a/sphinx/environment/collectors/toctree.py b/sphinx/environment/collectors/toctree.py
index aeb6ef3a6d9..3a724118ef5 100644
--- a/sphinx/environment/collectors/toctree.py
+++ b/sphinx/environment/collectors/toctree.py
@@ -64,7 +64,7 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
 
         def traverse_in_section(node: Element, cls: "Type[N]") -> List[N]:
             """Like traverse(), but stay within the same section."""
-            result = []  # type: List[N]
+            result: List[N] = []
             if isinstance(node, cls):
                 result.append(node)
             for child in node.children:
@@ -75,7 +75,7 @@ def traverse_in_section(node: Element, cls: "Type[N]") -> List[N]:
             return result
 
         def build_toc(node: Element, depth: int = 1) -> nodes.bullet_list:
-            entries = []  # type: List[Element]
+            entries: List[Element] = []
             for sectionnode in node:
                 # find all toctree nodes in this section and add them
                 # to the toc (just copying the toctree node which is then
@@ -100,7 +100,7 @@ def build_toc(node: Element, depth: int = 1) -> nodes.bullet_list:
                         '', '', internal=True, refuri=docname,
                         anchorname=anchorname, *nodetext)
                     para = addnodes.compact_paragraph('', '', reference)
-                    item = nodes.list_item('', para)  # type: Element
+                    item: Element = nodes.list_item('', para)
                     sub_item = build_toc(sectionnode, depth + 1)
                     if sub_item:
                         item += sub_item
@@ -136,7 +136,7 @@ def assign_section_numbers(self, env: BuildEnvironment) -> List[str]:
         # a list of all docnames whose section numbers changed
         rewrite_needed = []
 
-        assigned = set()  # type: Set[str]
+        assigned: Set[str] = set()
         old_secnumbers = env.toc_secnumbers
         env.toc_secnumbers = {}
 
@@ -186,7 +186,7 @@ def _walk_toctree(toctreenode: addnodes.toctree, depth: int) -> None:
                                       '(nested numbered toctree?)'), ref,
                                    location=toctreenode, type='toc', subtype='secnum')
                 elif ref in env.tocs:
-                    secnums = {}  # type: Dict[str, Tuple[int, ...]]
+                    secnums: Dict[str, Tuple[int, ...]] = {}
                     env.toc_secnumbers[ref] = secnums
                     assigned.add(ref)
                     _walk_toc(env.tocs[ref], secnums, depth, env.titles.get(ref))
@@ -210,10 +210,10 @@ def assign_figure_numbers(self, env: BuildEnvironment) -> List[str]:
 
         rewrite_needed = []
 
-        assigned = set()  # type: Set[str]
+        assigned: Set[str] = set()
         old_fignumbers = env.toc_fignumbers
         env.toc_fignumbers = {}
-        fignum_counter = {}  # type: Dict[str, Dict[Tuple[int, ...], int]]
+        fignum_counter: Dict[str, Dict[Tuple[int, ...], int]] = {}
 
         def get_figtype(node: Node) -> str:
             for domain in env.domains.values():

From 2a90b28d61935a93cefff3437714e0c29a6cab5a Mon Sep 17 00:00:00 2001
From: Charalampos Stratakis <cstratak@redhat.com>
Date: Thu, 25 Mar 2021 18:17:45 +0100
Subject: [PATCH 212/305] Fix some local parameter names

---
 sphinx/builders/html/__init__.py | 2 +-
 sphinx/util/i18n.py              | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index c799b017671..c23938e91b4 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1140,7 +1140,7 @@ def convert_html_js_files(app: Sphinx, config: Config) -> None:
     config.html_js_files = html_js_files  # type: ignore
 
 
-def setup_js_tag_helper(app: Sphinx, pagename: str, templatexname: str,
+def setup_js_tag_helper(app: Sphinx, pagename: str, templatename: str,
                         context: Dict, doctree: Node) -> None:
     """Set up js_tag() template helper.
 
diff --git a/sphinx/util/i18n.py b/sphinx/util/i18n.py
index 8341dfffe4b..0c90317a9df 100644
--- a/sphinx/util/i18n.py
+++ b/sphinx/util/i18n.py
@@ -128,11 +128,11 @@ def find_catalog(docname: str, compaction: bool) -> str:
     return ret
 
 
-def docname_to_domain(docname: str, compation: Union[bool, str]) -> str:
+def docname_to_domain(docname: str, compaction: Union[bool, str]) -> str:
     """Convert docname to domain for catalogs."""
-    if isinstance(compation, str):
-        return compation
-    if compation:
+    if isinstance(compaction, str):
+        return compaction
+    if compaction:
         return docname.split(SEP, 1)[0]
     else:
         return docname

From b9f0582f06a8fe1b042333b9e8eb3cd575f1db2c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 27 Mar 2021 00:37:36 +0900
Subject: [PATCH 213/305] refactor: Use PEP-526 based variable annotation
 (sphinx.pycode)

---
 sphinx/pycode/__init__.py | 14 +++++------
 sphinx/pycode/ast.py      | 10 ++++----
 sphinx/pycode/parser.py   | 52 +++++++++++++++++++--------------------
 3 files changed, 38 insertions(+), 38 deletions(-)

diff --git a/sphinx/pycode/__init__.py b/sphinx/pycode/__init__.py
index aaf748559b4..c55a4fe4a08 100644
--- a/sphinx/pycode/__init__.py
+++ b/sphinx/pycode/__init__.py
@@ -26,7 +26,7 @@
 
 class ModuleAnalyzer:
     # cache for analyzer objects -- caches both by module and file name
-    cache = {}  # type: Dict[Tuple[str, str], Any]
+    cache: Dict[Tuple[str, str], Any] = {}
 
     @staticmethod
     def get_module_source(modname: str) -> Tuple[Optional[str], Optional[str]]:
@@ -135,12 +135,12 @@ def __init__(self, source: IO, modname: str, srcname: str) -> None:
         self.code = source.read()
 
         # will be filled by analyze()
-        self.annotations = None  # type: Dict[Tuple[str, str], str]
-        self.attr_docs = None    # type: Dict[Tuple[str, str], List[str]]
-        self.finals = None       # type: List[str]
-        self.overloads = None    # type: Dict[str, List[Signature]]
-        self.tagorder = None     # type: Dict[str, int]
-        self.tags = None         # type: Dict[str, Tuple[str, int, int]]
+        self.annotations: Dict[Tuple[str, str], str] = None
+        self.attr_docs: Dict[Tuple[str, str], List[str]] = None
+        self.finals: List[str] = None
+        self.overloads: Dict[str, List[Signature]] = None
+        self.tagorder: Dict[str, int] = None
+        self.tags: Dict[str, Tuple[str, int, int]] = None
         self._analyzed = False
 
     def parse(self) -> None:
diff --git a/sphinx/pycode/ast.py b/sphinx/pycode/ast.py
index e4e773b2523..f541ec0a90c 100644
--- a/sphinx/pycode/ast.py
+++ b/sphinx/pycode/ast.py
@@ -21,7 +21,7 @@
         import ast  # type: ignore
 
 
-OPERATORS = {
+OPERATORS: Dict[Type[ast.AST], str] = {
     ast.Add: "+",
     ast.And: "and",
     ast.BitAnd: "&",
@@ -41,7 +41,7 @@
     ast.Sub: "-",
     ast.UAdd: "+",
     ast.USub: "-",
-}  # type: Dict[Type[ast.AST], str]
+}
 
 
 def parse(code: str, mode: str = 'exec') -> "ast.AST":
@@ -108,7 +108,7 @@ def _visit_arg_with_default(self, arg: ast.arg, default: Optional[ast.AST]) -> s
         return name
 
     def visit_arguments(self, node: ast.arguments) -> str:
-        defaults = list(node.defaults)  # type: List[Optional[ast.expr]]
+        defaults: List[Optional[ast.expr]] = list(node.defaults)
         positionals = len(node.args)
         posonlyargs = 0
         if hasattr(node, "posonlyargs"):  # for py38+
@@ -117,11 +117,11 @@ def visit_arguments(self, node: ast.arguments) -> str:
         for _ in range(len(defaults), positionals):
             defaults.insert(0, None)
 
-        kw_defaults = list(node.kw_defaults)  # type: List[Optional[ast.expr]]
+        kw_defaults: List[Optional[ast.expr]] = list(node.kw_defaults)
         for _ in range(len(kw_defaults), len(node.kwonlyargs)):
             kw_defaults.insert(0, None)
 
-        args = []  # type: List[str]
+        args: List[str] = []
         if hasattr(node, "posonlyargs"):  # for py38+
             for i, arg in enumerate(node.posonlyargs):  # type: ignore
                 args.append(self._visit_arg_with_default(arg, defaults[i]))
diff --git a/sphinx/pycode/parser.py b/sphinx/pycode/parser.py
index d157c7c1c52..fa249d8c53b 100644
--- a/sphinx/pycode/parser.py
+++ b/sphinx/pycode/parser.py
@@ -129,8 +129,8 @@ def __init__(self, buffers: List[str]) -> None:
         lines = iter(buffers)
         self.buffers = buffers
         self.tokens = tokenize.generate_tokens(lambda: next(lines))
-        self.current = None     # type: Token
-        self.previous = None    # type: Token
+        self.current: Token = None
+        self.previous: Token = None
 
     def get_line(self, lineno: int) -> str:
         """Returns specified line."""
@@ -178,7 +178,7 @@ class AfterCommentParser(TokenProcessor):
 
     def __init__(self, lines: List[str]) -> None:
         super().__init__(lines)
-        self.comment = None  # type: str
+        self.comment: str = None
 
     def fetch_rvalue(self) -> List[Token]:
         """Fetch right-hand value of assignment."""
@@ -221,18 +221,18 @@ def __init__(self, buffers: List[str], encoding: str) -> None:
         self.counter = itertools.count()
         self.buffers = buffers
         self.encoding = encoding
-        self.context = []               # type: List[str]
-        self.current_classes = []       # type: List[str]
-        self.current_function = None    # type: ast.FunctionDef
-        self.comments = OrderedDict()   # type: Dict[Tuple[str, str], str]
-        self.annotations = {}           # type: Dict[Tuple[str, str], str]
-        self.previous = None            # type: ast.AST
-        self.deforders = {}             # type: Dict[str, int]
-        self.finals = []                # type: List[str]
-        self.overloads = {}             # type: Dict[str, List[Signature]]
-        self.typing = None              # type: str
-        self.typing_final = None        # type: str
-        self.typing_overload = None     # type: str
+        self.context: List[str] = []
+        self.current_classes: List[str] = []
+        self.current_function: ast.FunctionDef = None
+        self.comments: Dict[Tuple[str, str], str] = OrderedDict()
+        self.annotations: Dict[Tuple[str, str], str] = {}
+        self.previous: ast.AST = None
+        self.deforders: Dict[str, int] = {}
+        self.finals: List[str] = []
+        self.overloads: Dict[str, List[Signature]] = {}
+        self.typing: str = None
+        self.typing_final: str = None
+        self.typing_overload: str = None
         super().__init__()
 
     def get_qualname_for(self, name: str) -> Optional[List[str]]:
@@ -350,7 +350,7 @@ def visit_Assign(self, node: ast.Assign) -> None:
         """Handles Assign node and pick up a variable comment."""
         try:
             targets = get_assign_targets(node)
-            varnames = sum([get_lvar_names(t, self=self.get_self()) for t in targets], [])  # type: List[str]  # NOQA
+            varnames: List[str] = sum([get_lvar_names(t, self=self.get_self()) for t in targets], [])  # NOQA
             current_line = self.get_line(node.lineno)
         except TypeError:
             return  # this assignment is not new definition!
@@ -466,10 +466,10 @@ class DefinitionFinder(TokenProcessor):
 
     def __init__(self, lines: List[str]) -> None:
         super().__init__(lines)
-        self.decorator = None   # type: Token
-        self.context = []       # type: List[str]
-        self.indents = []       # type: List
-        self.definitions = {}   # type: Dict[str, Tuple[str, int, int]]
+        self.decorator: Token = None
+        self.context: List[str] = []
+        self.indents: List = []
+        self.definitions: Dict[str, Tuple[str, int, int]] = {}
 
     def add_definition(self, name: str, entry: Tuple[str, int, int]) -> None:
         """Add a location of definition."""
@@ -543,12 +543,12 @@ class Parser:
     def __init__(self, code: str, encoding: str = 'utf-8') -> None:
         self.code = filter_whitespace(code)
         self.encoding = encoding
-        self.annotations = {}       # type: Dict[Tuple[str, str], str]
-        self.comments = {}          # type: Dict[Tuple[str, str], str]
-        self.deforders = {}         # type: Dict[str, int]
-        self.definitions = {}       # type: Dict[str, Tuple[str, int, int]]
-        self.finals = []            # type: List[str]
-        self.overloads = {}         # type: Dict[str, List[Signature]]
+        self.annotations: Dict[Tuple[str, str], str] = {}
+        self.comments: Dict[Tuple[str, str], str] = {}
+        self.deforders: Dict[str, int] = {}
+        self.definitions: Dict[str, Tuple[str, int, int]] = {}
+        self.finals: List[str] = []
+        self.overloads: Dict[str, List[Signature]] = {}
 
     def parse(self) -> None:
         """Parse the source code."""

From 94dc1d78a44f40c497e0126ecb70a172615baa11 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 27 Mar 2021 00:38:32 +0900
Subject: [PATCH 214/305] refactor: Use PEP-526 based variable annotation
 (sphinx.search)

---
 sphinx/search/__init__.py | 53 ++++++++++++++++++---------------------
 sphinx/search/ja.py       |  4 +--
 sphinx/search/ro.py       |  2 +-
 sphinx/search/tr.py       |  2 +-
 sphinx/search/zh.py       |  4 +--
 5 files changed, 30 insertions(+), 35 deletions(-)

diff --git a/sphinx/search/__init__.py b/sphinx/search/__init__.py
index 2c063853112..2a34202441a 100644
--- a/sphinx/search/__init__.py
+++ b/sphinx/search/__init__.py
@@ -53,11 +53,11 @@ class SearchLanguage:
        This class is used to preprocess search word which Sphinx HTML readers
        type, before searching index. Default implementation does nothing.
     """
-    lang = None                 # type: str
-    language_name = None        # type: str
-    stopwords = set()           # type: Set[str]
-    js_splitter_code = None     # type: str
-    js_stemmer_rawcode = None   # type: str
+    lang: str = None
+    language_name: str = None
+    stopwords: Set[str] = set()
+    js_splitter_code: str = None
+    js_stemmer_rawcode: str = None
     js_stemmer_code = """
 /**
  * Dummy stemmer for languages without stemming rules.
@@ -124,7 +124,7 @@ def parse_stop_word(source: str) -> Set[str]:
 
     * http://snowball.tartarus.org/algorithms/finnish/stop.txt
     """
-    result = set()  # type: Set[str]
+    result: Set[str] = set()
     for line in source.splitlines():
         line = line.split('|')[0]  # remove comment
         result.update(line.split())
@@ -132,7 +132,7 @@ def parse_stop_word(source: str) -> Set[str]:
 
 
 # maps language name to module.class or directly a class
-languages = {
+languages: Dict[str, Any] = {
     'da': 'sphinx.search.da.SearchDanish',
     'de': 'sphinx.search.de.SearchGerman',
     'en': SearchEnglish,
@@ -150,7 +150,7 @@ def parse_stop_word(source: str) -> Set[str]:
     'sv': 'sphinx.search.sv.SearchSwedish',
     'tr': 'sphinx.search.tr.SearchTurkish',
     'zh': 'sphinx.search.zh.SearchChinese',
-}  # type: Dict[str, Any]
+}
 
 
 class _JavaScriptIndex:
@@ -189,8 +189,8 @@ class WordCollector(nodes.NodeVisitor):
 
     def __init__(self, document: nodes.document, lang: SearchLanguage) -> None:
         super().__init__(document)
-        self.found_words = []           # type: List[str]
-        self.found_title_words = []     # type: List[str]
+        self.found_words: List[str] = []
+        self.found_title_words: List[str] = []
         self.lang = lang
 
     def is_meta_keywords(self, node: addnodes.meta) -> bool:
@@ -238,29 +238,24 @@ class IndexBuilder:
 
     def __init__(self, env: BuildEnvironment, lang: str, options: Dict, scoring: str) -> None:
         self.env = env
-        self._titles = {}           # type: Dict[str, str]
-                                    # docname -> title
-        self._filenames = {}        # type: Dict[str, str]
-                                    # docname -> filename
-        self._mapping = {}          # type: Dict[str, Set[str]]
-                                    # stemmed word -> set(docname)
-        self._title_mapping = {}    # type: Dict[str, Set[str]]
-                                    # stemmed words in titles -> set(docname)
-        self._stem_cache = {}       # type: Dict[str, str]
-                                    # word -> stemmed word
-        self._objtypes = {}         # type: Dict[Tuple[str, str], int]
-                                    # objtype -> index
-        self._objnames = {}         # type: Dict[int, Tuple[str, str, str]]
-                                    # objtype index -> (domain, type, objname (localized))
-        lang_class = languages.get(lang)    # type: Type[SearchLanguage]
-                                            # add language-specific SearchLanguage instance
+        self._titles: Dict[str, str] = {}           # docname -> title
+        self._filenames: Dict[str, str] = {}        # docname -> filename
+        self._mapping: Dict[str, Set[str]] = {}     # stemmed word -> set(docname)
+        # stemmed words in titles -> set(docname)
+        self._title_mapping: Dict[str, Set[str]] = {}
+        self._stem_cache: Dict[str, str] = {}       # word -> stemmed word
+        self._objtypes: Dict[Tuple[str, str], int] = {}     # objtype -> index
+        # objtype index -> (domain, type, objname (localized))
+        self._objnames: Dict[int, Tuple[str, str, str]] = {}
+        # add language-specific SearchLanguage instance
+        lang_class: Type[SearchLanguage] = languages.get(lang)
 
         # fallback; try again with language-code
         if lang_class is None and '_' in lang:
             lang_class = languages.get(lang.split('_')[0])
 
         if lang_class is None:
-            self.lang = SearchEnglish(options)  # type: SearchLanguage
+            self.lang: SearchLanguage = SearchEnglish(options)
         elif isinstance(lang_class, str):
             module, classname = lang_class.rsplit('.', 1)
             lang_class = getattr(import_module(module), classname)
@@ -310,7 +305,7 @@ def dump(self, stream: IO, format: Any) -> None:
 
     def get_objects(self, fn2index: Dict[str, int]
                     ) -> Dict[str, Dict[str, Tuple[int, int, int, str]]]:
-        rv = {}  # type: Dict[str, Dict[str, Tuple[int, int, int, str]]]
+        rv: Dict[str, Dict[str, Tuple[int, int, int, str]]] = {}
         otypes = self._objtypes
         onames = self._objnames
         for domainname, domain in sorted(self.env.domains.items()):
@@ -346,7 +341,7 @@ def get_objects(self, fn2index: Dict[str, int]
         return rv
 
     def get_terms(self, fn2index: Dict) -> Tuple[Dict[str, List[str]], Dict[str, List[str]]]:
-        rvs = {}, {}  # type: Tuple[Dict[str, List[str]], Dict[str, List[str]]]
+        rvs: Tuple[Dict[str, List[str]], Dict[str, List[str]]] = ({}, {})
         for rv, mapping in zip(rvs, (self._mapping, self._title_mapping)):
             for k, v in mapping.items():
                 if len(v) == 1:
diff --git a/sphinx/search/ja.py b/sphinx/search/ja.py
index 6f10a4239cc..e739f1d1689 100644
--- a/sphinx/search/ja.py
+++ b/sphinx/search/ja.py
@@ -54,8 +54,8 @@ def split(self, input: str) -> List[str]:
 class MecabSplitter(BaseSplitter):
     def __init__(self, options: Dict) -> None:
         super().__init__(options)
-        self.ctypes_libmecab = None     # type: Any
-        self.ctypes_mecab = None        # type: Any
+        self.ctypes_libmecab: Any = None
+        self.ctypes_mecab: Any = None
         if not native_module:
             self.init_ctypes(options)
         else:
diff --git a/sphinx/search/ro.py b/sphinx/search/ro.py
index 721f888cc4b..7b592d1c8b4 100644
--- a/sphinx/search/ro.py
+++ b/sphinx/search/ro.py
@@ -19,7 +19,7 @@ class SearchRomanian(SearchLanguage):
     lang = 'ro'
     language_name = 'Romanian'
     js_stemmer_rawcode = 'romanian-stemmer.js'
-    stopwords = set()  # type: Set[str]
+    stopwords: Set[str] = set()
 
     def init(self, options: Dict) -> None:
         self.stemmer = snowballstemmer.stemmer('romanian')
diff --git a/sphinx/search/tr.py b/sphinx/search/tr.py
index 644e8a53426..8d9d1fade26 100644
--- a/sphinx/search/tr.py
+++ b/sphinx/search/tr.py
@@ -19,7 +19,7 @@ class SearchTurkish(SearchLanguage):
     lang = 'tr'
     language_name = 'Turkish'
     js_stemmer_rawcode = 'turkish-stemmer.js'
-    stopwords = set()  # type: Set[str]
+    stopwords: Set[str] = set()
 
     def init(self, options: Dict) -> None:
         self.stemmer = snowballstemmer.stemmer('turkish')
diff --git a/sphinx/search/zh.py b/sphinx/search/zh.py
index 6948a6ad45f..7471525057c 100644
--- a/sphinx/search/zh.py
+++ b/sphinx/search/zh.py
@@ -230,7 +230,7 @@ class SearchChinese(SearchLanguage):
     js_stemmer_code = js_porter_stemmer
     stopwords = english_stopwords
     latin1_letters = re.compile(r'[a-zA-Z0-9_]+')
-    latin_terms = []  # type: List[str]
+    latin_terms: List[str] = []
 
     def init(self, options: Dict) -> None:
         if JIEBA:
@@ -241,7 +241,7 @@ def init(self, options: Dict) -> None:
         self.stemmer = get_stemmer()
 
     def split(self, input: str) -> List[str]:
-        chinese = []  # type: List[str]
+        chinese: List[str] = []
         if JIEBA:
             chinese = list(jieba.cut_for_search(input))
 

From 2118c972bbe7de7645739e08675aa41bae4a05c0 Mon Sep 17 00:00:00 2001
From: Aaron Carlisle <carlisle.aaron00@gmail.com>
Date: Fri, 26 Mar 2021 14:59:08 -0400
Subject: [PATCH 215/305] HTML Templates: Add blocks to search page

This allows themes to customize the default search page.
---
 sphinx/themes/basic/search.html | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/sphinx/themes/basic/search.html b/sphinx/themes/basic/search.html
index 453a35fb982..5ba3c017e35 100644
--- a/sphinx/themes/basic/search.html
+++ b/sphinx/themes/basic/search.html
@@ -20,6 +20,7 @@
 {% endblock %}
 {% block body %}
   <h1 id="search-documentation">{{ _('Search') }}</h1>
+  {% block scriptwarning %}
   <div id="fallback" class="admonition warning">
   <script>$('#fallback').hide();</script>
   <p>
@@ -27,15 +28,21 @@ <h1 id="search-documentation">{{ _('Search') }}</h1>
     functionality.{% endtrans %}
   </p>
   </div>
+  {% endblock %}
+  {% block searchtext %}
   <p>
     {% trans %}Searching for multiple words only shows matches that contain
     all words.{% endtrans %}
   </p>
+  {% endblock %}
+  {% block searchbox %}
   <form action="" method="get">
     <input type="text" name="q" aria-labelledby="search-documentation" value="" />
     <input type="submit" value="{{ _('search') }}" />
     <span id="search-progress" style="padding-left: 10px"></span>
   </form>
+  {% endblock %}
+  {% block searchresults %}
   {% if search_performed %}
     <h2>{{ _('Search Results') }}</h2>
     {% if not search_results %}
@@ -53,4 +60,5 @@ <h2>{{ _('Search Results') }}</h2>
     </ul>
   {% endif %}
   </div>
+  {% endblock %}
 {% endblock %}

From acf66bc4d5b53189f893a50a235e710f063d629d Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 22 Mar 2021 01:33:37 +0900
Subject: [PATCH 216/305] Close #5603: autodoc: Allow to refer to a python
 object using canonical name

This generates `:canonical:` option for `:py:class:` directive if the
target class is imported from other module.  It allows users to refer it
using both the new name (imported name) and the original name (canonical
name).

It helps a library that implements some class in private module (like
`_io.StringIO`), and publish it as public module (like `io.StringIO`).
---
 CHANGES                                       |  2 ++
 sphinx/ext/autodoc/__init__.py                | 18 +++++++++++
 .../target/canonical/__init__.py              |  1 +
 .../target/canonical/original.py              | 15 +++++++++
 tests/test_ext_autodoc.py                     | 31 +++++++++++++++++++
 5 files changed, 67 insertions(+)
 create mode 100644 tests/roots/test-ext-autodoc/target/canonical/__init__.py
 create mode 100644 tests/roots/test-ext-autodoc/target/canonical/original.py

diff --git a/CHANGES b/CHANGES
index ee7e33cb1b0..bab38886ed8 100644
--- a/CHANGES
+++ b/CHANGES
@@ -66,6 +66,8 @@ Features added
 
 * #8924: autodoc: Support ``bound`` argument for TypeVar
 * #7383: autodoc: Support typehints for properties
+* #5603: autodoc: Allow to refer to a python class using its canonical name
+  when the class has two different names; a canonical name and an alias name
 * #7549: autosummary: Enable :confval:`autosummary_generate` by default
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index a01402090bc..3d33b6a8e83 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -1590,6 +1590,20 @@ def get_overloaded_signatures(self) -> List[Signature]:
 
         return []
 
+    def get_canonical_fullname(self) -> Optional[str]:
+        __modname__ = safe_getattr(self.object, '__module__', self.modname)
+        __qualname__ = safe_getattr(self.object, '__qualname__', None)
+        if __qualname__ is None:
+            __qualname__ = safe_getattr(self.object, '__name__', None)
+        if __qualname__ and '<locals>' in __qualname__:
+            # No valid qualname found if the object is defined as locals
+            __qualname__ = None
+
+        if __modname__ and __qualname__:
+            return '.'.join([__modname__, __qualname__])
+        else:
+            return None
+
     def add_directive_header(self, sig: str) -> None:
         sourcename = self.get_sourcename()
 
@@ -1600,6 +1614,10 @@ def add_directive_header(self, sig: str) -> None:
         if self.analyzer and '.'.join(self.objpath) in self.analyzer.finals:
             self.add_line('   :final:', sourcename)
 
+        canonical_fullname = self.get_canonical_fullname()
+        if not self.doc_as_attr and canonical_fullname and self.fullname != canonical_fullname:
+            self.add_line('   :canonical: %s' % canonical_fullname, sourcename)
+
         # add inheritance info, if wanted
         if not self.doc_as_attr and self.options.show_inheritance:
             sourcename = self.get_sourcename()
diff --git a/tests/roots/test-ext-autodoc/target/canonical/__init__.py b/tests/roots/test-ext-autodoc/target/canonical/__init__.py
new file mode 100644
index 00000000000..4ca2b339c8c
--- /dev/null
+++ b/tests/roots/test-ext-autodoc/target/canonical/__init__.py
@@ -0,0 +1 @@
+from target.canonical.original import Bar, Foo
diff --git a/tests/roots/test-ext-autodoc/target/canonical/original.py b/tests/roots/test-ext-autodoc/target/canonical/original.py
new file mode 100644
index 00000000000..42049b2165e
--- /dev/null
+++ b/tests/roots/test-ext-autodoc/target/canonical/original.py
@@ -0,0 +1,15 @@
+class Foo:
+    """docstring"""
+
+    def meth(self):
+        """docstring"""
+
+
+def bar():
+    class Bar:
+        """docstring"""
+
+    return Bar
+
+
+Bar = bar()
diff --git a/tests/test_ext_autodoc.py b/tests/test_ext_autodoc.py
index 8ea799f4973..824ee77c269 100644
--- a/tests/test_ext_autodoc.py
+++ b/tests/test_ext_autodoc.py
@@ -2474,3 +2474,34 @@ def test_hide_value(app):
         '   :meta hide-value:',
         '',
     ]
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_canonical(app):
+    options = {'members': None,
+               'imported-members': None}
+    actual = do_autodoc(app, 'module', 'target.canonical', options)
+    assert list(actual) == [
+        '',
+        '.. py:module:: target.canonical',
+        '',
+        '',
+        '.. py:class:: Bar()',
+        '   :module: target.canonical',
+        '',
+        '   docstring',
+        '',
+        '',
+        '.. py:class:: Foo()',
+        '   :module: target.canonical',
+        '   :canonical: target.canonical.original.Foo',
+        '',
+        '   docstring',
+        '',
+        '',
+        '   .. py:method:: Foo.meth()',
+        '      :module: target.canonical',
+        '',
+        '      docstring',
+        '',
+    ]

From 94b5607591cde699e95b8f7ec8a949adc312f98b Mon Sep 17 00:00:00 2001
From: Ashley Whetter <ashley@awhetter.co.uk>
Date: Sat, 6 Feb 2021 09:57:02 -0800
Subject: [PATCH 217/305] Overloaded function signatures do not require a
 separating backslash

---
 doc/usage/extensions/autodoc.rst               | 10 +++++++---
 sphinx/ext/autodoc/__init__.py                 | 14 ++------------
 .../target/docstring_signature.py              |  6 ++++++
 tests/test_ext_autodoc_configs.py              | 18 ++++++++++++++++--
 4 files changed, 31 insertions(+), 17 deletions(-)

diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index 034c86e1132..d49c2ea3c8c 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -529,15 +529,19 @@ There are also config values that you can set:
    looks like a signature, use the line as the signature and remove it from the
    docstring content.
 
-   If the signature line ends with backslash, autodoc considers the function has
-   multiple signatures and look at the next line of the docstring.  It is useful
-   for overloaded function.
+   autodoc will continue to look for multiple signature lines,
+   stopping at the first line that does not look like a signature.
+   This is useful for declaring overloaded function signatures.
 
    .. versionadded:: 1.1
    .. versionchanged:: 3.1
 
       Support overloaded signatures
 
+   .. versionchanged:: 4.0
+
+      Overloaded signatures do not need to be separated by a backslash
+
 .. confval:: autodoc_mock_imports
 
    This value contains a list of modules to be mocked up. This is useful when
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 3d33b6a8e83..4434d5404ef 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -1191,20 +1191,17 @@ def _find_signature(self) -> Tuple[str, str]:
                     break
 
                 if line.endswith('\\'):
-                    multiline = True
                     line = line.rstrip('\\').rstrip()
-                else:
-                    multiline = False
 
                 # match first line of docstring against signature RE
                 match = py_ext_sig_re.match(line)
                 if not match:
-                    continue
+                    break
                 exmod, path, base, args, retann = match.groups()
 
                 # the base name must match ours
                 if base not in valid_names:
-                    continue
+                    break
 
                 # re-prepare docstring to ignore more leading indentation
                 tab_width = self.directive.state.document.settings.tab_width  # type: ignore
@@ -1218,13 +1215,6 @@ def _find_signature(self) -> Tuple[str, str]:
                     # subsequent signatures
                     self._signatures.append("(%s) -> %s" % (args, retann))
 
-                if multiline:
-                    # the signature have multiple signatures on docstring
-                    continue
-                else:
-                    # don't look any further
-                    break
-
             if result:
                 # finish the loop when signature found
                 break
diff --git a/tests/roots/test-ext-autodoc/target/docstring_signature.py b/tests/roots/test-ext-autodoc/target/docstring_signature.py
index 244109629bc..d9deb6244ac 100644
--- a/tests/roots/test-ext-autodoc/target/docstring_signature.py
+++ b/tests/roots/test-ext-autodoc/target/docstring_signature.py
@@ -23,3 +23,9 @@ class E:
     def __init__(self):
         """E(foo: int, bar: int, baz: int) -> None \\
         E(foo: str, bar: str, baz: str) -> None"""
+
+
+class F:
+    def __init__(self):
+        """F(foo: int, bar: int, baz: int) -> None
+        F(foo: str, bar: str, baz: str) -> None"""
diff --git a/tests/test_ext_autodoc_configs.py b/tests/test_ext_autodoc_configs.py
index cc34143ca36..b465a95879f 100644
--- a/tests/test_ext_autodoc_configs.py
+++ b/tests/test_ext_autodoc_configs.py
@@ -348,7 +348,11 @@ def test_autoclass_content_and_docstring_signature_class(app):
         '',
         '.. py:class:: E()',
         '   :module: target.docstring_signature',
-        ''
+        '',
+        '',
+        '.. py:class:: F()',
+        '   :module: target.docstring_signature',
+        '',
     ]
 
 
@@ -382,7 +386,12 @@ def test_autoclass_content_and_docstring_signature_init(app):
         '.. py:class:: E(foo: int, bar: int, baz: int) -> None',
         '              E(foo: str, bar: str, baz: str) -> None',
         '   :module: target.docstring_signature',
-        ''
+        '',
+        '',
+        '.. py:class:: F(foo: int, bar: int, baz: int) -> None',
+        '              F(foo: str, bar: str, baz: str) -> None',
+        '   :module: target.docstring_signature',
+        '',
     ]
 
 
@@ -421,6 +430,11 @@ def test_autoclass_content_and_docstring_signature_both(app):
         '              E(foo: str, bar: str, baz: str) -> None',
         '   :module: target.docstring_signature',
         '',
+        '',
+        '.. py:class:: F(foo: int, bar: int, baz: int) -> None',
+        '              F(foo: str, bar: str, baz: str) -> None',
+        '   :module: target.docstring_signature',
+        '',
     ]
 
 

From 4785f32ddf2508e85a3495c6447ff6415e8a2a29 Mon Sep 17 00:00:00 2001
From: Matt Wozniski <mwozniski@bloomberg.net>
Date: Mon, 14 Dec 2020 17:38:37 -0500
Subject: [PATCH 218/305] Add autodoc_typehint_undoc option

Previously, if autodoc_typehints="description", a :type: field would be
added for every parameter and return type appearing in the annotation,
including **kwargs and underscore-prefixed parameters that are meant to
be private, as well as None return types.

This commit introduces a new option, "autodoc_typehint_undoc".  By
default this option is True, requesting the old behavior. By setting
this option to False, :type: and :rtype: fields will only be added for
annotated parameters or return types if there is already a corresponding
:param: or :return: field, to put users in control over whether a given
parameter is documented or not.
---
 doc/usage/extensions/autodoc.rst | 13 ++++++++
 sphinx/ext/autodoc/__init__.py   |  2 ++
 sphinx/ext/autodoc/typehints.py  | 53 ++++++++++++++++++++++++++++++--
 3 files changed, 66 insertions(+), 2 deletions(-)

diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index 034c86e1132..5ee71c78293 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -571,6 +571,19 @@ There are also config values that you can set:
 
       New option ``'description'`` is added.
 
+.. confval:: autodoc_typehints_description_target
+
+   This value controls whether the types of undocumented parameters and return
+   values are documented when ``autodoc_typehints`` is set to ``description``.
+
+   The default value is ``"all"``, meaning that types are documented for all
+   parameters and return values, whether they are documented or not.
+
+   When set to ``"documented"``, types will only be documented for a parameter
+   or a return value that is already documented by the docstring.
+
+   .. versionadded:: 4.0
+
 .. confval:: autodoc_type_aliases
 
    A dictionary for users defined `type aliases`__ that maps a type name to the
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 3d33b6a8e83..57499ec6fd9 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -2656,6 +2656,8 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_config_value('autodoc_mock_imports', [], True)
     app.add_config_value('autodoc_typehints', "signature", True,
                          ENUM("signature", "description", "none"))
+    app.add_config_value('autodoc_typehints_description_target', 'all', True,
+                         ENUM('all', 'documented'))
     app.add_config_value('autodoc_type_aliases', {}, True)
     app.add_config_value('autodoc_warningiserror', True, True)
     app.add_config_value('autodoc_inherit_docstrings', True, True)
diff --git a/sphinx/ext/autodoc/typehints.py b/sphinx/ext/autodoc/typehints.py
index 9811bdb554c..f2154b9ab44 100644
--- a/sphinx/ext/autodoc/typehints.py
+++ b/sphinx/ext/autodoc/typehints.py
@@ -10,7 +10,7 @@
 
 import re
 from collections import OrderedDict
-from typing import Any, Dict, Iterable, cast
+from typing import Any, Dict, Iterable, Set, cast
 
 from docutils import nodes
 from docutils.nodes import Element
@@ -63,7 +63,10 @@ def merge_typehints(app: Sphinx, domain: str, objtype: str, contentnode: Element
             field_lists.append(field_list)
 
         for field_list in field_lists:
-            modify_field_list(field_list, annotations[fullname])
+            if app.config.autodoc_typehints_description_target == "all":
+                modify_field_list(field_list, annotations[fullname])
+            else:
+                augment_descriptions_with_types(field_list, annotations[fullname])
 
 
 def insert_field_list(node: Element) -> nodes.field_list:
@@ -126,6 +129,52 @@ def modify_field_list(node: nodes.field_list, annotations: Dict[str, str]) -> No
         node += field
 
 
+def augment_descriptions_with_types(
+    node: nodes.field_list,
+    annotations: Dict[str, str],
+) -> None:
+    fields = cast(Iterable[nodes.field], node)
+    has_description = set()  # type: Set[str]
+    has_type = set()  # type: Set[str]
+    for field in fields:
+        field_name = field[0].astext()
+        parts = re.split(' +', field_name)
+        if parts[0] == 'param':
+            if len(parts) == 2:
+                # :param xxx:
+                has_description.add(parts[1])
+            elif len(parts) > 2:
+                # :param xxx yyy:
+                name = ' '.join(parts[2:])
+                has_description.add(name)
+                has_type.add(name)
+        elif parts[0] == 'type':
+            name = ' '.join(parts[1:])
+            has_type.add(name)
+        elif parts[0] == 'return':
+            has_description.add('return')
+        elif parts[0] == 'rtype':
+            has_type.add('return')
+
+    # Add 'type' for parameters with a description but no declared type.
+    for name in annotations:
+        if name == 'return':
+            continue
+        if name in has_description and name not in has_type:
+            field = nodes.field()
+            field += nodes.field_name('', 'type ' + name)
+            field += nodes.field_body('', nodes.paragraph('', annotations[name]))
+            node += field
+
+    # Add 'rtype' if 'return' is present and 'rtype' isn't.
+    if 'return' in annotations:
+        if 'return' in has_description and 'return' not in has_type:
+            field = nodes.field()
+            field += nodes.field_name('', 'rtype')
+            field += nodes.field_body('', nodes.paragraph('', annotations['return']))
+            node += field
+
+
 def setup(app: Sphinx) -> Dict[str, Any]:
     app.connect('autodoc-process-signature', record_typehints)
     app.connect('object-description-transform', merge_typehints)

From be2cee53a16988fd6bcc606a0a5c6a3c5cbdac26 Mon Sep 17 00:00:00 2001
From: Matt Wozniski <mwozniski@bloomberg.net>
Date: Mon, 14 Dec 2020 17:09:13 -0500
Subject: [PATCH 219/305] Use __init__ type hints in "description" mode

Previously, `__init__` type hints were not used when documenting a class
using `autodoc_typehints="description"`. This was done to prevent
documentation for parameters from showing up twice, both for the class
and the `__init__` special method. As the new ``autodoc_typehint_undoc``
option provides a better way to prevent this bad behavior by placing the
user in control of where the type hints are added, it is now safe to add
type hints for documented `__init__` parameters.

Closes #8178
---
 sphinx/ext/autodoc/typehints.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/sphinx/ext/autodoc/typehints.py b/sphinx/ext/autodoc/typehints.py
index f2154b9ab44..1cc2abd090a 100644
--- a/sphinx/ext/autodoc/typehints.py
+++ b/sphinx/ext/autodoc/typehints.py
@@ -42,8 +42,6 @@ def merge_typehints(app: Sphinx, domain: str, objtype: str, contentnode: Element
         return
     if app.config.autodoc_typehints != 'description':
         return
-    if objtype == 'class' and app.config.autoclass_content not in ('init', 'both'):
-        return
 
     try:
         signature = cast(addnodes.desc_signature, contentnode.parent[0])

From 4c72848b85a127b1e8cbf9aae639dad560f98e44 Mon Sep 17 00:00:00 2001
From: Matt Wozniski <mwozniski@bloomberg.net>
Date: Mon, 14 Dec 2020 19:16:07 -0500
Subject: [PATCH 220/305] Test autodoc_typehint_undoc

Add new tests to exercise the new autodoc_typehint_undoc option. Where
an existing test would have a meaningful behavior change with the new
option set to False, that test is copied, the new option is set to False
in the copy, and the assertions reflect the new expected behavior.

The new test test_autodoc_typehints_description_with_documented_init
illustrates the problem reported in #7329, and the new test
test_autodoc_typehints_description_with_documented_init_no_undoc
illustrates that this issue no longer occurs when the new
autodoc_typehint_undoc option is set to False.
---
 .../test-ext-autodoc/target/typehints.py      | 10 +++
 tests/test_ext_autodoc_configs.py             | 84 +++++++++++++++++++
 2 files changed, 94 insertions(+)

diff --git a/tests/roots/test-ext-autodoc/target/typehints.py b/tests/roots/test-ext-autodoc/target/typehints.py
index 2c903965082..bb56054c30f 100644
--- a/tests/roots/test-ext-autodoc/target/typehints.py
+++ b/tests/roots/test-ext-autodoc/target/typehints.py
@@ -68,3 +68,13 @@ def missing_attr(c,
                  ):
     # type: (...) -> str
     return a + (b or "")
+
+
+class _ClassWithDocumentedInit:
+    """Class docstring."""
+
+    def __init__(self, x: int) -> None:
+        """Init docstring.
+
+        :param x: Some integer
+        """
diff --git a/tests/test_ext_autodoc_configs.py b/tests/test_ext_autodoc_configs.py
index cc34143ca36..9477e3f957a 100644
--- a/tests/test_ext_autodoc_configs.py
+++ b/tests/test_ext_autodoc_configs.py
@@ -682,6 +682,90 @@ def test_autodoc_typehints_description(app):
             in context)
 
 
+@pytest.mark.sphinx('text', testroot='ext-autodoc',
+                    confoverrides={'autodoc_typehints': "description",
+                                   'autodoc_typehints_description_target': 'documented'})
+def test_autodoc_typehints_description_no_undoc(app):
+    # No :type: or :rtype: will be injected for `incr`, which does not have
+    # a description for its parameters or its return. `tuple_args` does
+    # describe them, so :type: and :rtype: will be added.
+    (app.srcdir / 'index.rst').write_text(
+        '.. autofunction:: target.typehints.incr\n'
+        '\n'
+        '.. autofunction:: target.typehints.tuple_args\n'
+        '\n'
+        '   :param x: arg\n'
+        '   :return: another tuple\n'
+    )
+    app.build()
+    context = (app.outdir / 'index.txt').read_text()
+    assert ('target.typehints.incr(a, b=1)\n'
+            '\n'
+            'target.typehints.tuple_args(x)\n'
+            '\n'
+            '   Parameters:\n'
+            '      **x** (*Tuple**[**int**, **Union**[**int**, **str**]**]*) -- arg\n'
+            '\n'
+            '   Returns:\n'
+            '      another tuple\n'
+            '\n'
+            '   Return type:\n'
+            '      Tuple[int, int]\n'
+            in context)
+
+
+@pytest.mark.sphinx('text', testroot='ext-autodoc',
+                    confoverrides={'autodoc_typehints': "description"})
+def test_autodoc_typehints_description_with_documented_init(app):
+    (app.srcdir / 'index.rst').write_text(
+        '.. autoclass:: target.typehints._ClassWithDocumentedInit\n'
+        '   :special-members: __init__\n'
+    )
+    app.build()
+    context = (app.outdir / 'index.txt').read_text()
+    assert ('class target.typehints._ClassWithDocumentedInit(x)\n'
+            '\n'
+            '   Class docstring.\n'
+            '\n'
+            '   Parameters:\n'
+            '      **x** (*int*) --\n'
+            '\n'
+            '   Return type:\n'
+            '      None\n'
+            '\n'
+            '   __init__(x)\n'
+            '\n'
+            '      Init docstring.\n'
+            '\n'
+            '      Parameters:\n'
+            '         **x** (*int*) -- Some integer\n'
+            '\n'
+            '      Return type:\n'
+            '         None\n' == context)
+
+
+@pytest.mark.sphinx('text', testroot='ext-autodoc',
+                    confoverrides={'autodoc_typehints': "description",
+                                   'autodoc_typehints_description_target': 'documented'})
+def test_autodoc_typehints_description_with_documented_init_no_undoc(app):
+    (app.srcdir / 'index.rst').write_text(
+        '.. autoclass:: target.typehints._ClassWithDocumentedInit\n'
+        '   :special-members: __init__\n'
+    )
+    app.build()
+    context = (app.outdir / 'index.txt').read_text()
+    assert ('class target.typehints._ClassWithDocumentedInit(x)\n'
+            '\n'
+            '   Class docstring.\n'
+            '\n'
+            '   __init__(x)\n'
+            '\n'
+            '      Init docstring.\n'
+            '\n'
+            '      Parameters:\n'
+            '         **x** (*int*) -- Some integer\n' == context)
+
+
 @pytest.mark.sphinx('text', testroot='ext-autodoc',
                     confoverrides={'autodoc_typehints': "description"})
 def test_autodoc_typehints_description_for_invalid_node(app):

From 260725c82314fb2937e360303c88c538e92d01f2 Mon Sep 17 00:00:00 2001
From: Albert Villanova del Moral
 <8515462+albertvillanova@users.noreply.github.com>
Date: Tue, 30 Mar 2021 08:45:34 +0200
Subject: [PATCH 221/305] Fix minor typo

---
 doc/usage/restructuredtext/domains.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/restructuredtext/domains.rst b/doc/usage/restructuredtext/domains.rst
index e4909f7930d..53e1fc5d3cf 100644
--- a/doc/usage/restructuredtext/domains.rst
+++ b/doc/usage/restructuredtext/domains.rst
@@ -50,7 +50,7 @@ give the directive option flag ``:noindexentry:``.
 If you want to typeset an object description, without even making it available
 for cross-referencing, you can give the directive option flag ``:noindex:``
 (which implies ``:noindexentry:``).
-Though, note that not every directive en every domain may support these
+Though, note that not every directive in every domain may support these
 options.
 
 .. versionadded:: 3.2

From ac0dcddeb8dadb2d901864b8ad0fa652cb65098c Mon Sep 17 00:00:00 2001
From: Brecht Machiels <brecht@mos6581.org>
Date: Tue, 30 Mar 2021 16:44:50 +0200
Subject: [PATCH 222/305] Docs: fix typo in env-merge-info

---
 doc/extdev/appapi.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/extdev/appapi.rst b/doc/extdev/appapi.rst
index 9949910346a..41318e9d62b 100644
--- a/doc/extdev/appapi.rst
+++ b/doc/extdev/appapi.rst
@@ -177,7 +177,7 @@ type for that event::
             - event.doctree-read(app, doctree) is called in the middle of transforms,
               transforms come before/after this event depending on their priority.
    
-   9. event.env-merged-info(app, env, docnames, other)
+   9. event.env-merge-info(app, env, docnames, other)
       - if running in parallel mode, this event will be emitted for each process
    
    10. event.env-updated(app, env)

From a476559abfcc69c1e9bfd19f05326243c445d29c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 3 Apr 2021 23:33:35 +0900
Subject: [PATCH 223/305] Update CHANGES for PR #8539

---
 CHANGES | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CHANGES b/CHANGES
index bab38886ed8..8f4a78465a2 100644
--- a/CHANGES
+++ b/CHANGES
@@ -11,6 +11,8 @@ Dependencies
 Incompatible changes
 --------------------
 
+* #8539: autodoc: info-field-list is generated into the class description when
+  ``autodoc_typehints='description'`` and ``autoclass_content='class'`` set
 * domain: The ``Index`` class becomes subclasses of ``abc.ABC`` to indicate
   methods that must be overrided in the concrete classes
 * #4826: py domain: The structure of python objects is changed.  A boolean value
@@ -68,6 +70,8 @@ Features added
 * #7383: autodoc: Support typehints for properties
 * #5603: autodoc: Allow to refer to a python class using its canonical name
   when the class has two different names; a canonical name and an alias name
+* #8539: autodoc: Add :confval:`autodoc_typehints_description_target` to control
+  the behavior of ``autodoc_typehints=description``
 * #7549: autosummary: Enable :confval:`autosummary_generate` by default
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined

From 8d60b048449ba31bf71bac9927bcc92df8a3d8de Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 4 Apr 2021 00:28:08 +0900
Subject: [PATCH 224/305] Fix CI: NameError for missing docutils variable in
 test_build_html

---
 tests/test_build_html.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test_build_html.py b/tests/test_build_html.py
index 469268444f8..b01d6f4ebd6 100644
--- a/tests/test_build_html.py
+++ b/tests/test_build_html.py
@@ -21,7 +21,7 @@
 from sphinx.builders.html import validate_html_extra_path, validate_html_static_path
 from sphinx.errors import ConfigError
 from sphinx.testing.util import strip_escseq
-from sphinx.util import md5
+from sphinx.util import docutils, md5
 from sphinx.util.inventory import InventoryFile
 
 if docutils.__version_info__ < (0, 17):

From 02016c0ef25f6a521aae789727487e0bbc71014a Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 3 Apr 2021 23:18:06 +0900
Subject: [PATCH 225/305] Close #8829: doc: Update description of
 paralle-read-safe

---
 doc/extdev/index.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/extdev/index.rst b/doc/extdev/index.rst
index ad04951f385..d9c04f413d3 100644
--- a/doc/extdev/index.rst
+++ b/doc/extdev/index.rst
@@ -171,10 +171,26 @@ as metadata of the extension.  Metadata keys currently recognized are:
   source files can be used when the extension is loaded.  It defaults to
   ``False``, i.e. you have to explicitly specify your extension to be
   parallel-read-safe after checking that it is.
+
+  .. note:: The *parallel-read-safe* extension must satisfy the following
+            conditions:
+
+            * The core logic of the extension is parallely executable during
+              the reading phase.
+            * It has event handlers for :event:`env-merge-info` and
+              :event:`env-purge-doc` events if it stores dataa to the build
+              environment object (env) during the reading phase.
+
 * ``'parallel_write_safe'``: a boolean that specifies if parallel writing of
   output files can be used when the extension is loaded.  Since extensions
   usually don't negatively influence the process, this defaults to ``True``.
 
+  .. note:: The *parallel-write-safe* extension must satisfy the following
+            conditions:
+
+            * The core logic of the extension is parallely executable during
+              the writing phase.
+
 
 APIs used for writing extensions
 --------------------------------

From f7a2e081c867e5fb125561f1a3ec26d851a0aeeb Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 4 Apr 2021 13:41:55 +0900
Subject: [PATCH 226/305] Update CHANGES for PR #9036

---
 CHANGES | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGES b/CHANGES
index 8f4a78465a2..df09f962fb5 100644
--- a/CHANGES
+++ b/CHANGES
@@ -83,6 +83,7 @@ Features added
 * #2018: html: :confval:`html_favicon` and :confval:`html_logo` now accept URL
   for the image
 * #8070: html search: Support searching for 2characters word
+* #9036: html theme: Allow to inherite the search page
 * #8938: imgconverter: Show the error of the command availability check
 * #7830: Add debug logs for change detection of sources and templates
 * #8201: Emit a warning if toctree contains duplicated entries

From 8d3708a1745c809a85003f69f9c86085b6b00e28 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 4 Apr 2021 14:28:25 +0900
Subject: [PATCH 227/305] refactor: Lazy loading is not needed for type
 annotations

---
 sphinx/util/docfields.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/sphinx/util/docfields.py b/sphinx/util/docfields.py
index 43f15f507c6..d292f589d7d 100644
--- a/sphinx/util/docfields.py
+++ b/sphinx/util/docfields.py
@@ -15,11 +15,11 @@
 from docutils.nodes import Node
 
 from sphinx import addnodes
+from sphinx.environment import BuildEnvironment
 from sphinx.util.typing import TextlikeNode
 
 if TYPE_CHECKING:
     from sphinx.directive import ObjectDescription
-    from sphinx.environment import BuildEnvironment
 
 
 def _is_single_paragraph(node: nodes.field_body) -> bool:
@@ -62,7 +62,7 @@ def __init__(self, name: str, names: Tuple[str, ...] = (), label: str = None,
 
     def make_xref(self, rolename: str, domain: str, target: str,
                   innernode: "Type[TextlikeNode]" = addnodes.literal_emphasis,
-                  contnode: Node = None, env: "BuildEnvironment" = None) -> Node:
+                  contnode: Node = None, env: BuildEnvironment = None) -> Node:
         if not rolename:
             return contnode or innernode(target, target)
         refnode = addnodes.pending_xref('', refdomain=domain, refexplicit=False,
@@ -74,14 +74,14 @@ def make_xref(self, rolename: str, domain: str, target: str,
 
     def make_xrefs(self, rolename: str, domain: str, target: str,
                    innernode: "Type[TextlikeNode]" = addnodes.literal_emphasis,
-                   contnode: Node = None, env: "BuildEnvironment" = None) -> List[Node]:
+                   contnode: Node = None, env: BuildEnvironment = None) -> List[Node]:
         return [self.make_xref(rolename, domain, target, innernode, contnode, env)]
 
     def make_entry(self, fieldarg: str, content: List[Node]) -> Tuple[str, List[Node]]:
         return (fieldarg, content)
 
     def make_field(self, types: Dict[str, List[Node]], domain: str,
-                   item: Tuple, env: "BuildEnvironment" = None) -> nodes.field:
+                   item: Tuple, env: BuildEnvironment = None) -> nodes.field:
         fieldarg, content = item
         fieldname = nodes.field_name('', self.label)
         if fieldarg:
@@ -121,7 +121,7 @@ def __init__(self, name: str, names: Tuple[str, ...] = (), label: str = None,
         self.can_collapse = can_collapse
 
     def make_field(self, types: Dict[str, List[Node]], domain: str,
-                   items: Tuple, env: "BuildEnvironment" = None) -> nodes.field:
+                   items: Tuple, env: BuildEnvironment = None) -> nodes.field:
         fieldname = nodes.field_name('', self.label)
         listnode = self.list_type()
         for fieldarg, content in items:
@@ -170,7 +170,7 @@ def __init__(self, name: str, names: Tuple[str, ...] = (), typenames: Tuple[str,
         self.typerolename = typerolename
 
     def make_field(self, types: Dict[str, List[Node]], domain: str,
-                   items: Tuple, env: "BuildEnvironment" = None) -> nodes.field:
+                   items: Tuple, env: BuildEnvironment = None) -> nodes.field:
         def handle_item(fieldarg: str, content: str) -> nodes.paragraph:
             par = nodes.paragraph()
             par.extend(self.make_xrefs(self.rolename, domain, fieldarg,

From 1b0d4672a41e91289292dd5d05b7fe09a8feec17 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 4 Apr 2021 14:37:15 +0900
Subject: [PATCH 228/305] refactor: use raw Type for type annotations

---
 sphinx/application.py                    | 34 ++++++++++----------
 sphinx/builders/__init__.py              |  2 +-
 sphinx/builders/html/__init__.py         |  2 +-
 sphinx/deprecation.py                    |  6 ++--
 sphinx/domains/std.py                    |  2 +-
 sphinx/environment/collectors/toctree.py |  2 +-
 sphinx/ext/autodoc/directive.py          |  2 +-
 sphinx/ext/autosummary/__init__.py       |  2 +-
 sphinx/ext/napoleon/docstring.py         |  2 +-
 sphinx/io.py                             |  2 +-
 sphinx/parsers.py                        |  5 ++-
 sphinx/registry.py                       | 40 ++++++++++++------------
 sphinx/roles.py                          |  2 +-
 sphinx/util/__init__.py                  |  2 +-
 sphinx/util/docfields.py                 |  4 +--
 sphinx/util/docutils.py                  | 12 +++----
 sphinx/util/inspect.py                   |  4 +--
 sphinx/util/nodes.py                     |  2 +-
 sphinx/util/osutil.py                    |  2 +-
 sphinx/util/typing.py                    |  8 ++---
 20 files changed, 68 insertions(+), 69 deletions(-)

diff --git a/sphinx/application.py b/sphinx/application.py
index 7812cecc96a..9878a3e71d6 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -443,7 +443,7 @@ def disconnect(self, listener_id: int) -> None:
         self.events.disconnect(listener_id)
 
     def emit(self, event: str, *args: Any,
-             allowed_exceptions: Tuple["Type[Exception]", ...] = ()) -> List:
+             allowed_exceptions: Tuple[Type[Exception], ...] = ()) -> List:
         """Emit *event* and pass *arguments* to the callback functions.
 
         Return the return values of all callbacks as a list.  Do not emit core
@@ -460,7 +460,7 @@ def emit(self, event: str, *args: Any,
         return self.events.emit(event, *args, allowed_exceptions=allowed_exceptions)
 
     def emit_firstresult(self, event: str, *args: Any,
-                         allowed_exceptions: Tuple["Type[Exception]", ...] = ()) -> Any:
+                         allowed_exceptions: Tuple[Type[Exception], ...] = ()) -> Any:
         """Emit *event* and pass *arguments* to the callback functions.
 
         Return the result of the first callback that doesn't return ``None``.
@@ -479,7 +479,7 @@ def emit_firstresult(self, event: str, *args: Any,
 
     # registering addon parts
 
-    def add_builder(self, builder: "Type[Builder]", override: bool = False) -> None:
+    def add_builder(self, builder: Type["Builder"], override: bool = False) -> None:
         """Register a new builder.
 
         :param builder: A builder class
@@ -542,7 +542,7 @@ def add_event(self, name: str) -> None:
         logger.debug('[app] adding event: %r', name)
         self.events.add(name)
 
-    def set_translator(self, name: str, translator_class: "Type[nodes.NodeVisitor]",
+    def set_translator(self, name: str, translator_class: Type[nodes.NodeVisitor],
                        override: bool = False) -> None:
         """Register or override a Docutils translator class.
 
@@ -561,7 +561,7 @@ def set_translator(self, name: str, translator_class: "Type[nodes.NodeVisitor]",
         """
         self.registry.add_translator(name, translator_class, override=override)
 
-    def add_node(self, node: "Type[Element]", override: bool = False,
+    def add_node(self, node: Type[Element], override: bool = False,
                  **kwargs: Tuple[Callable, Callable]) -> None:
         """Register a Docutils node class.
 
@@ -605,7 +605,7 @@ def depart_math_html(self, node):
         docutils.register_node(node)
         self.registry.add_translation_handlers(node, **kwargs)
 
-    def add_enumerable_node(self, node: "Type[Element]", figtype: str,
+    def add_enumerable_node(self, node: Type[Element], figtype: str,
                             title_getter: TitleGetter = None, override: bool = False,
                             **kwargs: Tuple[Callable, Callable]) -> None:
         """Register a Docutils node class as a numfig target.
@@ -634,7 +634,7 @@ def add_enumerable_node(self, node: "Type[Element]", figtype: str,
         self.registry.add_enumerable_node(node, figtype, title_getter, override=override)
         self.add_node(node, override=override, **kwargs)
 
-    def add_directive(self, name: str, cls: "Type[Directive]", override: bool = False) -> None:
+    def add_directive(self, name: str, cls: Type[Directive], override: bool = False) -> None:
         """Register a Docutils directive.
 
         :param name: The name of directive
@@ -724,7 +724,7 @@ def add_generic_role(self, name: str, nodeclass: Any, override: bool = False) ->
         role = roles.GenericRole(name, nodeclass)
         docutils.register_role(name, role)
 
-    def add_domain(self, domain: "Type[Domain]", override: bool = False) -> None:
+    def add_domain(self, domain: Type[Domain], override: bool = False) -> None:
         """Register a domain.
 
         :param domain: A domain class
@@ -738,7 +738,7 @@ def add_domain(self, domain: "Type[Domain]", override: bool = False) -> None:
         self.registry.add_domain(domain, override=override)
 
     def add_directive_to_domain(self, domain: str, name: str,
-                                cls: "Type[Directive]", override: bool = False) -> None:
+                                cls: Type[Directive], override: bool = False) -> None:
         """Register a Docutils directive in a domain.
 
         Like :meth:`add_directive`, but the directive is added to the domain
@@ -775,7 +775,7 @@ def add_role_to_domain(self, domain: str, name: str, role: Union[RoleFunction, X
         """
         self.registry.add_role_to_domain(domain, name, role, override=override)
 
-    def add_index_to_domain(self, domain: str, index: "Type[Index]", override: bool = False
+    def add_index_to_domain(self, domain: str, index: Type[Index], override: bool = False
                             ) -> None:
         """Register a custom index for a domain.
 
@@ -793,7 +793,7 @@ def add_index_to_domain(self, domain: str, index: "Type[Index]", override: bool
         self.registry.add_index_to_domain(domain, index)
 
     def add_object_type(self, directivename: str, rolename: str, indextemplate: str = '',
-                        parse_node: Callable = None, ref_nodeclass: "Type[TextElement]" = None,
+                        parse_node: Callable = None, ref_nodeclass: Type[TextElement] = None,
                         objname: str = '', doc_field_types: List = [], override: bool = False
                         ) -> None:
         """Register a new object type.
@@ -860,7 +860,7 @@ def add_object_type(self, directivename: str, rolename: str, indextemplate: str
                                       override=override)
 
     def add_crossref_type(self, directivename: str, rolename: str, indextemplate: str = '',
-                          ref_nodeclass: "Type[TextElement]" = None, objname: str = '',
+                          ref_nodeclass: Type[TextElement] = None, objname: str = '',
                           override: bool = False) -> None:
         """Register a new crossref object type.
 
@@ -898,7 +898,7 @@ def add_crossref_type(self, directivename: str, rolename: str, indextemplate: st
                                         indextemplate, ref_nodeclass, objname,
                                         override=override)
 
-    def add_transform(self, transform: "Type[Transform]") -> None:
+    def add_transform(self, transform: Type[Transform]) -> None:
         """Register a Docutils transform to be applied after parsing.
 
         Add the standard docutils :class:`Transform` subclass *transform* to
@@ -933,7 +933,7 @@ def add_transform(self, transform: "Type[Transform]") -> None:
         """  # NOQA
         self.registry.add_transform(transform)
 
-    def add_post_transform(self, transform: "Type[Transform]") -> None:
+    def add_post_transform(self, transform: Type[Transform]) -> None:
         """Register a Docutils transform to be applied before writing.
 
         Add the standard docutils :class:`Transform` subclass *transform* to
@@ -1113,7 +1113,7 @@ def add_autodocumenter(self, cls: Any, override: bool = False) -> None:
         self.registry.add_documenter(cls.objtype, cls)
         self.add_directive('auto' + cls.objtype, AutodocDirective, override=override)
 
-    def add_autodoc_attrgetter(self, typ: "Type", getter: Callable[[Any, str, Any], Any]
+    def add_autodoc_attrgetter(self, typ: Type, getter: Callable[[Any, str, Any], Any]
                                ) -> None:
         """Register a new ``getattr``-like function for the autodoc extension.
 
@@ -1157,7 +1157,7 @@ def add_source_suffix(self, suffix: str, filetype: str, override: bool = False)
         """
         self.registry.add_source_suffix(suffix, filetype, override=override)
 
-    def add_source_parser(self, parser: "Type[Parser]", override: bool = False) -> None:
+    def add_source_parser(self, parser: Type[Parser], override: bool = False) -> None:
         """Register a parser class.
 
         If *override* is True, the given *parser* is forcedly installed even if
@@ -1172,7 +1172,7 @@ def add_source_parser(self, parser: "Type[Parser]", override: bool = False) -> N
         """
         self.registry.add_source_parser(parser, override=override)
 
-    def add_env_collector(self, collector: "Type[EnvironmentCollector]") -> None:
+    def add_env_collector(self, collector: Type[EnvironmentCollector]) -> None:
         """Register an environment collector class.
 
         Refer to :ref:`collector-api`.
diff --git a/sphinx/builders/__init__.py b/sphinx/builders/__init__.py
index 5128b016daa..bedc65b6187 100644
--- a/sphinx/builders/__init__.py
+++ b/sphinx/builders/__init__.py
@@ -114,7 +114,7 @@ def set_environment(self, env: BuildEnvironment) -> None:
         self.env.set_versioning_method(self.versioning_method,
                                        self.versioning_compare)
 
-    def get_translator_class(self, *args: Any) -> "Type[nodes.NodeVisitor]":
+    def get_translator_class(self, *args: Any) -> Type[nodes.NodeVisitor]:
         """Return a class of translator."""
         return self.app.registry.get_translator_class(self)
 
diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 7244a3c4ed7..a78d54a1665 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -333,7 +333,7 @@ def add_js_file(self, filename: str, **kwargs: Any) -> None:
         self.script_files.append(JavaScript(filename, **kwargs))
 
     @property
-    def default_translator_class(self) -> "Type[nodes.NodeVisitor]":  # type: ignore
+    def default_translator_class(self) -> Type[nodes.NodeVisitor]:  # type: ignore
         if not html5_ready or self.config.html4_writer:
             return HTMLTranslator
         else:
diff --git a/sphinx/deprecation.py b/sphinx/deprecation.py
index aeefcc61fc0..6b0bdd1588b 100644
--- a/sphinx/deprecation.py
+++ b/sphinx/deprecation.py
@@ -30,7 +30,7 @@ class RemovedInSphinx60Warning(PendingDeprecationWarning):
 
 
 def deprecated_alias(modname: str, objects: Dict[str, object],
-                     warning: "Type[Warning]", names: Dict[str, str] = {}) -> None:
+                     warning: Type[Warning], names: Dict[str, str] = {}) -> None:
     module = import_module(modname)
     sys.modules[modname] = _ModuleWrapper(  # type: ignore
         module, modname, objects, warning, names)
@@ -39,7 +39,7 @@ def deprecated_alias(modname: str, objects: Dict[str, object],
 class _ModuleWrapper:
     def __init__(self, module: Any, modname: str,
                  objects: Dict[str, object],
-                 warning: "Type[Warning]",
+                 warning: Type[Warning],
                  names: Dict[str, str]) -> None:
         self._module = module
         self._modname = modname
@@ -67,7 +67,7 @@ def __getattr__(self, name: str) -> Any:
 class DeprecatedDict(dict):
     """A deprecated dict which warns on each access."""
 
-    def __init__(self, data: Dict, message: str, warning: "Type[Warning]") -> None:
+    def __init__(self, data: Dict, message: str, warning: Type[Warning]) -> None:
         self.message = message
         self.warning = warning
         super().__init__(data)
diff --git a/sphinx/domains/std.py b/sphinx/domains/std.py
index a21461dc3d8..5e10646f06d 100644
--- a/sphinx/domains/std.py
+++ b/sphinx/domains/std.py
@@ -1057,7 +1057,7 @@ def get_numfig_title(self, node: Node) -> str:
 
     def get_enumerable_node_type(self, node: Node) -> str:
         """Get type of enumerable nodes."""
-        def has_child(node: Element, cls: "Type") -> bool:
+        def has_child(node: Element, cls: Type) -> bool:
             return any(isinstance(child, cls) for child in node)
 
         if isinstance(node, nodes.section):
diff --git a/sphinx/environment/collectors/toctree.py b/sphinx/environment/collectors/toctree.py
index 3a724118ef5..921fc83ded0 100644
--- a/sphinx/environment/collectors/toctree.py
+++ b/sphinx/environment/collectors/toctree.py
@@ -62,7 +62,7 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
         docname = app.env.docname
         numentries = [0]  # nonlocal again...
 
-        def traverse_in_section(node: Element, cls: "Type[N]") -> List[N]:
+        def traverse_in_section(node: Element, cls: Type[N]) -> List[N]:
             """Like traverse(), but stay within the same section."""
             result: List[N] = []
             if isinstance(node, cls):
diff --git a/sphinx/ext/autodoc/directive.py b/sphinx/ext/autodoc/directive.py
index 8ed622d23e7..c58d0c41181 100644
--- a/sphinx/ext/autodoc/directive.py
+++ b/sphinx/ext/autodoc/directive.py
@@ -79,7 +79,7 @@ def reporter(self) -> Reporter:
         return self._reporter
 
 
-def process_documenter_options(documenter: "Type[Documenter]", config: Config, options: Dict
+def process_documenter_options(documenter: Type[Documenter], config: Config, options: Dict
                                ) -> Options:
     """Recognize options of Documenter from user input."""
     for name in AUTODOC_DEFAULT_OPTIONS:
diff --git a/sphinx/ext/autosummary/__init__.py b/sphinx/ext/autosummary/__init__.py
index 3cb5bc798d5..087aaa3841d 100644
--- a/sphinx/ext/autosummary/__init__.py
+++ b/sphinx/ext/autosummary/__init__.py
@@ -178,7 +178,7 @@ def __init__(self) -> None:
         super().__init__(env, None, Options(), 0, state)
 
 
-def get_documenter(app: Sphinx, obj: Any, parent: Any) -> "Type[Documenter]":
+def get_documenter(app: Sphinx, obj: Any, parent: Any) -> Type[Documenter]:
     """Get an autodoc.Documenter class suitable for documenting the given
     object.
 
diff --git a/sphinx/ext/napoleon/docstring.py b/sphinx/ext/napoleon/docstring.py
index 50c7309a510..d8cb75a5fd6 100644
--- a/sphinx/ext/napoleon/docstring.py
+++ b/sphinx/ext/napoleon/docstring.py
@@ -826,7 +826,7 @@ def _partition_field_on_colon(self, line: str) -> Tuple[str, str, str]:
                 colon,
                 "".join(after_colon).strip())
 
-    def _qualify_name(self, attr_name: str, klass: "Type") -> str:
+    def _qualify_name(self, attr_name: str, klass: Type) -> str:
         if klass and '.' not in attr_name:
             if attr_name.startswith('~'):
                 attr_name = attr_name[1:]
diff --git a/sphinx/io.py b/sphinx/io.py
index f6ab0e1ef48..4aa1ecbe9b1 100644
--- a/sphinx/io.py
+++ b/sphinx/io.py
@@ -61,7 +61,7 @@ def setup(self, app: "Sphinx") -> None:
         self._app = app      # hold application object only for compatibility
         self._env = app.env
 
-    def get_transforms(self) -> List["Type[Transform]"]:
+    def get_transforms(self) -> List[Type[Transform]]:
         transforms = super().get_transforms() + self.transforms
 
         # remove transforms which is not needed for Sphinx
diff --git a/sphinx/parsers.py b/sphinx/parsers.py
index 2ca6ef1113b..7e80e4f2225 100644
--- a/sphinx/parsers.py
+++ b/sphinx/parsers.py
@@ -16,14 +16,13 @@
 from docutils import nodes
 from docutils.parsers.rst import states
 from docutils.statemachine import StringList
+from docutils.transforms import Transform
 from docutils.transforms.universal import SmartQuotes
 
 from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.util.rst import append_epilog, prepend_prolog
 
 if TYPE_CHECKING:
-    from docutils.transforms import Transform  # NOQA
-
     from sphinx.application import Sphinx
 
 
@@ -70,7 +69,7 @@ def app(self) -> "Sphinx":
 class RSTParser(docutils.parsers.rst.Parser, Parser):
     """A reST parser for Sphinx."""
 
-    def get_transforms(self) -> List[Type["Transform"]]:
+    def get_transforms(self) -> List[Type[Transform]]:
         """Sphinx's reST parser replaces a transform class for smart-quotes by own's
 
         refs: sphinx.io.SphinxStandaloneReader
diff --git a/sphinx/registry.py b/sphinx/registry.py
index cd7a7f4a030..67e2564ff6e 100644
--- a/sphinx/registry.py
+++ b/sphinx/registry.py
@@ -122,7 +122,7 @@ def __init__(self) -> None:
         #: additional transforms; list of transforms
         self.transforms = []            # type: List[Type[Transform]]
 
-    def add_builder(self, builder: "Type[Builder]", override: bool = False) -> None:
+    def add_builder(self, builder: Type[Builder], override: bool = False) -> None:
         logger.debug('[app] adding builder: %r', builder)
         if not hasattr(builder, 'name'):
             raise ExtensionError(__('Builder class %s has no "name" attribute') % builder)
@@ -151,7 +151,7 @@ def create_builder(self, app: "Sphinx", name: str) -> Builder:
 
         return self.builders[name](app)
 
-    def add_domain(self, domain: "Type[Domain]", override: bool = False) -> None:
+    def add_domain(self, domain: Type[Domain], override: bool = False) -> None:
         logger.debug('[app] adding domain: %r', domain)
         if domain.name in self.domains and not override:
             raise ExtensionError(__('domain %s already registered') % domain.name)
@@ -174,7 +174,7 @@ def create_domains(self, env: BuildEnvironment) -> Iterator[Domain]:
             yield domain
 
     def add_directive_to_domain(self, domain: str, name: str,
-                                cls: "Type[Directive]", override: bool = False) -> None:
+                                cls: Type[Directive], override: bool = False) -> None:
         logger.debug('[app] adding directive to domain: %r', (domain, name, cls))
         if domain not in self.domains:
             raise ExtensionError(__('domain %s not yet registered') % domain)
@@ -197,7 +197,7 @@ def add_role_to_domain(self, domain: str, name: str,
                                  (name, domain))
         roles[name] = role
 
-    def add_index_to_domain(self, domain: str, index: "Type[Index]",
+    def add_index_to_domain(self, domain: str, index: Type[Index],
                             override: bool = False) -> None:
         logger.debug('[app] adding index to domain: %r', (domain, index))
         if domain not in self.domains:
@@ -209,7 +209,7 @@ def add_index_to_domain(self, domain: str, index: "Type[Index]",
         indices.append(index)
 
     def add_object_type(self, directivename: str, rolename: str, indextemplate: str = '',
-                        parse_node: Callable = None, ref_nodeclass: "Type[TextElement]" = None,
+                        parse_node: Callable = None, ref_nodeclass: Type[TextElement] = None,
                         objname: str = '', doc_field_types: List = [], override: bool = False
                         ) -> None:
         logger.debug('[app] adding object type: %r',
@@ -233,7 +233,7 @@ def add_object_type(self, directivename: str, rolename: str, indextemplate: str
         object_types[directivename] = ObjType(objname or directivename, rolename)
 
     def add_crossref_type(self, directivename: str, rolename: str, indextemplate: str = '',
-                          ref_nodeclass: "Type[TextElement]" = None, objname: str = '',
+                          ref_nodeclass: Type[TextElement] = None, objname: str = '',
                           override: bool = False) -> None:
         logger.debug('[app] adding crossref type: %r',
                      (directivename, rolename, indextemplate, ref_nodeclass, objname))
@@ -259,7 +259,7 @@ def add_source_suffix(self, suffix: str, filetype: str, override: bool = False)
         else:
             self.source_suffix[suffix] = filetype
 
-    def add_source_parser(self, parser: "Type[Parser]", override: bool = False) -> None:
+    def add_source_parser(self, parser: Type[Parser], override: bool = False) -> None:
         logger.debug('[app] adding search source_parser: %r', parser)
 
         # create a map from filetype to parser
@@ -270,13 +270,13 @@ def add_source_parser(self, parser: "Type[Parser]", override: bool = False) -> N
             else:
                 self.source_parsers[filetype] = parser
 
-    def get_source_parser(self, filetype: str) -> "Type[Parser]":
+    def get_source_parser(self, filetype: str) -> Type[Parser]:
         try:
             return self.source_parsers[filetype]
         except KeyError as exc:
             raise SphinxError(__('Source parser for %s not registered') % filetype) from exc
 
-    def get_source_parsers(self) -> Dict[str, "Type[Parser]"]:
+    def get_source_parsers(self) -> Dict[str, Type[Parser]]:
         return self.source_parsers
 
     def create_source_parser(self, app: "Sphinx", filename: str) -> Parser:
@@ -286,7 +286,7 @@ def create_source_parser(self, app: "Sphinx", filename: str) -> Parser:
             parser.set_application(app)
         return parser
 
-    def get_source_input(self, filetype: str) -> "Type[Input]":
+    def get_source_input(self, filetype: str) -> Type[Input]:
         warnings.warn('SphinxComponentRegistry.get_source_input() is deprecated.',
                       RemovedInSphinx60Warning)
 
@@ -299,14 +299,14 @@ def get_source_input(self, filetype: str) -> "Type[Input]":
             except KeyError:
                 return None
 
-    def add_translator(self, name: str, translator: "Type[nodes.NodeVisitor]",
+    def add_translator(self, name: str, translator: Type[nodes.NodeVisitor],
                        override: bool = False) -> None:
         logger.debug('[app] Change of translator for the %s builder.', name)
         if name in self.translators and not override:
             raise ExtensionError(__('Translator for %r already exists') % name)
         self.translators[name] = translator
 
-    def add_translation_handlers(self, node: "Type[Element]",
+    def add_translation_handlers(self, node: Type[Element],
                                  **kwargs: Tuple[Callable, Callable]) -> None:
         logger.debug('[app] adding translation_handlers: %r, %r', node, kwargs)
         for builder_name, handlers in kwargs.items():
@@ -320,7 +320,7 @@ def add_translation_handlers(self, node: "Type[Element]",
                        'function tuple: %r=%r') % (builder_name, handlers)
                 ) from exc
 
-    def get_translator_class(self, builder: Builder) -> "Type[nodes.NodeVisitor]":
+    def get_translator_class(self, builder: Builder) -> Type[nodes.NodeVisitor]:
         return self.translators.get(builder.name,
                                     builder.default_translator_class)
 
@@ -342,24 +342,24 @@ def create_translator(self, builder: Builder, *args: Any) -> nodes.NodeVisitor:
 
         return translator
 
-    def add_transform(self, transform: "Type[Transform]") -> None:
+    def add_transform(self, transform: Type[Transform]) -> None:
         logger.debug('[app] adding transform: %r', transform)
         self.transforms.append(transform)
 
-    def get_transforms(self) -> List["Type[Transform]"]:
+    def get_transforms(self) -> List[Type[Transform]]:
         return self.transforms
 
-    def add_post_transform(self, transform: "Type[Transform]") -> None:
+    def add_post_transform(self, transform: Type[Transform]) -> None:
         logger.debug('[app] adding post transform: %r', transform)
         self.post_transforms.append(transform)
 
-    def get_post_transforms(self) -> List["Type[Transform]"]:
+    def get_post_transforms(self) -> List[Type[Transform]]:
         return self.post_transforms
 
-    def add_documenter(self, objtype: str, documenter: "Type[Documenter]") -> None:
+    def add_documenter(self, objtype: str, documenter: Type["Documenter"]) -> None:
         self.documenters[objtype] = documenter
 
-    def add_autodoc_attrgetter(self, typ: "Type",
+    def add_autodoc_attrgetter(self, typ: Type,
                                attrgetter: Callable[[Any, str, Any], Any]) -> None:
         self.autodoc_attrgettrs[typ] = attrgetter
 
@@ -384,7 +384,7 @@ def add_latex_package(self, name: str, options: str, after_hyperref: bool = Fals
         else:
             self.latex_packages.append((name, options))
 
-    def add_enumerable_node(self, node: "Type[Node]", figtype: str,
+    def add_enumerable_node(self, node: Type[Node], figtype: str,
                             title_getter: TitleGetter = None, override: bool = False) -> None:
         logger.debug('[app] adding enumerable node: (%r, %r, %r)', node, figtype, title_getter)
         if node in self.enumerable_nodes and not override:
diff --git a/sphinx/roles.py b/sphinx/roles.py
index c3f594cbb2b..e9452a78cbb 100644
--- a/sphinx/roles.py
+++ b/sphinx/roles.py
@@ -69,7 +69,7 @@ class XRefRole(ReferenceRole):
     innernodeclass = nodes.literal      # type: Type[TextElement]
 
     def __init__(self, fix_parens: bool = False, lowercase: bool = False,
-                 nodeclass: "Type[Element]" = None, innernodeclass: "Type[TextElement]" = None,
+                 nodeclass: Type[Element] = None, innernodeclass: Type[TextElement] = None,
                  warn_dangling: bool = False) -> None:
         self.fix_parens = fix_parens
         self.lowercase = lowercase
diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index cb8669eca68..d420f4f77e2 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -510,7 +510,7 @@ def __init__(self, message: str) -> None:
     def __enter__(self) -> None:
         logger.info(bold(self.message + '... '), nonl=True)
 
-    def __exit__(self, exc_type: "Type[Exception]", exc_value: Exception, traceback: Any) -> bool:  # NOQA
+    def __exit__(self, exc_type: Type[Exception], exc_value: Exception, traceback: Any) -> bool:  # NOQA
         if isinstance(exc_value, SkipProgressMessage):
             logger.info(__('skipped'))
             if exc_value.args:
diff --git a/sphinx/util/docfields.py b/sphinx/util/docfields.py
index 43f15f507c6..1b82aa3824e 100644
--- a/sphinx/util/docfields.py
+++ b/sphinx/util/docfields.py
@@ -61,7 +61,7 @@ def __init__(self, name: str, names: Tuple[str, ...] = (), label: str = None,
         self.bodyrolename = bodyrolename
 
     def make_xref(self, rolename: str, domain: str, target: str,
-                  innernode: "Type[TextlikeNode]" = addnodes.literal_emphasis,
+                  innernode: Type[TextlikeNode] = addnodes.literal_emphasis,
                   contnode: Node = None, env: "BuildEnvironment" = None) -> Node:
         if not rolename:
             return contnode or innernode(target, target)
@@ -73,7 +73,7 @@ def make_xref(self, rolename: str, domain: str, target: str,
         return refnode
 
     def make_xrefs(self, rolename: str, domain: str, target: str,
-                   innernode: "Type[TextlikeNode]" = addnodes.literal_emphasis,
+                   innernode: Type[TextlikeNode] = addnodes.literal_emphasis,
                    contnode: Node = None, env: "BuildEnvironment" = None) -> List[Node]:
         return [self.make_xref(rolename, domain, target, innernode, contnode, env)]
 
diff --git a/sphinx/util/docutils.py b/sphinx/util/docutils.py
index a4ecdc647ab..44483bdd81b 100644
--- a/sphinx/util/docutils.py
+++ b/sphinx/util/docutils.py
@@ -67,7 +67,7 @@ def is_directive_registered(name: str) -> bool:
     return name in directives._directives  # type: ignore
 
 
-def register_directive(name: str, directive: "Type[Directive]") -> None:
+def register_directive(name: str, directive: Type[Directive]) -> None:
     """Register a directive to docutils.
 
     This modifies global state of docutils.  So it is better to use this
@@ -95,12 +95,12 @@ def unregister_role(name: str) -> None:
     roles._roles.pop(name, None)  # type: ignore
 
 
-def is_node_registered(node: "Type[Element]") -> bool:
+def is_node_registered(node: Type[Element]) -> bool:
     """Check the *node* is already registered."""
     return hasattr(nodes.GenericNodeVisitor, 'visit_' + node.__name__)
 
 
-def register_node(node: "Type[Element]") -> None:
+def register_node(node: Type[Element]) -> None:
     """Register a node to docutils.
 
     This modifies global state of some visitors.  So it is better to use this
@@ -111,7 +111,7 @@ def register_node(node: "Type[Element]") -> None:
         additional_nodes.add(node)
 
 
-def unregister_node(node: "Type[Element]") -> None:
+def unregister_node(node: Type[Element]) -> None:
     """Unregister a node from docutils.
 
     This is inverse of ``nodes._add_nodes_class_names()``.
@@ -182,7 +182,7 @@ def __init__(self, env: "BuildEnvironment") -> None:
     def __enter__(self) -> None:
         self.enable()
 
-    def __exit__(self, exc_type: "Type[Exception]", exc_value: Exception, traceback: Any) -> None:  # NOQA
+    def __exit__(self, exc_type: Type[Exception], exc_value: Exception, traceback: Any) -> None:  # NOQA
         self.disable()
 
     def enable(self) -> None:
@@ -226,7 +226,7 @@ def lookup_domain_element(self, type: str, name: str) -> Any:
 
         raise ElementLookupError
 
-    def lookup_directive(self, directive_name: str, language_module: ModuleType, document: nodes.document) -> Tuple[Optional["Type[Directive]"], List[system_message]]:  # NOQA
+    def lookup_directive(self, directive_name: str, language_module: ModuleType, document: nodes.document) -> Tuple[Optional[Type[Directive]], List[system_message]]:  # NOQA
         try:
             return self.lookup_domain_element('directive', directive_name)
         except ElementLookupError:
diff --git a/sphinx/util/inspect.py b/sphinx/util/inspect.py
index dbeb547b131..921dbc5e2f6 100644
--- a/sphinx/util/inspect.py
+++ b/sphinx/util/inspect.py
@@ -20,7 +20,7 @@
 from functools import partial, partialmethod
 from inspect import Parameter, isclass, ismethod, ismethoddescriptor, ismodule  # NOQA
 from io import StringIO
-from typing import Any, Callable, Dict, Mapping, Optional, Sequence, Tuple, cast
+from typing import Any, Callable, Dict, Mapping, Optional, Sequence, Tuple, Type, cast
 
 from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.pycode.ast import ast  # for py36-37
@@ -175,7 +175,7 @@ def getglobals(obj: Any) -> Mapping[str, Any]:
         return {}
 
 
-def getmro(obj: Any) -> Tuple["Type", ...]:
+def getmro(obj: Any) -> Tuple[Type, ...]:
     """Get __mro__ from given *obj* safely."""
     __mro__ = safe_getattr(obj, '__mro__', None)
     if isinstance(__mro__, tuple):
diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index 61d688d8efd..44eb5d30382 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -58,7 +58,7 @@ class NodeMatcher:
         # => [<reference ...>, <reference ...>, ...]
     """
 
-    def __init__(self, *node_classes: "Type[Node]", **attrs: Any) -> None:
+    def __init__(self, *node_classes: Type[Node], **attrs: Any) -> None:
         self.classes = node_classes
         self.attrs = attrs
 
diff --git a/sphinx/util/osutil.py b/sphinx/util/osutil.py
index c8ecce9e244..8e3d7afdab5 100644
--- a/sphinx/util/osutil.py
+++ b/sphinx/util/osutil.py
@@ -214,7 +214,7 @@ def close(self) -> None:
     def __enter__(self) -> "FileAvoidWrite":
         return self
 
-    def __exit__(self, exc_type: "Type[Exception]", exc_value: Exception, traceback: Any) -> bool:  # NOQA
+    def __exit__(self, exc_type: Type[Exception], exc_value: Exception, traceback: Any) -> bool:  # NOQA
         self.close()
         return True
 
diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py
index 450bc40e689..fcecb8bb133 100644
--- a/sphinx/util/typing.py
+++ b/sphinx/util/typing.py
@@ -12,7 +12,7 @@
 import typing
 from struct import Struct
 from types import TracebackType
-from typing import Any, Callable, Dict, Generator, List, Optional, Tuple, TypeVar, Union
+from typing import Any, Callable, Dict, Generator, List, Optional, Tuple, Type, TypeVar, Union
 
 from docutils import nodes
 from docutils.parsers.rst.states import Inliner
@@ -101,7 +101,7 @@ def is_system_TypeVar(typ: Any) -> bool:
     return modname == 'typing' and isinstance(typ, TypeVar)
 
 
-def restify(cls: Optional["Type"]) -> str:
+def restify(cls: Optional[Type]) -> str:
     """Convert python class to a reST reference."""
     from sphinx.util import inspect  # lazy loading
 
@@ -128,7 +128,7 @@ def restify(cls: Optional["Type"]) -> str:
             return _restify_py36(cls)
 
 
-def _restify_py37(cls: Optional["Type"]) -> str:
+def _restify_py37(cls: Optional[Type]) -> str:
     """Convert python class to a reST reference."""
     from sphinx.util import inspect  # lazy loading
 
@@ -183,7 +183,7 @@ def _restify_py37(cls: Optional["Type"]) -> str:
         return ':obj:`%s.%s`' % (cls.__module__, cls.__name__)
 
 
-def _restify_py36(cls: Optional["Type"]) -> str:
+def _restify_py36(cls: Optional[Type]) -> str:
     module = getattr(cls, '__module__', None)
     if module == 'typing':
         if getattr(cls, '_name', None):

From 2f320c1a8d2b917f95a629705445f965d248495e Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 4 Apr 2021 18:04:51 +0900
Subject: [PATCH 229/305] Update CHANGES for PR #8841

---
 CHANGES | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGES b/CHANGES
index df09f962fb5..8bea7f27dcf 100644
--- a/CHANGES
+++ b/CHANGES
@@ -72,6 +72,8 @@ Features added
   when the class has two different names; a canonical name and an alias name
 * #8539: autodoc: Add :confval:`autodoc_typehints_description_target` to control
   the behavior of ``autodoc_typehints=description``
+* #8841: autodoc: :confval:`autodoc_docstring_signature` will continue to look
+  for multiple signature lines without backslash character
 * #7549: autosummary: Enable :confval:`autosummary_generate` by default
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined

From eb68c237dddbceecb7a295642e51e4ac8a5b36c2 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 17 Jul 2020 01:01:51 +0900
Subject: [PATCH 230/305] refactor: Use PEP-526 based variable annotation

---
 sphinx/addnodes.py                 |  4 +--
 sphinx/application.py              | 18 ++++++------
 sphinx/builders/texinfo.py         | 10 +++----
 sphinx/config.py                   | 12 ++++----
 sphinx/events.py                   |  2 +-
 sphinx/ext/autosummary/__init__.py | 14 ++++-----
 sphinx/ext/autosummary/generate.py | 18 ++++++------
 sphinx/ext/doctest.py              | 14 ++++-----
 sphinx/ext/todo.py                 |  4 +--
 sphinx/ext/viewcode.py             |  2 +-
 sphinx/highlighting.py             |  8 +++---
 sphinx/io.py                       |  2 +-
 sphinx/locale/__init__.py          |  8 +++---
 sphinx/project.py                  | 23 +++++----------
 sphinx/registry.py                 | 46 +++++++++++++++---------------
 sphinx/roles.py                    | 10 +++----
 sphinx/setup_command.py            | 24 ++++++----------
 sphinx/testing/fixtures.py         |  6 ++--
 sphinx/testing/util.py             |  4 +--
 sphinx/theming.py                  |  2 +-
 20 files changed, 108 insertions(+), 123 deletions(-)

diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 9ec4898c161..5645ac91b5e 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -104,7 +104,7 @@ def apply_translated_message(self, original_message: str, translated_message: st
             self['caption'] = translated_message
 
     def extract_original_messages(self) -> List[str]:
-        messages = []  # type: List[str]
+        messages: List[str] = []
 
         # toctree entries
         messages.extend(self.get('rawentries', []))
@@ -209,7 +209,7 @@ class desc_content(nodes.General, nodes.Element):
 
 class desc_sig_element(nodes.inline):
     """Common parent class of nodes for inline text of a signature."""
-    classes = []  # type: List[str]
+    classes: List[str] = []
 
     def __init__(self, rawsource: str = '', text: str = '',
                  *children: Element, **attributes: Any) -> None:
diff --git a/sphinx/application.py b/sphinx/application.py
index 9878a3e71d6..ef77e34dbd3 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -140,12 +140,12 @@ def __init__(self, srcdir: str, confdir: Optional[str], outdir: str, doctreedir:
                  verbosity: int = 0, parallel: int = 0, keep_going: bool = False) -> None:
         self.phase = BuildPhase.INITIALIZATION
         self.verbosity = verbosity
-        self.extensions = {}                    # type: Dict[str, Extension]
-        self.builder = None                     # type: Builder
-        self.env = None                         # type: BuildEnvironment
-        self.project = None                     # type: Project
+        self.extensions: Dict[str, Extension] = {}
+        self.builder: Builder = None
+        self.env: BuildEnvironment = None
+        self.project: Project = None
         self.registry = SphinxComponentRegistry()
-        self.html_themes = {}                   # type: Dict[str, str]
+        self.html_themes: Dict[str, str] = {}
 
         # validate provided directories
         self.srcdir = abspath(srcdir)
@@ -173,14 +173,14 @@ def __init__(self, srcdir: str, confdir: Optional[str], outdir: str, doctreedir:
         self.parallel = parallel
 
         if status is None:
-            self._status = StringIO()      # type: IO
+            self._status: IO = StringIO()
             self.quiet = True
         else:
             self._status = status
             self.quiet = False
 
         if warning is None:
-            self._warning = StringIO()     # type: IO
+            self._warning: IO = StringIO()
         else:
             self._warning = warning
         self._warncount = 0
@@ -195,7 +195,7 @@ def __init__(self, srcdir: str, confdir: Optional[str], outdir: str, doctreedir:
 
         # keep last few messages for traceback
         # This will be filled by sphinx.util.logging.LastMessagesWriter
-        self.messagelog = deque(maxlen=10)  # type: deque
+        self.messagelog: deque = deque(maxlen=10)
 
         # say hello to the world
         logger.info(bold(__('Running Sphinx v%s') % sphinx.__display_version__))
@@ -292,7 +292,7 @@ def _init_i18n(self) -> None:
                 if catalog.domain == 'sphinx' and catalog.is_outdated():
                     catalog.write_mo(self.config.language)
 
-            locale_dirs = list(repo.locale_dirs)  # type: List[Optional[str]]
+            locale_dirs: List[Optional[str]] = list(repo.locale_dirs)
             locale_dirs += [None]
             locale_dirs += [path.join(package_dir, 'locale')]
 
diff --git a/sphinx/builders/texinfo.py b/sphinx/builders/texinfo.py
index 8bd211f2245..ee10d58c350 100644
--- a/sphinx/builders/texinfo.py
+++ b/sphinx/builders/texinfo.py
@@ -53,8 +53,8 @@ class TexinfoBuilder(Builder):
     default_translator_class = TexinfoTranslator
 
     def init(self) -> None:
-        self.docnames = []       # type: Iterable[str]
-        self.document_data = []  # type: List[Tuple[str, str, str, str, str, str, str, bool]]
+        self.docnames: Iterable[str] = []
+        self.document_data: List[Tuple[str, str, str, str, str, str, str, bool]] = []
 
     def get_outdated_docs(self) -> Union[str, List[str]]:
         return 'all documents'  # for now
@@ -76,7 +76,7 @@ def init_document_data(self) -> None:
                               'will be written'))
             return
         # assign subdirs to titles
-        self.titles = []  # type: List[Tuple[str, str]]
+        self.titles: List[Tuple[str, str]] = []
         for entry in preliminary_document_data:
             docname = entry[0]
             if docname not in self.env.all_docs:
@@ -109,10 +109,10 @@ def write(self, *ignored: Any) -> None:
             with progress_message(__("writing")):
                 self.post_process_images(doctree)
                 docwriter = TexinfoWriter(self)
-                settings = OptionParser(
+                settings: Any = OptionParser(
                     defaults=self.env.settings,
                     components=(docwriter,),
-                    read_config_files=True).get_default_values()  # type: Any
+                    read_config_files=True).get_default_values()
                 settings.author = author
                 settings.title = title
                 settings.texinfo_filename = targetname[:-5] + '.info'
diff --git a/sphinx/config.py b/sphinx/config.py
index d7f9c4f8a27..a9fdddc8a1f 100644
--- a/sphinx/config.py
+++ b/sphinx/config.py
@@ -14,7 +14,7 @@
 from collections import OrderedDict
 from os import getenv, path
 from typing import (TYPE_CHECKING, Any, Callable, Dict, Generator, Iterator, List, NamedTuple,
-                    Set, Tuple, Union)
+                    Optional, Set, Tuple, Union)
 
 from sphinx.errors import ConfigError, ExtensionError
 from sphinx.locale import _, __
@@ -88,7 +88,7 @@ class Config:
     # If you add a value here, don't forget to include it in the
     # quickstart.py file template as well as in the docs!
 
-    config_values = {
+    config_values: Dict[str, Tuple] = {
         # general options
         'project': ('Python', 'env', []),
         'author': ('unknown', 'env', []),
@@ -146,20 +146,20 @@ class Config:
         'smartquotes_excludes': ({'languages': ['ja'],
                                   'builders': ['man', 'text']},
                                  'env', []),
-    }  # type: Dict[str, Tuple]
+    }
 
     def __init__(self, config: Dict[str, Any] = {}, overrides: Dict[str, Any] = {}) -> None:
         self.overrides = dict(overrides)
         self.values = Config.config_values.copy()
         self._raw_config = config
-        self.setup = config.get('setup', None)  # type: Callable
+        self.setup: Optional[Callable] = config.get('setup', None)
 
         if 'extensions' in self.overrides:
             if isinstance(self.overrides['extensions'], str):
                 config['extensions'] = self.overrides.pop('extensions').split(',')
             else:
                 config['extensions'] = self.overrides.pop('extensions')
-        self.extensions = config.get('extensions', [])  # type: List[str]
+        self.extensions: List[str] = config.get('extensions', [])
 
     @classmethod
     def read(cls, confdir: str, overrides: Dict = None, tags: Tags = None) -> "Config":
@@ -311,7 +311,7 @@ def __setstate__(self, state: Dict) -> None:
 
 def eval_config_file(filename: str, tags: Tags) -> Dict[str, Any]:
     """Evaluate a config file."""
-    namespace = {}  # type: Dict[str, Any]
+    namespace: Dict[str, Any] = {}
     namespace['__file__'] = filename
     namespace['tags'] = tags
 
diff --git a/sphinx/events.py b/sphinx/events.py
index 881882b4117..634fdc6ca20 100644
--- a/sphinx/events.py
+++ b/sphinx/events.py
@@ -58,7 +58,7 @@ class EventManager:
     def __init__(self, app: "Sphinx") -> None:
         self.app = app
         self.events = core_events.copy()
-        self.listeners = defaultdict(list)  # type: Dict[str, List[EventListener]]
+        self.listeners: Dict[str, List[EventListener]] = defaultdict(list)
         self.next_listener_id = 0
 
     def add(self, name: str) -> None:
diff --git a/sphinx/ext/autosummary/__init__.py b/sphinx/ext/autosummary/__init__.py
index 087aaa3841d..c29714ad4c8 100644
--- a/sphinx/ext/autosummary/__init__.py
+++ b/sphinx/ext/autosummary/__init__.py
@@ -60,7 +60,7 @@
 import warnings
 from os import path
 from types import ModuleType
-from typing import Any, Dict, List, Tuple, Type, cast
+from typing import Any, Dict, List, Optional, Tuple, Type, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, system_message
@@ -165,7 +165,7 @@ def autosummary_table_visit_html(self: HTMLTranslator, node: autosummary_table)
 # -- autodoc integration -------------------------------------------------------
 
 # current application object (used in `get_documenter()`).
-_app = None  # type: Sphinx
+_app: Sphinx = None
 
 
 class FakeDirective(DocumenterBridge):
@@ -311,7 +311,7 @@ def get_items(self, names: List[str]) -> List[Tuple[str, str, str, str]]:
         """
         prefixes = get_import_prefixes_from_env(self.env)
 
-        items = []  # type: List[Tuple[str, str, str, str]]
+        items: List[Tuple[str, str, str, str]] = []
 
         max_item_chars = 50
 
@@ -461,8 +461,8 @@ def mangle_signature(sig: str, max_chars: int = 30) -> str:
         s = re.sub(r'{[^}]*}', '', s)
 
     # Parse the signature to arguments + options
-    args = []  # type: List[str]
-    opts = []  # type: List[str]
+    args: List[str] = []
+    opts: List[str] = []
 
     opt_re = re.compile(r"^(.*, |)([a-zA-Z0-9_*]+)\s*=\s*")
     while s:
@@ -579,7 +579,7 @@ def get_import_prefixes_from_env(env: BuildEnvironment) -> List[str]:
     Obtain current Python import prefixes (for `import_by_name`)
     from ``document.env``
     """
-    prefixes = [None]  # type: List[str]
+    prefixes: List[Optional[str]] = [None]
 
     currmodule = env.ref_context.get('py:module')
     if currmodule:
@@ -707,7 +707,7 @@ def get_supported_format(suffix: str) -> Tuple[str, ...]:
             return ('restructuredtext',)
         return parser_class.supported
 
-    suffix = None  # type: str
+    suffix: str = None
     for suffix in app.config.source_suffix:
         if 'restructuredtext' in get_supported_format(suffix):
             return suffix
diff --git a/sphinx/ext/autosummary/generate.py b/sphinx/ext/autosummary/generate.py
index 2b17ccbb967..b25d14d72f9 100644
--- a/sphinx/ext/autosummary/generate.py
+++ b/sphinx/ext/autosummary/generate.py
@@ -87,11 +87,11 @@ def setup_documenters(app: Any) -> None:
                                     FunctionDocumenter, MethodDocumenter, ModuleDocumenter,
                                     NewTypeAttributeDocumenter, NewTypeDataDocumenter,
                                     PropertyDocumenter)
-    documenters = [
+    documenters: List[Type[Documenter]] = [
         ModuleDocumenter, ClassDocumenter, ExceptionDocumenter, DataDocumenter,
         FunctionDocumenter, MethodDocumenter, NewTypeAttributeDocumenter,
         NewTypeDataDocumenter, AttributeDocumenter, DecoratorDocumenter, PropertyDocumenter,
-    ]  # type: List[Type[Documenter]]
+    ]
     for documenter in documenters:
         app.registry.add_documenter(documenter.objtype, documenter)
 
@@ -241,8 +241,8 @@ def skip_member(obj: Any, name: str, objtype: str) -> bool:
 
     def get_members(obj: Any, types: Set[str], include_public: List[str] = [],
                     imported: bool = True) -> Tuple[List[str], List[str]]:
-        items = []  # type: List[str]
-        public = []  # type: List[str]
+        items: List[str] = []
+        public: List[str] = []
         for name in dir(obj):
             try:
                 value = safe_getattr(obj, name)
@@ -282,7 +282,7 @@ def get_module_attrs(members: Any) -> Tuple[List[str], List[str]]:
         return public, attrs
 
     def get_modules(obj: Any) -> Tuple[List[str], List[str]]:
-        items = []  # type: List[str]
+        items: List[str] = []
         for _, modname, ispkg in pkgutil.iter_modules(obj.__path__):
             fullname = name + '.' + modname
             try:
@@ -296,7 +296,7 @@ def get_modules(obj: Any) -> Tuple[List[str], List[str]]:
         public = [x for x in items if not x.split('.')[-1].startswith('_')]
         return public, items
 
-    ns = {}  # type: Dict[str, Any]
+    ns: Dict[str, Any] = {}
     ns.update(context)
 
     if doc.objtype == 'module':
@@ -447,7 +447,7 @@ def find_autosummary_in_files(filenames: List[str]) -> List[AutosummaryEntry]:
 
     See `find_autosummary_in_lines`.
     """
-    documented = []  # type: List[AutosummaryEntry]
+    documented: List[AutosummaryEntry] = []
     for filename in filenames:
         with open(filename, encoding='utf-8', errors='ignore') as f:
             lines = f.read().splitlines()
@@ -501,10 +501,10 @@ def find_autosummary_in_lines(lines: List[str], module: str = None, filename: st
     toctree_arg_re = re.compile(r'^\s+:toctree:\s*(.*?)\s*$')
     template_arg_re = re.compile(r'^\s+:template:\s*(.*?)\s*$')
 
-    documented = []  # type: List[AutosummaryEntry]
+    documented: List[AutosummaryEntry] = []
 
     recursive = False
-    toctree = None  # type: str
+    toctree: str = None
     template = None
     current_module = module
     in_autosummary = False
diff --git a/sphinx/ext/doctest.py b/sphinx/ext/doctest.py
index e7ee8c67da8..242356b6119 100644
--- a/sphinx/ext/doctest.py
+++ b/sphinx/ext/doctest.py
@@ -87,7 +87,7 @@ def run(self) -> List[Node]:
                 if not test:
                     test = code
                 code = doctestopt_re.sub('', code)
-        nodetype = nodes.literal_block  # type: Type[TextElement]
+        nodetype: Type[TextElement] = nodes.literal_block
         if self.name in ('testsetup', 'testcleanup') or 'hide' in self.options:
             nodetype = nodes.comment
         if self.arguments:
@@ -202,9 +202,9 @@ class TestoutputDirective(TestDirective):
 class TestGroup:
     def __init__(self, name: str) -> None:
         self.name = name
-        self.setup = []     # type: List[TestCode]
-        self.tests = []     # type: List[List[TestCode]]
-        self.cleanup = []   # type: List[TestCode]
+        self.setup: List[TestCode] = []
+        self.tests: List[List[TestCode]] = []
+        self.cleanup: List[TestCode] = []
 
     def add_code(self, code: "TestCode", prepend: bool = False) -> None:
         if code.type == 'testsetup':
@@ -392,7 +392,7 @@ def skipped(self, node: Element) -> bool:
             return False
         else:
             condition = node['skipif']
-            context = {}  # type: Dict[str, Any]
+            context: Dict[str, Any] = {}
             if self.config.doctest_global_setup:
                 exec(self.config.doctest_global_setup, context)
             should_skip = eval(condition, context)
@@ -401,7 +401,7 @@ def skipped(self, node: Element) -> bool:
             return should_skip
 
     def test_doc(self, docname: str, doctree: Node) -> None:
-        groups = {}  # type: Dict[str, TestGroup]
+        groups: Dict[str, TestGroup] = {}
         add_to_all_groups = []
         self.setup_runner = SphinxDocTestRunner(verbose=False,
                                                 optionflags=self.opt)
@@ -482,7 +482,7 @@ def compile(self, code: str, name: str, type: str, flags: Any, dont_inherit: boo
         return compile(code, name, self.type, flags, dont_inherit)
 
     def test_group(self, group: TestGroup) -> None:
-        ns = {}  # type: Dict
+        ns: Dict = {}
 
         def run_setup_cleanup(runner: Any, testcodes: List[TestCode], what: Any) -> bool:
             examples = []
diff --git a/sphinx/ext/todo.py b/sphinx/ext/todo.py
index e7a2cb51afd..6b7c1b73b85 100644
--- a/sphinx/ext/todo.py
+++ b/sphinx/ext/todo.py
@@ -130,14 +130,14 @@ def __init__(self, app: Sphinx, doctree: nodes.document, docname: str) -> None:
         self.process(doctree, docname)
 
     def process(self, doctree: nodes.document, docname: str) -> None:
-        todos = sum(self.domain.todos.values(), [])  # type: List[todo_node]
+        todos: List[todo_node] = sum(self.domain.todos.values(), [])
         for node in doctree.traverse(todolist):
             if not self.config.todo_include_todos:
                 node.parent.remove(node)
                 continue
 
             if node.get('ids'):
-                content = [nodes.target()]  # type: List[Element]
+                content: List[Element] = [nodes.target()]
             else:
                 content = []
 
diff --git a/sphinx/ext/viewcode.py b/sphinx/ext/viewcode.py
index c98ff0c88fd..f2a42f33f82 100644
--- a/sphinx/ext/viewcode.py
+++ b/sphinx/ext/viewcode.py
@@ -111,7 +111,7 @@ def has_tag(modname: str, fullname: str, docname: str, refname: str) -> bool:
     for objnode in doctree.traverse(addnodes.desc):
         if objnode.get('domain') != 'py':
             continue
-        names = set()  # type: Set[str]
+        names: Set[str] = set()
         for signode in objnode:
             if not isinstance(signode, addnodes.desc_signature):
                 continue
diff --git a/sphinx/highlighting.py b/sphinx/highlighting.py
index ad010474e58..329561df0ca 100644
--- a/sphinx/highlighting.py
+++ b/sphinx/highlighting.py
@@ -31,8 +31,8 @@
 
 logger = logging.getLogger(__name__)
 
-lexers = {}  # type: Dict[str, Lexer]
-lexer_classes = {
+lexers: Dict[str, Lexer] = {}
+lexer_classes: Dict[str, Lexer] = {
     'none': partial(TextLexer, stripnl=False),
     'python': partial(PythonLexer, stripnl=False),
     'python3': partial(Python3Lexer, stripnl=False),
@@ -40,7 +40,7 @@
     'pycon3': partial(PythonConsoleLexer, python3=True, stripnl=False),
     'rest': partial(RstLexer, stripnl=False),
     'c': partial(CLexer, stripnl=False),
-}  # type: Dict[str, Lexer]
+}
 
 
 escape_hl_chars = {ord('\\'): '\\PYGZbs{}',
@@ -80,7 +80,7 @@ def __init__(self, dest: str = 'html', stylename: str = 'sphinx',
         self.latex_engine = latex_engine
 
         style = self.get_style(stylename)
-        self.formatter_args = {'style': style}  # type: Dict[str, Any]
+        self.formatter_args: Dict[str, Any] = {'style': style}
         if dest == 'html':
             self.formatter = self.html_formatter
         else:
diff --git a/sphinx/io.py b/sphinx/io.py
index 4aa1ecbe9b1..382d31c890c 100644
--- a/sphinx/io.py
+++ b/sphinx/io.py
@@ -46,7 +46,7 @@ class SphinxBaseReader(standalone.Reader):
     This replaces reporter by Sphinx's on generating document.
     """
 
-    transforms = []  # type: List[Type[Transform]]
+    transforms: List[Type[Transform]] = []
 
     def __init__(self, *args: Any, **kwargs: Any) -> None:
         from sphinx.application import Sphinx
diff --git a/sphinx/locale/__init__.py b/sphinx/locale/__init__.py
index 28dda2e1a43..1ce65e1e326 100644
--- a/sphinx/locale/__init__.py
+++ b/sphinx/locale/__init__.py
@@ -103,7 +103,7 @@ def __repr__(self) -> str:
             return '<%s broken>' % self.__class__.__name__
 
 
-translators = defaultdict(NullTranslations)  # type: Dict[Tuple[str, str], NullTranslations]
+translators: Dict[Tuple[str, str], NullTranslations] = defaultdict(NullTranslations)
 
 
 def init(locale_dirs: List[Optional[str]], language: Optional[str],
@@ -123,7 +123,7 @@ def init(locale_dirs: List[Optional[str]], language: Optional[str],
 
     if language and '_' in language:
         # for language having country code (like "de_AT")
-        languages = [language, language.split('_')[0]]  # type: Optional[List[str]]
+        languages: Optional[List[str]] = [language, language.split('_')[0]]
     elif language:
         languages = [language]
     else:
@@ -262,7 +262,7 @@ def gettext(message: str, *args: Any) -> str:
 }
 
 # Moved to sphinx.directives.other (will be overriden later)
-versionlabels = {}  # type: Dict[str, str]
+versionlabels: Dict[str, str] = {}
 
 # Moved to sphinx.domains.python (will be overriden later)
-pairindextypes = {}  # type: Dict[str, str]
+pairindextypes: Dict[str, str] = {}
diff --git a/sphinx/project.py b/sphinx/project.py
index 258b8d4d644..bb2314c63df 100644
--- a/sphinx/project.py
+++ b/sphinx/project.py
@@ -10,17 +10,13 @@
 
 import os
 from glob import glob
-from typing import TYPE_CHECKING
+from typing import Dict, List, Set
 
 from sphinx.locale import __
 from sphinx.util import get_matching_files, logging, path_stabilize
 from sphinx.util.matching import compile_matchers
 from sphinx.util.osutil import SEP, relpath
 
-if TYPE_CHECKING:
-    from typing import Dict, List, Set
-
-
 logger = logging.getLogger(__name__)
 EXCLUDE_PATHS = ['**/_sources', '.#*', '**/.#*', '*.lproj/**']
 
@@ -28,8 +24,7 @@
 class Project:
     """A project is source code set of Sphinx document."""
 
-    def __init__(self, srcdir, source_suffix):
-        # type: (str, Dict[str, str]) -> None
+    def __init__(self, srcdir: str, source_suffix: Dict[str, str]) -> None:
         #: Source directory.
         self.srcdir = srcdir
 
@@ -37,15 +32,13 @@ def __init__(self, srcdir, source_suffix):
         self.source_suffix = source_suffix
 
         #: The name of documents belongs to this project.
-        self.docnames = set()  # type: Set[str]
+        self.docnames: Set[str] = set()
 
-    def restore(self, other):
-        # type: (Project) -> None
+    def restore(self, other: "Project") -> None:
         """Take over a result of last build."""
         self.docnames = other.docnames
 
-    def discover(self, exclude_paths=[]):
-        # type: (List[str]) -> Set[str]
+    def discover(self, exclude_paths: List[str] = []) -> Set[str]:
         """Find all document files in the source directory and put them in
         :attr:`docnames`.
         """
@@ -67,8 +60,7 @@ def discover(self, exclude_paths=[]):
 
         return self.docnames
 
-    def path2doc(self, filename):
-        # type: (str) -> str
+    def path2doc(self, filename: str) -> str:
         """Return the docname for the filename if the file is document.
 
         *filename* should be absolute or relative to the source directory.
@@ -83,8 +75,7 @@ def path2doc(self, filename):
         # the file does not have docname
         return None
 
-    def doc2path(self, docname, basedir=True):
-        # type: (str, bool) -> str
+    def doc2path(self, docname: str, basedir: bool = True) -> str:
         """Return the filename for the document name.
 
         If *basedir* is True, return as an absolute path.
diff --git a/sphinx/registry.py b/sphinx/registry.py
index 67e2564ff6e..028188402bd 100644
--- a/sphinx/registry.py
+++ b/sphinx/registry.py
@@ -53,74 +53,74 @@
 class SphinxComponentRegistry:
     def __init__(self) -> None:
         #: special attrgetter for autodoc; class object -> attrgetter
-        self.autodoc_attrgettrs = {}    # type: Dict[Type, Callable[[Any, str, Any], Any]]
+        self.autodoc_attrgettrs: Dict[Type, Callable[[Any, str, Any], Any]] = {}
 
         #: builders; a dict of builder name -> bulider class
-        self.builders = {}              # type: Dict[str, Type[Builder]]
+        self.builders: Dict[str, Type[Builder]] = {}
 
         #: autodoc documenters; a dict of documenter name -> documenter class
-        self.documenters = {}           # type: Dict[str, Type[Documenter]]
+        self.documenters: Dict[str, Type[Documenter]] = {}
 
         #: css_files; a list of tuple of filename and attributes
-        self.css_files = []             # type: List[Tuple[str, Dict[str, Any]]]
+        self.css_files: List[Tuple[str, Dict[str, Any]]] = []
 
         #: domains; a dict of domain name -> domain class
-        self.domains = {}               # type: Dict[str, Type[Domain]]
+        self.domains: Dict[str, Type[Domain]] = {}
 
         #: additional directives for domains
         #: a dict of domain name -> dict of directive name -> directive
-        self.domain_directives = {}     # type: Dict[str, Dict[str, Any]]
+        self.domain_directives: Dict[str, Dict[str, Any]] = {}
 
         #: additional indices for domains
         #: a dict of domain name -> list of index class
-        self.domain_indices = {}        # type: Dict[str, List[Type[Index]]]
+        self.domain_indices: Dict[str, List[Type[Index]]] = {}
 
         #: additional object types for domains
         #: a dict of domain name -> dict of objtype name -> objtype
-        self.domain_object_types = {}   # type: Dict[str, Dict[str, ObjType]]
+        self.domain_object_types: Dict[str, Dict[str, ObjType]] = {}
 
         #: additional roles for domains
         #: a dict of domain name -> dict of role name -> role impl.
-        self.domain_roles = {}          # type: Dict[str, Dict[str, Union[RoleFunction, XRefRole]]]  # NOQA
+        self.domain_roles: Dict[str, Dict[str, Union[RoleFunction, XRefRole]]] = {}
 
         #: additional enumerable nodes
         #: a dict of node class -> tuple of figtype and title_getter function
-        self.enumerable_nodes = {}      # type: Dict[Type[Node], Tuple[str, TitleGetter]]
+        self.enumerable_nodes: Dict[Type[Node], Tuple[str, TitleGetter]] = {}
 
         #: HTML inline and block math renderers
         #: a dict of name -> tuple of visit function and depart function
-        self.html_inline_math_renderers = {}    # type: Dict[str, Tuple[Callable, Callable]]
-        self.html_block_math_renderers = {}     # type: Dict[str, Tuple[Callable, Callable]]
+        self.html_inline_math_renderers: Dict[str, Tuple[Callable, Callable]] = {}
+        self.html_block_math_renderers: Dict[str, Tuple[Callable, Callable]] = {}
 
         #: js_files; list of JS paths or URLs
-        self.js_files = []              # type: List[Tuple[str, Dict[str, Any]]]
+        self.js_files: List[Tuple[str, Dict[str, Any]]] = []
 
         #: LaTeX packages; list of package names and its options
-        self.latex_packages = []        # type: List[Tuple[str, str]]
+        self.latex_packages: List[Tuple[str, str]] = []
 
-        self.latex_packages_after_hyperref = []     # type: List[Tuple[str, str]]
+        self.latex_packages_after_hyperref: List[Tuple[str, str]] = []
 
         #: post transforms; list of transforms
-        self.post_transforms = []       # type: List[Type[Transform]]
+        self.post_transforms: List[Type[Transform]] = []
 
         #: source paresrs; file type -> parser class
-        self.source_parsers = {}        # type: Dict[str, Type[Parser]]
+        self.source_parsers: Dict[str, Type[Parser]] = {}
 
         #: source inputs; file type -> input class
-        self.source_inputs = {}         # type: Dict[str, Type[Input]]
+        self.source_inputs: Dict[str, Type[Input]] = {}
 
         #: source suffix: suffix -> file type
-        self.source_suffix = {}         # type: Dict[str, str]
+        self.source_suffix: Dict[str, str] = {}
 
         #: custom translators; builder name -> translator class
-        self.translators = {}           # type: Dict[str, Type[nodes.NodeVisitor]]
+        self.translators: Dict[str, Type[nodes.NodeVisitor]] = {}
 
         #: custom handlers for translators
         #: a dict of builder name -> dict of node name -> visitor and departure functions
-        self.translation_handlers = {}  # type: Dict[str, Dict[str, Tuple[Callable, Callable]]]
+        self.translation_handlers: Dict[str, Dict[str, Tuple[Callable, Callable]]] = {}
 
         #: additional transforms; list of transforms
-        self.transforms = []            # type: List[Type[Transform]]
+        self.transforms: List[Type[Transform]] = []
 
     def add_builder(self, builder: Type[Builder], override: bool = False) -> None:
         logger.debug('[app] adding builder: %r', builder)
@@ -426,7 +426,7 @@ def load_extension(self, app: "Sphinx", extname: str) -> None:
             if setup is None:
                 logger.warning(__('extension %r has no setup() function; is it really '
                                   'a Sphinx extension module?'), extname)
-                metadata = {}  # type: Dict[str, Any]
+                metadata: Dict[str, Any] = {}
             else:
                 try:
                     metadata = setup(app)
diff --git a/sphinx/roles.py b/sphinx/roles.py
index e9452a78cbb..e194db5bcf3 100644
--- a/sphinx/roles.py
+++ b/sphinx/roles.py
@@ -65,8 +65,8 @@ class XRefRole(ReferenceRole):
     * Subclassing and overwriting `process_link()` and/or `result_nodes()`.
     """
 
-    nodeclass = addnodes.pending_xref   # type: Type[Element]
-    innernodeclass = nodes.literal      # type: Type[TextElement]
+    nodeclass: Type[Element] = addnodes.pending_xref
+    innernodeclass: Type[TextElement] = nodes.literal
 
     def __init__(self, fix_parens: bool = False, lowercase: bool = False,
                  nodeclass: Type[Element] = None, innernodeclass: Type[TextElement] = None,
@@ -284,7 +284,7 @@ def run(self) -> Tuple[List[Node], List[system_message]]:
         return [node], []
 
     def parse(self, text: str) -> List[Node]:
-        result = []  # type: List[Node]
+        result: List[Node] = []
 
         stack = ['']
         for part in self.parens_re.split(text):
@@ -341,7 +341,7 @@ def run(self) -> Tuple[List[Node], List[system_message]]:
         return [nodes.abbreviation(self.rawtext, text, **options)], []
 
 
-specific_docroles = {
+specific_docroles: Dict[str, RoleFunction] = {
     # links to download references
     'download': XRefRole(nodeclass=addnodes.download_reference),
     # links to anything
@@ -354,7 +354,7 @@ def run(self) -> Tuple[List[Node], List[system_message]]:
     'file': EmphasizedLiteral(),
     'samp': EmphasizedLiteral(),
     'abbr': Abbreviation(),
-}  # type: Dict[str, RoleFunction]
+}
 
 
 def setup(app: "Sphinx") -> Dict[str, Any]:
diff --git a/sphinx/setup_command.py b/sphinx/setup_command.py
index a508c50a1c9..62c83a91149 100644
--- a/sphinx/setup_command.py
+++ b/sphinx/setup_command.py
@@ -16,7 +16,7 @@
 from distutils.cmd import Command
 from distutils.errors import DistutilsExecError
 from io import StringIO
-from typing import TYPE_CHECKING
+from typing import Any, Dict
 
 from sphinx.application import Sphinx
 from sphinx.cmd.build import handle_exception
@@ -24,9 +24,6 @@
 from sphinx.util.docutils import docutils_namespace, patch_docutils
 from sphinx.util.osutil import abspath
 
-if TYPE_CHECKING:
-    from typing import Any, Dict
-
 
 class BuildDoc(Command):
     """
@@ -91,18 +88,18 @@ class BuildDoc(Command):
     boolean_options = ['fresh-env', 'all-files', 'warning-is-error',
                        'link-index', 'nitpicky']
 
-    def initialize_options(self):
-        # type: () -> None
+    def initialize_options(self) -> None:
         self.fresh_env = self.all_files = False
         self.pdb = False
-        self.source_dir = self.build_dir = None  # type: str
+        self.source_dir: str = None
+        self.build_dir: str = None
         self.builder = 'html'
         self.warning_is_error = False
         self.project = ''
         self.version = ''
         self.release = ''
         self.today = ''
-        self.config_dir = None  # type: str
+        self.config_dir: str = None
         self.link_index = False
         self.copyright = ''
         # Link verbosity to distutils' (which uses 1 by default).
@@ -111,8 +108,7 @@ def initialize_options(self):
         self.nitpicky = False
         self.keep_going = False
 
-    def _guess_source_dir(self):
-        # type: () -> str
+    def _guess_source_dir(self) -> str:
         for guess in ('doc', 'docs'):
             if not os.path.isdir(guess):
                 continue
@@ -121,8 +117,7 @@ def _guess_source_dir(self):
                     return root
         return os.curdir
 
-    def finalize_options(self):
-        # type: () -> None
+    def finalize_options(self) -> None:
         self.ensure_string_list('builder')
 
         if self.source_dir is None:
@@ -144,15 +139,14 @@ def finalize_options(self):
             (builder, os.path.join(self.build_dir, builder))
             for builder in self.builder]
 
-    def run(self):
-        # type: () -> None
+    def run(self) -> None:
         if not color_terminal():
             nocolor()
         if not self.verbose:  # type: ignore
             status_stream = StringIO()
         else:
             status_stream = sys.stdout  # type: ignore
-        confoverrides = {}  # type: Dict[str, Any]
+        confoverrides: Dict[str, Any] = {}
         if self.project:
             confoverrides['project'] = self.project
         if self.version:
diff --git a/sphinx/testing/fixtures.py b/sphinx/testing/fixtures.py
index c284208cec9..729d9a2d75b 100644
--- a/sphinx/testing/fixtures.py
+++ b/sphinx/testing/fixtures.py
@@ -41,7 +41,7 @@ def rootdir() -> str:
 
 
 class SharedResult:
-    cache = {}  # type: Dict[str, Dict[str, str]]
+    cache: Dict[str, Dict[str, str]] = {}
 
     def store(self, key: str, app_: SphinxTestApp) -> Any:
         if key in self.cache:
@@ -77,7 +77,7 @@ def app_params(request: Any, test_params: Dict, shared_result: SharedResult,
     else:
         markers = request.node.get_marker("sphinx")
     pargs = {}
-    kwargs = {}  # type: Dict[str, Any]
+    kwargs: Dict[str, Any] = {}
 
     if markers is not None:
         # to avoid stacking positional args
@@ -190,7 +190,7 @@ def make(*args, **kwargs):
         status, warning = StringIO(), StringIO()
         kwargs.setdefault('status', status)
         kwargs.setdefault('warning', warning)
-        app_ = SphinxTestApp(*args, **kwargs)  # type: Any
+        app_: Any = SphinxTestApp(*args, **kwargs)
         apps.append(app_)
         if test_params['shared_result']:
             app_ = SphinxTestAppWrapperForSkipBuilding(app_)
diff --git a/sphinx/testing/util.py b/sphinx/testing/util.py
index 7868f4d6255..bfbb1071c5f 100644
--- a/sphinx/testing/util.py
+++ b/sphinx/testing/util.py
@@ -99,8 +99,8 @@ class SphinxTestApp(application.Sphinx):
     A subclass of :class:`Sphinx` that runs on the test root, with some
     better default values for the initialization parameters.
     """
-    _status = None  # type: StringIO
-    _warning = None  # type: StringIO
+    _status: StringIO = None
+    _warning: StringIO = None
 
     def __init__(self, buildername: str = 'html', srcdir: path = None, freshenv: bool = False,
                  confoverrides: Dict = None, status: IO = None, warning: IO = None,
diff --git a/sphinx/theming.py b/sphinx/theming.py
index bba47b3441d..b7fb652ac64 100644
--- a/sphinx/theming.py
+++ b/sphinx/theming.py
@@ -211,7 +211,7 @@ def load_external_theme(self, name: str) -> None:
 
     def find_themes(self, theme_path: str) -> Dict[str, str]:
         """Search themes from specified directory."""
-        themes = {}  # type: Dict[str, str]
+        themes: Dict[str, str] = {}
         if not path.isdir(theme_path):
             return themes
 

From d3f0de4e122aa8213f7d127f75d94311d2bed682 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 30 Apr 2020 16:02:12 +0900
Subject: [PATCH 231/305] refactor: Add Optional to type annotations

---
 sphinx/application.py              | 3 +--
 sphinx/builders/_epub_base.py      | 2 +-
 sphinx/ext/autosummary/generate.py | 2 +-
 sphinx/registry.py                 | 5 +++--
 sphinx/util/inspect.py             | 2 +-
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/sphinx/application.py b/sphinx/application.py
index 9878a3e71d6..741776fbb5b 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -526,8 +526,7 @@ def add_config_value(self, name: str, default: Any, rebuild: Union[bool, str],
            ``'env'``) to a string.  However, booleans are still accepted and
            converted internally.
         """
-        logger.debug('[app] adding config value: %r',
-                     (name, default, rebuild) + ((types,) if types else ()))
+        logger.debug('[app] adding config value: %r', (name, default, rebuild, types))
         if rebuild in (False, True):
             rebuild = 'env' if rebuild else ''
         self.config.add(name, default, rebuild, types)
diff --git a/sphinx/builders/_epub_base.py b/sphinx/builders/_epub_base.py
index 65fb1ff9a36..1030334786a 100644
--- a/sphinx/builders/_epub_base.py
+++ b/sphinx/builders/_epub_base.py
@@ -270,7 +270,7 @@ def fix_ids(self, tree: nodes.document) -> None:
         """
         def update_node_id(node: Element) -> None:
             """Update IDs of given *node*."""
-            new_ids = []
+            new_ids: List[str] = []
             for node_id in node['ids']:
                 new_id = self.fix_fragment('', node_id)
                 if new_id not in new_ids:
diff --git a/sphinx/ext/autosummary/generate.py b/sphinx/ext/autosummary/generate.py
index 2b17ccbb967..55cad705fbf 100644
--- a/sphinx/ext/autosummary/generate.py
+++ b/sphinx/ext/autosummary/generate.py
@@ -407,7 +407,7 @@ def generate_autosummary_docs(sources: List[str], output_dir: str = None,
                 logger.warning(__('[autosummary] failed to import %r: %s') % (entry.name, e))
                 continue
 
-        context = {}
+        context: Dict[str, Any] = {}
         if app:
             context.update(app.config.autosummary_context)
 
diff --git a/sphinx/registry.py b/sphinx/registry.py
index 67e2564ff6e..f10f1fac61c 100644
--- a/sphinx/registry.py
+++ b/sphinx/registry.py
@@ -12,7 +12,8 @@
 import warnings
 from importlib import import_module
 from types import MethodType
-from typing import TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Tuple, Type, Union
+from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Optional, Tuple, Type,
+                    Union)
 
 from docutils import nodes
 from docutils.io import Input
@@ -286,7 +287,7 @@ def create_source_parser(self, app: "Sphinx", filename: str) -> Parser:
             parser.set_application(app)
         return parser
 
-    def get_source_input(self, filetype: str) -> Type[Input]:
+    def get_source_input(self, filetype: str) -> Optional[Type[Input]]:
         warnings.warn('SphinxComponentRegistry.get_source_input() is deprecated.',
                       RemovedInSphinx60Warning)
 
diff --git a/sphinx/util/inspect.py b/sphinx/util/inspect.py
index 921dbc5e2f6..96f04a3d3d1 100644
--- a/sphinx/util/inspect.py
+++ b/sphinx/util/inspect.py
@@ -749,7 +749,7 @@ def getdoc(obj: Any, attrgetter: Callable = safe_getattr,
     elif doc is None and allow_inherited:
         doc = inspect.getdoc(obj)
 
-        if doc is None and cls:
+        if doc is None and cls and name:
             # inspect.getdoc() does not support some kind of inherited and decorated methods.
             # This tries to obtain the docstring from super classes.
             for basecls in getattr(cls, '__mro__', []):

From 5604f9c420c28b95c9e0e9c3a3656cb70f6ab060 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 4 Apr 2021 00:09:54 +0900
Subject: [PATCH 232/305] Fix #8870: Use title node for the caption of toctree

Since docutils-0.17, the caption node should not use for the non-figure
nodes.  Therefore, this replaces it by the title node.
---
 CHANGES                                |  2 ++
 sphinx/environment/adapters/toctree.py |  2 +-
 sphinx/writers/html.py                 |  7 ++++++-
 sphinx/writers/html5.py                |  7 ++++++-
 tests/test_environment_toctree.py      | 10 +++++-----
 tests/test_intl.py                     |  7 ++-----
 6 files changed, 22 insertions(+), 13 deletions(-)

diff --git a/CHANGES b/CHANGES
index f8bf859e119..6444c93fdbd 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,8 @@ Features added
 Bugs fixed
 ----------
 
+* #8870: The style of toctree captions has been changed with docutils-0.17
+
 Testing
 --------
 
diff --git a/sphinx/environment/adapters/toctree.py b/sphinx/environment/adapters/toctree.py
index 93555d17210..f0a37ab7fe4 100644
--- a/sphinx/environment/adapters/toctree.py
+++ b/sphinx/environment/adapters/toctree.py
@@ -237,7 +237,7 @@ def _entries_from_toctree(toctreenode: addnodes.toctree, parents: List[str],
         newnode = addnodes.compact_paragraph('', '')
         caption = toctree.attributes.get('caption')
         if caption:
-            caption_node = nodes.caption(caption, '', *[nodes.Text(caption)])
+            caption_node = nodes.title(caption, '', *[nodes.Text(caption)])
             caption_node.line = toctree.line
             caption_node.source = toctree.source
             caption_node.rawsource = toctree['rawcaption']
diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py
index d3e7e03a4e8..b3364a68e43 100644
--- a/sphinx/writers/html.py
+++ b/sphinx/writers/html.py
@@ -404,7 +404,12 @@ def depart_term(self, node: Element) -> None:
 
     # overwritten
     def visit_title(self, node: Element) -> None:
-        super().visit_title(node)
+        if isinstance(node.parent, addnodes.compact_paragraph) and node.parent.get('toctree'):
+            self.body.append(self.starttag(node, 'p', '', CLASS='caption'))
+            self.body.append('<span class="caption-text">')
+            self.context.append('</span></p>\n')
+        else:
+            super().visit_title(node)
         self.add_secnumber(node)
         self.add_fignumber(node.parent)
         if isinstance(node.parent, nodes.table):
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index 5666e4d02d1..bdaffe140dc 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -355,7 +355,12 @@ def depart_term(self, node: Element) -> None:
 
     # overwritten
     def visit_title(self, node: Element) -> None:
-        super().visit_title(node)
+        if isinstance(node.parent, addnodes.compact_paragraph) and node.parent.get('toctree'):
+            self.body.append(self.starttag(node, 'p', '', CLASS='caption'))
+            self.body.append('<span class="caption-text">')
+            self.context.append('</span></p>\n')
+        else:
+            super().visit_title(node)
         self.add_secnumber(node)
         self.add_fignumber(node.parent)
         if isinstance(node.parent, nodes.table):
diff --git a/tests/test_environment_toctree.py b/tests/test_environment_toctree.py
index 41b3f727caa..85a98b61b96 100644
--- a/tests/test_environment_toctree.py
+++ b/tests/test_environment_toctree.py
@@ -10,7 +10,7 @@
 
 import pytest
 from docutils import nodes
-from docutils.nodes import bullet_list, caption, comment, list_item, reference
+from docutils.nodes import bullet_list, comment, list_item, reference, title
 
 from sphinx import addnodes
 from sphinx.addnodes import compact_paragraph, only
@@ -211,7 +211,7 @@ def test_get_toctree_for(app):
     app.build()
     toctree = TocTree(app.env).get_toctree_for('index', app.builder, collapse=False)
     assert_node(toctree,
-                [compact_paragraph, ([caption, "Table of Contents"],
+                [compact_paragraph, ([title, "Table of Contents"],
                                      bullet_list,
                                      bullet_list,
                                      bullet_list)])
@@ -251,7 +251,7 @@ def test_get_toctree_for_collapse(app):
     app.build()
     toctree = TocTree(app.env).get_toctree_for('index', app.builder, collapse=True)
     assert_node(toctree,
-                [compact_paragraph, ([caption, "Table of Contents"],
+                [compact_paragraph, ([title, "Table of Contents"],
                                      bullet_list,
                                      bullet_list,
                                      bullet_list)])
@@ -283,7 +283,7 @@ def test_get_toctree_for_maxdepth(app):
     toctree = TocTree(app.env).get_toctree_for('index', app.builder,
                                                collapse=False, maxdepth=3)
     assert_node(toctree,
-                [compact_paragraph, ([caption, "Table of Contents"],
+                [compact_paragraph, ([title, "Table of Contents"],
                                      bullet_list,
                                      bullet_list,
                                      bullet_list)])
@@ -329,7 +329,7 @@ def test_get_toctree_for_includehidden(app):
     toctree = TocTree(app.env).get_toctree_for('index', app.builder, collapse=False,
                                                includehidden=False)
     assert_node(toctree,
-                [compact_paragraph, ([caption, "Table of Contents"],
+                [compact_paragraph, ([title, "Table of Contents"],
                                      bullet_list,
                                      bullet_list)])
 
diff --git a/tests/test_intl.py b/tests/test_intl.py
index 3a704fd7ddd..0e43870257f 100644
--- a/tests/test_intl.py
+++ b/tests/test_intl.py
@@ -622,11 +622,8 @@ def test_html_meta(app):
     assert expected_expr in result
     expected_expr = '<meta content="I18N, SPHINX, MARKUP" name="keywords" />'
     assert expected_expr in result
-    if docutils.__version_info__ < (0, 17):
-        expected_expr = '<p class="caption"><span class="caption-text">HIDDEN TOC</span></p>'
-        assert expected_expr in result
-    else:
-        expected_expr = '<p><span class="caption-text">HIDDEN TOC</span></p>'
+    expected_expr = '<p class="caption"><span class="caption-text">HIDDEN TOC</span></p>'
+    assert expected_expr in result
 
 
 @sphinx_intl

From c39f147d441bb34b2081c4179145b4acdc86f0a3 Mon Sep 17 00:00:00 2001
From: Merry Bass <79108256+merrybass@users.noreply.github.com>
Date: Fri, 9 Apr 2021 12:24:15 +0200
Subject: [PATCH 233/305] sphinx.ext.extlinks: Clarify escaping of ``%``

We use Pythons %-formatting, so literal ``%`` must be escaped as ``%%``.
Clarify this behaviour for the caption and base URL strings.
---
 doc/usage/extensions/extlinks.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/doc/usage/extensions/extlinks.rst b/doc/usage/extensions/extlinks.rst
index 08a419b6650..2ef4d6b55d6 100644
--- a/doc/usage/extensions/extlinks.rst
+++ b/doc/usage/extensions/extlinks.rst
@@ -23,7 +23,7 @@ The extension adds a config value:
 .. confval:: extlinks
 
    This config value must be a dictionary of external sites, mapping unique
-   short alias names to a base URL and a *caption*.  For example, to create an
+   short alias names to a *base URL* and a *caption*.  For example, to create an
    alias for the above mentioned issues, you would add ::
 
       extlinks = {'issue': ('https://github.com/sphinx-doc/sphinx/issues/%s',
@@ -31,7 +31,7 @@ The extension adds a config value:
 
    Now, you can use the alias name as a new role, e.g. ``:issue:`123```.  This
    then inserts a link to https://github.com/sphinx-doc/sphinx/issues/123.
-   As you can see, the target given in the role is substituted in the base URL
+   As you can see, the target given in the role is substituted in the *base URL*
    in the place of ``%s``.
 
    The link caption depends on the second item in the tuple, the *caption*:
@@ -42,6 +42,11 @@ The extension adds a config value:
      for ``%s`` -- in the above example, the link caption would be
      ``issue 123``.
 
+   To produce a literal ``%`` in either *base URL* or *caption*, use ``%%``::
+
+        extlinks = {'wikipedia': ('https://en.wikipedia.org/w/index.php?search=%s&title=Special%%3ASearch&fulltext=Search&ns0=1'
+                                'Search %s on Wikipedia')}
+
    You can also use the usual "explicit title" syntax supported by other roles
    that generate links, i.e. ``:issue:`this issue <123>```.  In this case, the
    *caption* is not relevant.

From 120daeea33e3b49ed825115a66ab4375de56e94c Mon Sep 17 00:00:00 2001
From: Merry Bass <79108256+merrybass@users.noreply.github.com>
Date: Fri, 9 Apr 2021 10:30:57 +0000
Subject: [PATCH 234/305] fixup! sphinx.ext.extlinks: Clarify escaping of ``%``

---
 doc/usage/extensions/extlinks.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/usage/extensions/extlinks.rst b/doc/usage/extensions/extlinks.rst
index 2ef4d6b55d6..221b79d99eb 100644
--- a/doc/usage/extensions/extlinks.rst
+++ b/doc/usage/extensions/extlinks.rst
@@ -44,8 +44,8 @@ The extension adds a config value:
 
    To produce a literal ``%`` in either *base URL* or *caption*, use ``%%``::
 
-        extlinks = {'wikipedia': ('https://en.wikipedia.org/w/index.php?search=%s&title=Special%%3ASearch&fulltext=Search&ns0=1'
-                                'Search %s on Wikipedia')}
+      extlinks = {'KnR': ('https://example.org/K%%26R/page/%s',
+                            '[K&R; page %s]')}
 
    You can also use the usual "explicit title" syntax supported by other roles
    that generate links, i.e. ``:issue:`this issue <123>```.  In this case, the

From ee9c7d33a140018f4c2adbd592899ab5e3ed58d5 Mon Sep 17 00:00:00 2001
From: Merry Bass <79108256+merrybass@users.noreply.github.com>
Date: Fri, 9 Apr 2021 12:24:15 +0200
Subject: [PATCH 235/305] fixup! sphinx.ext.extlinks: Allow ``%s`` in link
 caption string

The old syntax will be deprecated in 4.x and 5.x and removed in Sphinx
6.0.
---
 sphinx/ext/extlinks.py | 47 ++++++++++++++++++++++++++----------------
 1 file changed, 29 insertions(+), 18 deletions(-)

diff --git a/sphinx/ext/extlinks.py b/sphinx/ext/extlinks.py
index e846c66b8de..0af335686c4 100644
--- a/sphinx/ext/extlinks.py
+++ b/sphinx/ext/extlinks.py
@@ -19,10 +19,13 @@
 
     You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`.
 
+    Both, the url string and the caption string must escape ``%`` as ``%%``.
+
     :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
+import warnings
 from typing import Any, Dict, List, Tuple
 
 from docutils import nodes, utils
@@ -31,36 +34,44 @@
 
 import sphinx
 from sphinx.application import Sphinx
+from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.util.nodes import split_explicit_title
 from sphinx.util.typing import RoleFunction
 
 
-def make_link_role(base_url: str, caption: str) -> RoleFunction:
+def make_link_role(name: str, base_url: str, caption: str) -> RoleFunction:
+    # Check whether we have base_url and caption strings have an '%s' for
+    # expansion.  If not, fall back the the old behaviour and use the string as
+    # a prefix.
+    # Remark: It is an implementation detail that we use Pythons %-formatting.
+    # So far we only expose ``%s`` and require quoting of ``%`` using ``%%``.
+    try:
+        base_url % 'dummy'
+    except (TypeError, ValueError):
+        warnings.warn('extlinks: Sphinx-6.0 will require base URL to '
+                      'contain exactly one \'%s\' and all other \'%\' need '
+                      'to be escaped as \'%%\'.', RemovedInSphinx60Warning)
+        base_url = base_url.replace('%', '%%') + '%s'
+    if caption is not None:
+        try:
+            caption % 'dummy'
+        except (TypeError, ValueError):
+            warnings.warn('extlinks: Sphinx-6.0 will require a caption string to '
+                          'contain exactly one \'%s\' and all other \'%\' need '
+                          'to be escaped as \'%%\'.', RemovedInSphinx60Warning)
+            caption = caption.replace('%', '%%') + '%s'
+
     def role(typ: str, rawtext: str, text: str, lineno: int,
              inliner: Inliner, options: Dict = {}, content: List[str] = []
              ) -> Tuple[List[Node], List[system_message]]:
         text = utils.unescape(text)
         has_explicit_title, title, part = split_explicit_title(text)
-        try:
-            full_url = base_url % part
-        except (TypeError, ValueError):
-            inliner.reporter.warning(
-                'unable to expand %s extlink with base URL %r, please make '
-                'sure the base contains \'%%s\' exactly once'
-                % (typ, base_url), line=lineno)
-            full_url = base_url + part
+        full_url = base_url % part
         if not has_explicit_title:
             if caption is None:
                 title = full_url
             else:
-                try:
-                    title = caption % part
-                except (TypeError, ValueError):
-                    inliner.reporter.warning(
-                        'unable to expand %s extlink with caption %r, please make '
-                        'sure the caption contains \'%%s\' exactly once'
-                        % (typ, caption), line=lineno)
-                    title = caption + part
+                title = caption % part
         pnode = nodes.reference(title, title, internal=False, refuri=full_url)
         return [pnode], []
     return role
@@ -68,7 +79,7 @@ def role(typ: str, rawtext: str, text: str, lineno: int,
 
 def setup_link_roles(app: Sphinx) -> None:
     for name, (base_url, caption) in app.config.extlinks.items():
-        app.add_role(name, make_link_role(base_url, caption))
+        app.add_role(name, make_link_role(name, base_url, caption))
 
 
 def setup(app: Sphinx) -> Dict[str, Any]:

From 7327e56dff865d4766c43d46405ae827e10fd6c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Martin=20Haso=C5=88?= <martin.hason@gmail.com>
Date: Fri, 9 Apr 2021 12:44:10 +0200
Subject: [PATCH 236/305] Depart method for node is optional

---
 sphinx/application.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/application.py b/sphinx/application.py
index f61a6a5497a..c7b293828bb 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -564,7 +564,7 @@ def set_translator(self, name: str, translator_class: "Type[nodes.NodeVisitor]",
         self.registry.add_translator(name, translator_class, override=override)
 
     def add_node(self, node: "Type[Element]", override: bool = False,
-                 **kwargs: Tuple[Callable, Callable]) -> None:
+                 **kwargs: Tuple[Callable, Optional[Callable]]) -> None:
         """Register a Docutils node class.
 
         This is necessary for Docutils internals.  It may also be used in the

From 2308a2fffaa234439ebf3357c5814154caa5873b Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 01:48:18 +0900
Subject: [PATCH 237/305] test: Test with the bugfixed version of each docutils
 release

---
 tox.ini | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/tox.ini b/tox.ini
index f40abde22fe..a363e187faa 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,6 +1,6 @@
 [tox]
 minversion = 2.4.0
-envlist = docs,flake8,mypy,twine,coverage,py{36,37,38,39},du{14,15,16}
+envlist = docs,flake8,mypy,twine,coverage,py{36,37,38,39},du{14,15,16,17}
 
 [testenv]
 usedevelop = True
@@ -17,10 +17,10 @@ description =
     py{36,37,38,39}: Run unit tests against {envname}.
     du{12,13,14}: Run unit tests with the given version of docutils.
 deps =
-    du14: docutils==0.14
-    du15: docutils==0.15
-    du16: docutils==0.16
-    du17: docutils==0.17
+    du14: docutils==0.14.*
+    du15: docutils==0.15.*
+    du16: docutils==0.16.*
+    du17: docutils==0.17.*
 extras =
     test
 setenv =

From 9a7ed23e44883c384a838c44a37e4b980ca4e144 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 12:44:51 +0900
Subject: [PATCH 238/305] test: docutils-0.13 is no longer supported. Skip
 using in CI

---
 .github/workflows/main.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 3cdda918c6f..204850cce6c 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -12,13 +12,13 @@ jobs:
         include:
         - name: py36
           python: 3.6
-          docutils: du13
+          docutils: du14
         - name: py37
           python: 3.7
-          docutils: du14
+          docutils: du15
         - name: py38
           python: 3.8
-          docutils: du15
+          docutils: du16
         - name: py39
           python: 3.9
           docutils: du16

From 694664ca6ee12b06371488208c012f60357f963a Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 20:28:18 +0900
Subject: [PATCH 239/305] Bump version

---
 CHANGES            | 21 +++++++++++++++++++++
 sphinx/__init__.py |  6 +++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 5b404164405..b7cb2554a08 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,24 @@
+Release 3.5.5 (in development)
+==============================
+
+Dependencies
+------------
+
+Incompatible changes
+--------------------
+
+Deprecated
+----------
+
+Features added
+--------------
+
+Bugs fixed
+----------
+
+Testing
+--------
+
 Release 3.5.4 (released Apr 11, 2021)
 =====================================
 
diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index 179bcd24192..5a4c931e756 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -32,8 +32,8 @@
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
 
-__version__ = '3.5.4'
-__released__ = '3.5.4'  # used when Sphinx builds its own docs
+__version__ = '3.5.5+'
+__released__ = '3.5.5'  # used when Sphinx builds its own docs
 
 #: Version info for better programmatic use.
 #:
@@ -43,7 +43,7 @@
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (3, 5, 4, 'final', 0)
+version_info = (3, 5, 5, 'final', 0)
 
 package_dir = path.abspath(path.dirname(__file__))
 

From 42a1bcf2c7a177f6d337a09ef5fd90c2fad69a75 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 20:43:05 +0900
Subject: [PATCH 240/305] test: Skip test for py310-dev

---
 .github/workflows/main.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index f15538ff004..f49117e1abe 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -8,7 +8,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        name: [py36, py37, py38, py39, py310-dev]
+        name: [py36, py37, py38, py39]
         include:
         - name: py36
           python: 3.6

From d09747f225e4960636a126b98b0d4cb1c79bf288 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 21:35:47 +0900
Subject: [PATCH 241/305] doc: Add docs for napoleon_preprocess_types

---
 doc/usage/extensions/napoleon.rst | 13 ++++++++++++-
 sphinx/ext/napoleon/__init__.py   |  2 +-
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/doc/usage/extensions/napoleon.rst b/doc/usage/extensions/napoleon.rst
index 066c56e2d11..bd2bcad3fe4 100644
--- a/doc/usage/extensions/napoleon.rst
+++ b/doc/usage/extensions/napoleon.rst
@@ -301,6 +301,7 @@ sure that "sphinx.ext.napoleon" is enabled in `conf.py`::
     napoleon_use_ivar = False
     napoleon_use_param = True
     napoleon_use_rtype = True
+    napoleon_preprocess_types = False
     napoleon_type_aliases = None
     napoleon_attr_annotations = True
 
@@ -510,6 +511,16 @@ sure that "sphinx.ext.napoleon" is enabled in `conf.py`::
 
        :returns: *bool* -- True if successful, False otherwise
 
+.. confval:: napoleon_preprocess_types
+
+   True to convert the type definitions in the docstrings as references.
+   Defaults to *True*.
+
+   .. versionadded:: 3.2.1
+   .. versionchanged:: 3.5
+
+      Do preprocess the Google style docstrings also.
+
 .. confval:: napoleon_type_aliases
 
    A mapping to translate type names to other names or references. Works
@@ -570,4 +581,4 @@ sure that "sphinx.ext.napoleon" is enabled in `conf.py`::
 
    .. versionadded:: 1.8
    .. versionchanged:: 3.5
-      Support ``params_style`` and ``returns_style``
\ No newline at end of file
+      Support ``params_style`` and ``returns_style``
diff --git a/sphinx/ext/napoleon/__init__.py b/sphinx/ext/napoleon/__init__.py
index ba8f62a1833..8e513a9d015 100644
--- a/sphinx/ext/napoleon/__init__.py
+++ b/sphinx/ext/napoleon/__init__.py
@@ -240,7 +240,7 @@ def __unicode__(self):
             :returns: *bool* -- True if successful, False otherwise
 
     napoleon_preprocess_types : :obj:`bool` (Defaults to False)
-        Enable the type preprocessor for numpy style docstrings.
+        Enable the type preprocessor.
 
     napoleon_type_aliases : :obj:`dict` (Defaults to None)
         Add a mapping of strings to string, translating types in numpy

From 9238dd89acb9a66fa3b708c645d9586a1e618235 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 22:10:22 +0900
Subject: [PATCH 242/305] Revert "Merge pull request #8898 from
 merrybass/feature-extlinks-pattern"

This reverts commit cd83daa9678a8ca69741b8df4bf13a577dce3cb4, reversing
changes made to c58cea9afae92bf4f290ef60c1c9db3928cbfaae.
---
 doc/usage/extensions/extlinks.rst | 24 ++++++--------
 sphinx/ext/extlinks.py            | 52 ++++++++++---------------------
 2 files changed, 27 insertions(+), 49 deletions(-)

diff --git a/doc/usage/extensions/extlinks.rst b/doc/usage/extensions/extlinks.rst
index 221b79d99eb..e1d729f5c5b 100644
--- a/doc/usage/extensions/extlinks.rst
+++ b/doc/usage/extensions/extlinks.rst
@@ -23,33 +23,29 @@ The extension adds a config value:
 .. confval:: extlinks
 
    This config value must be a dictionary of external sites, mapping unique
-   short alias names to a *base URL* and a *caption*.  For example, to create an
+   short alias names to a base URL and a *prefix*.  For example, to create an
    alias for the above mentioned issues, you would add ::
 
       extlinks = {'issue': ('https://github.com/sphinx-doc/sphinx/issues/%s',
-                            'issue %s')}
+                            'issue ')}
 
    Now, you can use the alias name as a new role, e.g. ``:issue:`123```.  This
    then inserts a link to https://github.com/sphinx-doc/sphinx/issues/123.
-   As you can see, the target given in the role is substituted in the *base URL*
+   As you can see, the target given in the role is substituted in the base URL
    in the place of ``%s``.
 
-   The link caption depends on the second item in the tuple, the *caption*:
+   The link *caption* depends on the second item in the tuple, the *prefix*:
 
-   - If *caption* is ``None``, the link caption is the full URL.
-   - If *caption* is a string, then it must contain ``%s`` exactly once.  In
-     this case the link caption is *caption* with the partial URL substituted
-     for ``%s`` -- in the above example, the link caption would be
+   - If the prefix is ``None``, the link caption is the full URL.
+   - If the prefix is the empty string, the link caption is the partial URL
+     given in the role content (``123`` in this case.)
+   - If the prefix is a non-empty string, the link caption is the partial URL,
+     prepended by the prefix -- in the above example, the link caption would be
      ``issue 123``.
 
-   To produce a literal ``%`` in either *base URL* or *caption*, use ``%%``::
-
-      extlinks = {'KnR': ('https://example.org/K%%26R/page/%s',
-                            '[K&R; page %s]')}
-
    You can also use the usual "explicit title" syntax supported by other roles
    that generate links, i.e. ``:issue:`this issue <123>```.  In this case, the
-   *caption* is not relevant.
+   *prefix* is not relevant.
 
 .. note::
 
diff --git a/sphinx/ext/extlinks.py b/sphinx/ext/extlinks.py
index 0af335686c4..d82c0378b2e 100644
--- a/sphinx/ext/extlinks.py
+++ b/sphinx/ext/extlinks.py
@@ -7,25 +7,22 @@
 
     This adds a new config value called ``extlinks`` that is created like this::
 
-       extlinks = {'exmpl': ('https://example.invalid/%s.html', caption), ...}
+       extlinks = {'exmpl': ('https://example.invalid/%s.html', prefix), ...}
 
     Now you can use e.g. :exmpl:`foo` in your documents.  This will create a
     link to ``https://example.invalid/foo.html``.  The link caption depends on
-    the *caption* value given:
+    the *prefix* value given:
 
     - If it is ``None``, the caption will be the full URL.
-    - If it is a string, it must contain ``%s`` exactly once.  In this case the
-      caption will be *caption* with the role content substituted for ``%s``.
+    - If it is a string (empty or not), the caption will be the prefix prepended
+      to the role content.
 
     You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`.
 
-    Both, the url string and the caption string must escape ``%`` as ``%%``.
-
     :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
-import warnings
 from typing import Any, Dict, List, Tuple
 
 from docutils import nodes, utils
@@ -34,52 +31,37 @@
 
 import sphinx
 from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.util.nodes import split_explicit_title
 from sphinx.util.typing import RoleFunction
 
 
-def make_link_role(name: str, base_url: str, caption: str) -> RoleFunction:
-    # Check whether we have base_url and caption strings have an '%s' for
-    # expansion.  If not, fall back the the old behaviour and use the string as
-    # a prefix.
-    # Remark: It is an implementation detail that we use Pythons %-formatting.
-    # So far we only expose ``%s`` and require quoting of ``%`` using ``%%``.
-    try:
-        base_url % 'dummy'
-    except (TypeError, ValueError):
-        warnings.warn('extlinks: Sphinx-6.0 will require base URL to '
-                      'contain exactly one \'%s\' and all other \'%\' need '
-                      'to be escaped as \'%%\'.', RemovedInSphinx60Warning)
-        base_url = base_url.replace('%', '%%') + '%s'
-    if caption is not None:
-        try:
-            caption % 'dummy'
-        except (TypeError, ValueError):
-            warnings.warn('extlinks: Sphinx-6.0 will require a caption string to '
-                          'contain exactly one \'%s\' and all other \'%\' need '
-                          'to be escaped as \'%%\'.', RemovedInSphinx60Warning)
-            caption = caption.replace('%', '%%') + '%s'
-
+def make_link_role(base_url: str, prefix: str) -> RoleFunction:
     def role(typ: str, rawtext: str, text: str, lineno: int,
              inliner: Inliner, options: Dict = {}, content: List[str] = []
              ) -> Tuple[List[Node], List[system_message]]:
         text = utils.unescape(text)
         has_explicit_title, title, part = split_explicit_title(text)
-        full_url = base_url % part
+        try:
+            full_url = base_url % part
+        except (TypeError, ValueError):
+            inliner.reporter.warning(
+                'unable to expand %s extlink with base URL %r, please make '
+                'sure the base contains \'%%s\' exactly once'
+                % (typ, base_url), line=lineno)
+            full_url = base_url + part
         if not has_explicit_title:
-            if caption is None:
+            if prefix is None:
                 title = full_url
             else:
-                title = caption % part
+                title = prefix + part
         pnode = nodes.reference(title, title, internal=False, refuri=full_url)
         return [pnode], []
     return role
 
 
 def setup_link_roles(app: Sphinx) -> None:
-    for name, (base_url, caption) in app.config.extlinks.items():
-        app.add_role(name, make_link_role(name, base_url, caption))
+    for name, (base_url, prefix) in app.config.extlinks.items():
+        app.add_role(name, make_link_role(base_url, prefix))
 
 
 def setup(app: Sphinx) -> Dict[str, Any]:

From fb39974486ab09320f0cf45f3c0ba0175f04d7d6 Mon Sep 17 00:00:00 2001
From: Merry Bass <79108256+merrybass@users.noreply.github.com>
Date: Mon, 15 Feb 2021 18:59:35 +0000
Subject: [PATCH 243/305] sphinx.ext.extlinks: Allow ``%s`` in link caption
 string

Tweak syntax of extlinks to also allow ``%s`` in the link caption part.
Like for the base URL ``%s`` will be substituted with the content of the
role.  This allows configurations like

    extlinks = {'quarter': ('https://example.org/quaters/%s',
                          '%s. quarter')}

with ``:quarter:`2``` getting replaced by a link titled `2. quarter`.

The requirement for the caption string is to be either None or contain
exactly one ``%s``.  If neither is the case, then we emit a warning and
fall back to the old behaviour which is concatenating the caption string
with the role content.
---
 doc/usage/extensions/extlinks.rst | 17 ++++++++---------
 sphinx/ext/extlinks.py            | 25 ++++++++++++++++---------
 2 files changed, 24 insertions(+), 18 deletions(-)

diff --git a/doc/usage/extensions/extlinks.rst b/doc/usage/extensions/extlinks.rst
index e1d729f5c5b..08a419b6650 100644
--- a/doc/usage/extensions/extlinks.rst
+++ b/doc/usage/extensions/extlinks.rst
@@ -23,29 +23,28 @@ The extension adds a config value:
 .. confval:: extlinks
 
    This config value must be a dictionary of external sites, mapping unique
-   short alias names to a base URL and a *prefix*.  For example, to create an
+   short alias names to a base URL and a *caption*.  For example, to create an
    alias for the above mentioned issues, you would add ::
 
       extlinks = {'issue': ('https://github.com/sphinx-doc/sphinx/issues/%s',
-                            'issue ')}
+                            'issue %s')}
 
    Now, you can use the alias name as a new role, e.g. ``:issue:`123```.  This
    then inserts a link to https://github.com/sphinx-doc/sphinx/issues/123.
    As you can see, the target given in the role is substituted in the base URL
    in the place of ``%s``.
 
-   The link *caption* depends on the second item in the tuple, the *prefix*:
+   The link caption depends on the second item in the tuple, the *caption*:
 
-   - If the prefix is ``None``, the link caption is the full URL.
-   - If the prefix is the empty string, the link caption is the partial URL
-     given in the role content (``123`` in this case.)
-   - If the prefix is a non-empty string, the link caption is the partial URL,
-     prepended by the prefix -- in the above example, the link caption would be
+   - If *caption* is ``None``, the link caption is the full URL.
+   - If *caption* is a string, then it must contain ``%s`` exactly once.  In
+     this case the link caption is *caption* with the partial URL substituted
+     for ``%s`` -- in the above example, the link caption would be
      ``issue 123``.
 
    You can also use the usual "explicit title" syntax supported by other roles
    that generate links, i.e. ``:issue:`this issue <123>```.  In this case, the
-   *prefix* is not relevant.
+   *caption* is not relevant.
 
 .. note::
 
diff --git a/sphinx/ext/extlinks.py b/sphinx/ext/extlinks.py
index d82c0378b2e..e846c66b8de 100644
--- a/sphinx/ext/extlinks.py
+++ b/sphinx/ext/extlinks.py
@@ -7,15 +7,15 @@
 
     This adds a new config value called ``extlinks`` that is created like this::
 
-       extlinks = {'exmpl': ('https://example.invalid/%s.html', prefix), ...}
+       extlinks = {'exmpl': ('https://example.invalid/%s.html', caption), ...}
 
     Now you can use e.g. :exmpl:`foo` in your documents.  This will create a
     link to ``https://example.invalid/foo.html``.  The link caption depends on
-    the *prefix* value given:
+    the *caption* value given:
 
     - If it is ``None``, the caption will be the full URL.
-    - If it is a string (empty or not), the caption will be the prefix prepended
-      to the role content.
+    - If it is a string, it must contain ``%s`` exactly once.  In this case the
+      caption will be *caption* with the role content substituted for ``%s``.
 
     You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`.
 
@@ -35,7 +35,7 @@
 from sphinx.util.typing import RoleFunction
 
 
-def make_link_role(base_url: str, prefix: str) -> RoleFunction:
+def make_link_role(base_url: str, caption: str) -> RoleFunction:
     def role(typ: str, rawtext: str, text: str, lineno: int,
              inliner: Inliner, options: Dict = {}, content: List[str] = []
              ) -> Tuple[List[Node], List[system_message]]:
@@ -50,18 +50,25 @@ def role(typ: str, rawtext: str, text: str, lineno: int,
                 % (typ, base_url), line=lineno)
             full_url = base_url + part
         if not has_explicit_title:
-            if prefix is None:
+            if caption is None:
                 title = full_url
             else:
-                title = prefix + part
+                try:
+                    title = caption % part
+                except (TypeError, ValueError):
+                    inliner.reporter.warning(
+                        'unable to expand %s extlink with caption %r, please make '
+                        'sure the caption contains \'%%s\' exactly once'
+                        % (typ, caption), line=lineno)
+                    title = caption + part
         pnode = nodes.reference(title, title, internal=False, refuri=full_url)
         return [pnode], []
     return role
 
 
 def setup_link_roles(app: Sphinx) -> None:
-    for name, (base_url, prefix) in app.config.extlinks.items():
-        app.add_role(name, make_link_role(base_url, prefix))
+    for name, (base_url, caption) in app.config.extlinks.items():
+        app.add_role(name, make_link_role(base_url, caption))
 
 
 def setup(app: Sphinx) -> Dict[str, Any]:

From ef1747f03a4a355052f6fc12fc8a5174c483a7c3 Mon Sep 17 00:00:00 2001
From: Merry Bass <79108256+merrybass@users.noreply.github.com>
Date: Fri, 9 Apr 2021 12:24:15 +0200
Subject: [PATCH 244/305] sphinx.ext.extlinks: Clarify escaping of ``%``

We use Pythons %-formatting, so literal ``%`` must be escaped as ``%%``.
Clarify this behaviour for the caption and base URL strings.
---
 doc/usage/extensions/extlinks.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/doc/usage/extensions/extlinks.rst b/doc/usage/extensions/extlinks.rst
index 08a419b6650..2ef4d6b55d6 100644
--- a/doc/usage/extensions/extlinks.rst
+++ b/doc/usage/extensions/extlinks.rst
@@ -23,7 +23,7 @@ The extension adds a config value:
 .. confval:: extlinks
 
    This config value must be a dictionary of external sites, mapping unique
-   short alias names to a base URL and a *caption*.  For example, to create an
+   short alias names to a *base URL* and a *caption*.  For example, to create an
    alias for the above mentioned issues, you would add ::
 
       extlinks = {'issue': ('https://github.com/sphinx-doc/sphinx/issues/%s',
@@ -31,7 +31,7 @@ The extension adds a config value:
 
    Now, you can use the alias name as a new role, e.g. ``:issue:`123```.  This
    then inserts a link to https://github.com/sphinx-doc/sphinx/issues/123.
-   As you can see, the target given in the role is substituted in the base URL
+   As you can see, the target given in the role is substituted in the *base URL*
    in the place of ``%s``.
 
    The link caption depends on the second item in the tuple, the *caption*:
@@ -42,6 +42,11 @@ The extension adds a config value:
      for ``%s`` -- in the above example, the link caption would be
      ``issue 123``.
 
+   To produce a literal ``%`` in either *base URL* or *caption*, use ``%%``::
+
+        extlinks = {'wikipedia': ('https://en.wikipedia.org/w/index.php?search=%s&title=Special%%3ASearch&fulltext=Search&ns0=1'
+                                'Search %s on Wikipedia')}
+
    You can also use the usual "explicit title" syntax supported by other roles
    that generate links, i.e. ``:issue:`this issue <123>```.  In this case, the
    *caption* is not relevant.

From 75605d437f0eb994d961ee07ce09e2d6716ce078 Mon Sep 17 00:00:00 2001
From: Merry Bass <79108256+merrybass@users.noreply.github.com>
Date: Fri, 9 Apr 2021 10:30:57 +0000
Subject: [PATCH 245/305] fixup! sphinx.ext.extlinks: Clarify escaping of ``%``

---
 doc/usage/extensions/extlinks.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/usage/extensions/extlinks.rst b/doc/usage/extensions/extlinks.rst
index 2ef4d6b55d6..221b79d99eb 100644
--- a/doc/usage/extensions/extlinks.rst
+++ b/doc/usage/extensions/extlinks.rst
@@ -44,8 +44,8 @@ The extension adds a config value:
 
    To produce a literal ``%`` in either *base URL* or *caption*, use ``%%``::
 
-        extlinks = {'wikipedia': ('https://en.wikipedia.org/w/index.php?search=%s&title=Special%%3ASearch&fulltext=Search&ns0=1'
-                                'Search %s on Wikipedia')}
+      extlinks = {'KnR': ('https://example.org/K%%26R/page/%s',
+                            '[K&R; page %s]')}
 
    You can also use the usual "explicit title" syntax supported by other roles
    that generate links, i.e. ``:issue:`this issue <123>```.  In this case, the

From 93cf1a57d916a1ff96c8e8a0356d0256e40489ac Mon Sep 17 00:00:00 2001
From: Merry Bass <79108256+merrybass@users.noreply.github.com>
Date: Fri, 9 Apr 2021 12:24:15 +0200
Subject: [PATCH 246/305] fixup! sphinx.ext.extlinks: Allow ``%s`` in link
 caption string

The old syntax will be deprecated in 4.x and 5.x and removed in Sphinx
6.0.
---
 sphinx/ext/extlinks.py | 47 ++++++++++++++++++++++++++----------------
 1 file changed, 29 insertions(+), 18 deletions(-)

diff --git a/sphinx/ext/extlinks.py b/sphinx/ext/extlinks.py
index e846c66b8de..0af335686c4 100644
--- a/sphinx/ext/extlinks.py
+++ b/sphinx/ext/extlinks.py
@@ -19,10 +19,13 @@
 
     You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`.
 
+    Both, the url string and the caption string must escape ``%`` as ``%%``.
+
     :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
+import warnings
 from typing import Any, Dict, List, Tuple
 
 from docutils import nodes, utils
@@ -31,36 +34,44 @@
 
 import sphinx
 from sphinx.application import Sphinx
+from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.util.nodes import split_explicit_title
 from sphinx.util.typing import RoleFunction
 
 
-def make_link_role(base_url: str, caption: str) -> RoleFunction:
+def make_link_role(name: str, base_url: str, caption: str) -> RoleFunction:
+    # Check whether we have base_url and caption strings have an '%s' for
+    # expansion.  If not, fall back the the old behaviour and use the string as
+    # a prefix.
+    # Remark: It is an implementation detail that we use Pythons %-formatting.
+    # So far we only expose ``%s`` and require quoting of ``%`` using ``%%``.
+    try:
+        base_url % 'dummy'
+    except (TypeError, ValueError):
+        warnings.warn('extlinks: Sphinx-6.0 will require base URL to '
+                      'contain exactly one \'%s\' and all other \'%\' need '
+                      'to be escaped as \'%%\'.', RemovedInSphinx60Warning)
+        base_url = base_url.replace('%', '%%') + '%s'
+    if caption is not None:
+        try:
+            caption % 'dummy'
+        except (TypeError, ValueError):
+            warnings.warn('extlinks: Sphinx-6.0 will require a caption string to '
+                          'contain exactly one \'%s\' and all other \'%\' need '
+                          'to be escaped as \'%%\'.', RemovedInSphinx60Warning)
+            caption = caption.replace('%', '%%') + '%s'
+
     def role(typ: str, rawtext: str, text: str, lineno: int,
              inliner: Inliner, options: Dict = {}, content: List[str] = []
              ) -> Tuple[List[Node], List[system_message]]:
         text = utils.unescape(text)
         has_explicit_title, title, part = split_explicit_title(text)
-        try:
-            full_url = base_url % part
-        except (TypeError, ValueError):
-            inliner.reporter.warning(
-                'unable to expand %s extlink with base URL %r, please make '
-                'sure the base contains \'%%s\' exactly once'
-                % (typ, base_url), line=lineno)
-            full_url = base_url + part
+        full_url = base_url % part
         if not has_explicit_title:
             if caption is None:
                 title = full_url
             else:
-                try:
-                    title = caption % part
-                except (TypeError, ValueError):
-                    inliner.reporter.warning(
-                        'unable to expand %s extlink with caption %r, please make '
-                        'sure the caption contains \'%%s\' exactly once'
-                        % (typ, caption), line=lineno)
-                    title = caption + part
+                title = caption % part
         pnode = nodes.reference(title, title, internal=False, refuri=full_url)
         return [pnode], []
     return role
@@ -68,7 +79,7 @@ def role(typ: str, rawtext: str, text: str, lineno: int,
 
 def setup_link_roles(app: Sphinx) -> None:
     for name, (base_url, caption) in app.config.extlinks.items():
-        app.add_role(name, make_link_role(base_url, caption))
+        app.add_role(name, make_link_role(name, base_url, caption))
 
 
 def setup(app: Sphinx) -> Dict[str, Any]:

From 04565936a974913861dbf60406895dfda2e51a2d Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 22:18:01 +0900
Subject: [PATCH 247/305] Update CHANGES for PR #8898

---
 CHANGES | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGES b/CHANGES
index 87fc4e889ee..253c89452cb 100644
--- a/CHANGES
+++ b/CHANGES
@@ -13,6 +13,7 @@ Incompatible changes
 
 * #8539: autodoc: info-field-list is generated into the class description when
   ``autodoc_typehints='description'`` and ``autoclass_content='class'`` set
+* #8898: extlinks: "%s" becomes required keyword in the link caption string
 * domain: The ``Index`` class becomes subclasses of ``abc.ABC`` to indicate
   methods that must be overrided in the concrete classes
 * #4826: py domain: The structure of python objects is changed.  A boolean value
@@ -75,6 +76,7 @@ Features added
 * #8841: autodoc: :confval:`autodoc_docstring_signature` will continue to look
   for multiple signature lines without backslash character
 * #7549: autosummary: Enable :confval:`autosummary_generate` by default
+* #8898: extlinks: Allow %s in link caption string
 * #4826: py domain: Add ``:canonical:`` option to python directives to describe
   the location where the object is defined
 * #7199: py domain: Add :confval:`python_use_unqualified_type_names` to suppress

From d59e96c8b4df3672e9213253b30724eb3157dfdf Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 22:25:48 +0900
Subject: [PATCH 248/305] docs: Add versionchanged tag to extlinks (refs:
 #8898)

---
 doc/usage/extensions/extlinks.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/usage/extensions/extlinks.rst b/doc/usage/extensions/extlinks.rst
index 221b79d99eb..c345a7c8206 100644
--- a/doc/usage/extensions/extlinks.rst
+++ b/doc/usage/extensions/extlinks.rst
@@ -51,6 +51,10 @@ The extension adds a config value:
    that generate links, i.e. ``:issue:`this issue <123>```.  In this case, the
    *caption* is not relevant.
 
+   .. versionchanged:: 4.0
+
+      Support to substitute by '%s' in the caption.
+
 .. note::
 
    Since links are generated from the role in the reading stage, they appear as

From 4a328f41a518c098ad80140f4a9e83c0b731ad02 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 12 Apr 2021 00:29:49 +0900
Subject: [PATCH 249/305] Bump to 4.0.0 beta1

---
 CHANGES                  |    7 +-
 sphinx/__init__.py       |    6 +-
 sphinx/locale/sphinx.pot | 1785 ++++++++++++++++++++------------------
 3 files changed, 965 insertions(+), 833 deletions(-)

diff --git a/CHANGES b/CHANGES
index 253c89452cb..f41c628d7a9 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,5 +1,5 @@
-Release 4.0.0 (in development)
-==============================
+Release 4.0.0 beta1 (released Apr 12, 2021)
+===========================================
 
 Dependencies
 ------------
@@ -133,9 +133,6 @@ Bugs fixed
   (function) declarators, and in the argument to ``sizeof...``.
 * C, fix linking of names in array declarators.
 
-Testing
---------
-
 Release 3.5.5 (in development)
 ==============================
 
diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index c44e7db134c..5e7b790cde4 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -27,8 +27,8 @@
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
 
-__version__ = '4.0.0+'
-__released__ = '4.0.0'  # used when Sphinx builds its own docs
+__version__ = '4.0.0b1'
+__released__ = '4.0.0b1'  # used when Sphinx builds its own docs
 
 #: Version info for better programmatic use.
 #:
@@ -38,7 +38,7 @@
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (4, 0, 0, 'beta', 0)
+version_info = (4, 0, 0, 'beta', 1)
 
 package_dir = path.abspath(path.dirname(__file__))
 
diff --git a/sphinx/locale/sphinx.pot b/sphinx/locale/sphinx.pot
index 4c47a9fb9d5..3f14d5d30d8 100644
--- a/sphinx/locale/sphinx.pot
+++ b/sphinx/locale/sphinx.pot
@@ -1,146 +1,151 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-# FIRST AUTHOR <EMAIL@ADDRESS>, 2020.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2021.
 #
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Sphinx 3.0.0\n"
+"Project-Id-Version: Sphinx 4.0.0\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and"
-" above.  For more details, please read https://github.com/sphinx-"
+" above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with"
 " this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -148,12 +153,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -161,60 +166,60 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called "
 "sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,59 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but "
 "`{current}` is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this "
-"can lead to Unicode errors occurring. Please use Unicode strings, e.g. "
-"%r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,404 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it"
 " should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. "
-"Please install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since "
+"Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,166 +711,170 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid ""
 "conf value \"epub_language\" (or \"language\") should not be empty for "
 "EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid ""
 "conf value \"epub_title\" (or \"html_title\") should not be empty for "
 "EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid ""
 "conf value \"epub_copyright\" (or \"copyright\")should not be empty for "
 "EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -857,18 +884,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -883,290 +910,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the"
 " index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all"
 " config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue "
 "to the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1189,242 +1228,236 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\""
 " will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you "
@@ -1432,11 +1465,11 @@ msgid ""
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; "
 "\"_templates\"\n"
@@ -1446,23 +1479,23 @@ msgid ""
 "underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1471,15 +1504,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1490,21 +1523,21 @@ msgid ""
 "language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
-"or \".rst\".  Only files with this suffix are considered documents."
+"or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1512,36 +1545,36 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root "
 "path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has"
 " been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that "
 "you\n"
@@ -1549,29 +1582,29 @@ msgid ""
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other "
@@ -1579,26 +1612,26 @@ msgid ""
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1609,788 +1642,777 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid ""
 "\"quiet\" is specified, but any of \"project\" or \"author\" is not "
 "specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a "
 "new root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try "
 "giving an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path"
+" as a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex:"
-" for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: "
 "for one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\","
 " \"--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose"
 " another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no "
 "link will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and "
@@ -2405,164 +2427,184 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid "====================== slowest reading durations ======================="
 msgstr ""
 
@@ -2575,11 +2617,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2589,14 +2631,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2606,29 +2648,29 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid "convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2641,141 +2683,151 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the "
 "imgmath_%s setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception"
@@ -2783,7 +2835,7 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2791,83 +2843,134 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
-msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute"
-" %s"
+msgid "missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of "
+"\"alphabetic\". Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does "
 "not contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following "
@@ -2875,22 +2978,22 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2907,107 +3010,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3024,124 +3151,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3150,55 +3277,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words "
 "are spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3230,19 +3357,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3254,12 +3381,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3272,7 +3399,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3290,197 +3417,205 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated:"
 " {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a"
+" bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to "
 "output it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed "
-"in Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""

From d0d06923ebca84d5aa8afde1f93d0881c4ef7aab Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 12 Apr 2021 00:30:49 +0900
Subject: [PATCH 250/305] Bump version

---
 CHANGES            | 21 +++++++++++++++++++++
 sphinx/__init__.py |  6 +++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index f41c628d7a9..2743788ac54 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,24 @@
+Release 4.0.0 beta2 (in development)
+====================================
+
+Dependencies
+------------
+
+Incompatible changes
+--------------------
+
+Deprecated
+----------
+
+Features added
+--------------
+
+Bugs fixed
+----------
+
+Testing
+--------
+
 Release 4.0.0 beta1 (released Apr 12, 2021)
 ===========================================
 
diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index 5e7b790cde4..8f1bd963cce 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -27,8 +27,8 @@
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
 
-__version__ = '4.0.0b1'
-__released__ = '4.0.0b1'  # used when Sphinx builds its own docs
+__version__ = '4.0.0+'
+__released__ = '4.0.0'  # used when Sphinx builds its own docs
 
 #: Version info for better programmatic use.
 #:
@@ -38,7 +38,7 @@
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (4, 0, 0, 'beta', 1)
+version_info = (4, 0, 0, 'beta', 2)
 
 package_dir = path.abspath(path.dirname(__file__))
 

From 14f7d243bd9509d0dab9cace0d9a18fe34b58b92 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Tue, 16 Mar 2021 20:02:26 +0100
Subject: [PATCH 251/305] Decl styling, more nodes and C++ conversion

---
 sphinx/addnodes.py                            |  67 ++-
 sphinx/domains/cpp.py                         | 495 +++++++++++-------
 sphinx/themes/basic/static/basic.css_t        |  42 +-
 sphinx/transforms/post_transforms/__init__.py |   6 +-
 tests/test_domain_cpp.py                      |   4 +
 tests/test_ext_intersphinx.py                 |   4 +-
 6 files changed, 381 insertions(+), 237 deletions(-)

diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 5645ac91b5e..3200e5e4718 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -154,6 +154,10 @@ class desc_signature_line(nodes.Part, nodes.Inline, nodes.FixedTextElement):
 
 # nodes to use within a desc_signature or desc_signature_line
 
+class desc_name(nodes.Part, nodes.Inline, nodes.FixedTextElement):
+    """Node for the main object name."""
+
+
 class desc_addname(nodes.Part, nodes.Inline, nodes.FixedTextElement):
     """Node for additional name parts (module name, class name)."""
 
@@ -168,14 +172,11 @@ class desc_type(nodes.Part, nodes.Inline, nodes.FixedTextElement):
 
 class desc_returns(desc_type):
     """Node for a "returns" annotation (a la -> in Python)."""
+
     def astext(self) -> str:
         return ' -> ' + super().astext()
 
 
-class desc_name(nodes.Part, nodes.Inline, nodes.FixedTextElement):
-    """Node for the main object name."""
-
-
 class desc_parameterlist(nodes.Part, nodes.Inline, nodes.FixedTextElement):
     """Node for a general parameter list."""
     child_text_separator = ', '
@@ -207,6 +208,10 @@ class desc_content(nodes.General, nodes.Element):
     """
 
 
+# Signature text elements, generally translated to node.inline
+# in SigElementFallbackTransform.
+# When adding a new one, add it to SIG_ELEMENTS.
+
 class desc_sig_element(nodes.inline):
     """Common parent class of nodes for inline text of a signature."""
     classes: List[str] = []
@@ -217,8 +222,19 @@ def __init__(self, rawsource: str = '', text: str = '',
         self['classes'].extend(self.classes)
 
 
+# to not reinvent the wheel, the classes in the following desc_sig classes
+# are based on those used in Pygments
+
+class desc_sig_space(desc_sig_element):
+    """Node for a space in a signature."""
+    classes = ["w"]
+
+    def __init__(self) -> None:
+        super().__init__(' ', ' ')
+
+
 class desc_sig_name(desc_sig_element):
-    """Node for a name in a signature."""
+    """Node for an identifier in a signature."""
     classes = ["n"]
 
 
@@ -228,10 +244,43 @@ class desc_sig_operator(desc_sig_element):
 
 
 class desc_sig_punctuation(desc_sig_element):
-    """Node for a punctuation in a signature."""
+    """Node for punctuation in a signature."""
     classes = ["p"]
 
 
+class desc_sig_keyword(desc_sig_element):
+    """Node for a general keyword in a signature."""
+    classes = ["k"]
+
+
+class desc_sig_keyword_type(desc_sig_element):
+    """Node for a keyword which is a built-in type in a signature."""
+    classes = ["kt"]
+
+
+class desc_sig_literal_number(desc_sig_element):
+    """Node for a numeric literal in a signature."""
+    classes = ["m"]
+
+
+class desc_sig_literal_string(desc_sig_element):
+    """Node for a string literal in a signature."""
+    classes = ["s"]
+
+
+class desc_sig_literal_char(desc_sig_element):
+    """Node for a character literal in a signature."""
+    classes = ["sc"]
+
+
+SIG_ELEMENTS = [desc_sig_space,
+                desc_sig_name,
+                desc_sig_operator,
+                desc_sig_punctuation,
+                desc_sig_keyword, desc_sig_keyword_type,
+                desc_sig_literal_number, desc_sig_literal_string, desc_sig_literal_char]
+
+
 # new admonition-like constructs
 
 class versionmodified(nodes.Admonition, nodes.TextElement):
@@ -336,6 +385,7 @@ class pending_xref(nodes.Inline, nodes.Element):
     These nodes are resolved before writing output, in
     BuildEnvironment.resolve_references.
     """
+    child_text_separator = ''
 
 
 class pending_xref_condition(nodes.Inline, nodes.TextElement):
@@ -424,9 +474,8 @@ def setup(app: "Sphinx") -> Dict[str, Any]:
     app.add_node(desc_optional)
     app.add_node(desc_annotation)
     app.add_node(desc_content)
-    app.add_node(desc_sig_name)
-    app.add_node(desc_sig_operator)
-    app.add_node(desc_sig_punctuation)
+    for n in SIG_ELEMENTS:
+        app.add_node(n)
     app.add_node(versionmodified)
     app.add_node(seealso)
     app.add_node(productionlist)
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index abe96179134..bb11138d61a 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -604,6 +604,10 @@ def get_display_string(self) -> str:
     def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment",
                            prefix: str, templateArgs: str, symbol: "Symbol") -> None:
         verify_description_mode(mode)
+        if self.is_anon():
+            node = addnodes.desc_sig_name(text="[anonymous]")
+        else:
+            node = addnodes.desc_sig_name(self.identifier, self.identifier)
         if mode == 'markType':
             targetText = prefix + self.identifier + templateArgs
             pnode = addnodes.pending_xref('', refdomain='cpp',
@@ -611,21 +615,17 @@ def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnviron
                                           reftarget=targetText, modname=None,
                                           classname=None)
             pnode['cpp:parent_key'] = symbol.get_lookup_key()
-            if self.is_anon():
-                pnode += nodes.strong(text="[anonymous]")
-            else:
-                pnode += nodes.Text(self.identifier)
+            pnode += node
             signode += pnode
         elif mode == 'lastIsName':
-            if self.is_anon():
-                signode += nodes.strong(text="[anonymous]")
-            else:
-                signode += addnodes.desc_name(self.identifier, self.identifier)
+            nameNode = addnodes.desc_name()
+            nameNode += node
+            signode += nameNode
         elif mode == 'noneIsName':
-            if self.is_anon():
-                signode += nodes.strong(text="[anonymous]")
-            else:
-                signode += nodes.Text(self.identifier)
+            signode += node
+        elif mode == 'param':
+            node['classes'].append('sig-param')
+            signode += node
         elif mode == 'udl':
             # the target is 'operator""id' instead of just 'id'
             assert len(prefix) == 0
@@ -637,7 +637,7 @@ def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnviron
                                           reftarget=targetText, modname=None,
                                           classname=None)
             pnode['cpp:parent_key'] = symbol.get_lookup_key()
-            pnode += nodes.Text(self.identifier)
+            pnode += node
             signode += pnode
         else:
             raise Exception('Unknown description mode: %s' % mode)
@@ -669,7 +669,7 @@ def describe_signature(self, signode: TextElement, mode: str,
         tArgs = str(self.templateArgs) if self.templateArgs is not None else ''
         self.identOrOp.describe_signature(signode, mode, env, prefix, tArgs, symbol)
         if self.templateArgs is not None:
-            self.templateArgs.describe_signature(signode, mode, env, symbol)
+            self.templateArgs.describe_signature(signode, 'markType', env, symbol)
 
 
 class ASTNestedName(ASTBase):
@@ -730,12 +730,15 @@ def describe_signature(self, signode: TextElement, mode: str,
         # just print the name part, with template args, not template params
         if mode == 'noneIsName':
             if self.rooted:
+                assert False, "Can this happen?"  # TODO
                 signode += nodes.Text('::')
             for i in range(len(self.names)):
                 if i != 0:
-                    signode += nodes.Text('::')
+                    assert False, "Can this happen?"  # TODO
+                    signode += nodes.Text('::blah')
                 n = self.names[i]
                 if self.templates[i]:
+                    assert False, "Can this happen?"  # TODO
                     signode += nodes.Text("template")
                     signode += nodes.Text(" ")
                 n.describe_signature(signode, mode, env, '', symbol)
@@ -743,9 +746,7 @@ def describe_signature(self, signode: TextElement, mode: str,
             assert not self.rooted, str(self)
             assert len(self.names) == 1
             assert not self.templates[0]
-            node = nodes.emphasis()
-            self.names[0].describe_signature(node, 'noneIsName', env, '', symbol)
-            signode += node
+            self.names[0].describe_signature(signode, 'param', env, '', symbol)
         elif mode == 'markType' or mode == 'lastIsName' or mode == 'markName':
             # Each element should be a pending xref targeting the complete
             # prefix. however, only the identifier part should be a link, such
@@ -771,17 +772,18 @@ def describe_signature(self, signode: TextElement, mode: str,
             if self.rooted:
                 prefix += '::'
                 if mode == 'lastIsName' and len(names) == 0:
-                    signode += nodes.Text('::')
+                    signode += addnodes.desc_sig_punctuation('::', '::')
                 else:
-                    dest += nodes.Text('::')
+                    dest += addnodes.desc_sig_punctuation('::', '::')
             for i in range(len(names)):
                 nne = names[i]
                 template = self.templates[i]
                 if not first:
-                    dest += nodes.Text('::')
+                    dest += addnodes.desc_sig_punctuation('::', '::')
                     prefix += '::'
                 if template:
-                    dest += nodes.Text("template ")
+                    dest += addnodes.desc_sig_keyword('template', 'template')
+                    dest += addnodes.desc_sig_space()
                 first = False
                 txt_nne = str(nne)
                 if txt_nne != '':
@@ -793,10 +795,11 @@ def describe_signature(self, signode: TextElement, mode: str,
                 prefix += txt_nne
             if mode == 'lastIsName':
                 if len(self.names) > 1:
-                    dest += addnodes.desc_addname('::', '::')
+                    dest += addnodes.desc_sig_punctuation('::', '::')
                     signode += dest
                 if self.templates[-1]:
-                    signode += nodes.Text("template ")
+                    signode += addnodes.desc_sig_keyword('template', 'template')
+                    signode += addnodes.desc_sig_space()
                 self.names[-1].describe_signature(signode, mode, env, '', symbol)
         else:
             raise Exception('Unknown description mode: %s' % mode)
@@ -831,7 +834,7 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('nullptr'))
+        signode += addnodes.desc_sig_keyword('nullptr', 'nullptr')
 
 
 class ASTBooleanLiteral(ASTLiteral):
@@ -852,7 +855,7 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text(str(self)))
+        signode += addnodes.desc_sig_keyword(str(self), str(self))
 
 
 class ASTNumberLiteral(ASTLiteral):
@@ -868,8 +871,7 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        txt = str(self)
-        signode.append(nodes.Text(txt, txt))
+        signode += addnodes.desc_sig_literal_number(self.data, self.data)
 
 
 class ASTStringLiteral(ASTLiteral):
@@ -885,8 +887,7 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        txt = str(self)
-        signode.append(nodes.Text(txt, txt))
+        signode += addnodes.desc_sig_literal_string(self.data, self.data)
 
 
 class ASTCharLiteral(ASTLiteral):
@@ -913,8 +914,10 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        txt = str(self)
-        signode.append(nodes.Text(txt, txt))
+        if self.prefix is not None:
+            signode += addnodes.desc_sig_keyword(self.prefix, self.prefix)
+        txt = "'" + self.data + "'"
+        signode += addnodes.desc_sig_literal_char(txt, txt)
 
 
 class ASTUserDefinedLiteral(ASTLiteral):
@@ -946,7 +949,7 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text("this"))
+        signode += addnodes.desc_sig_keyword('this', 'this')
 
 
 class ASTFoldExpr(ASTExpression):
@@ -996,19 +999,19 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('('))
+        signode += addnodes.desc_sig_punctuation('(', '(')
         if self.leftExpr:
             self.leftExpr.describe_signature(signode, mode, env, symbol)
-            signode.append(nodes.Text(' '))
-            signode.append(nodes.Text(self.op))
-            signode.append(nodes.Text(' '))
-        signode.append(nodes.Text('...'))
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_operator(self.op, self.op)
+            signode += addnodes.desc_sig_space()
+        signode += addnodes.desc_sig_punctuation('...', '...')
         if self.rightExpr:
-            signode.append(nodes.Text(' '))
-            signode.append(nodes.Text(self.op))
-            signode.append(nodes.Text(' '))
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_operator(self.op, self.op)
+            signode += addnodes.desc_sig_space()
             self.rightExpr.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTParenExpr(ASTExpression):
@@ -1023,9 +1026,9 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('(', '('))
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.expr.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')', ')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTIdExpression(ASTExpression):
@@ -1068,9 +1071,9 @@ def get_id(self, idPrefix: str, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('['))
+        signode += addnodes.desc_sig_punctuation('[', '[')
         self.expr.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(']'))
+        signode += addnodes.desc_sig_punctuation(']', ']')
 
 
 class ASTPostfixMember(ASTPostfixOp):
@@ -1085,7 +1088,7 @@ def get_id(self, idPrefix: str, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('.'))
+        signode += addnodes.desc_sig_punctuation('.', '.')
         self.name.describe_signature(signode, 'noneIsName', env, symbol)
 
 
@@ -1101,7 +1104,7 @@ def get_id(self, idPrefix: str, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('->'))
+        signode += addnodes.desc_sig_operator('->', '->')
         self.name.describe_signature(signode, 'noneIsName', env, symbol)
 
 
@@ -1114,7 +1117,7 @@ def get_id(self, idPrefix: str, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('++'))
+        signode += addnodes.desc_sig_operator('++', '++')
 
 
 class ASTPostfixDec(ASTPostfixOp):
@@ -1126,7 +1129,7 @@ def get_id(self, idPrefix: str, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('--'))
+        signode += addnodes.desc_sig_operator('--', '--')
 
 
 class ASTPostfixCallExpr(ASTPostfixOp):
@@ -1195,13 +1198,13 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text(self.cast))
-        signode.append(nodes.Text('<'))
+        signode += addnodes.desc_sig_keyword(self.cast, self.cast)
+        signode += addnodes.desc_sig_punctuation('<', '<')
         self.typ.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text('>'))
-        signode.append(nodes.Text('('))
+        signode += addnodes.desc_sig_punctuation('>', '>')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.expr.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTTypeId(ASTExpression):
@@ -1218,10 +1221,10 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('typeid'))
-        signode.append(nodes.Text('('))
+        signode += addnodes.desc_sig_keyword('typeid', 'typeid')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.typeOrExpr.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 # Unary expressions
@@ -1243,9 +1246,9 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text(self.op))
+        signode += addnodes.desc_sig_operator(self.op, self.op)
         if self.op[0] in 'cn':
-            signode.append(nodes.Text(' '))
+            signode += addnodes.desc_sig_space()
         self.expr.describe_signature(signode, mode, env, symbol)
 
 
@@ -1261,10 +1264,12 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('sizeof...('))
+        signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
+        signode += addnodes.desc_sig_punctuation('...', '...')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.identifier.describe_signature(signode, 'markType', env,
                                            symbol=symbol, prefix="", templateArgs="")
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTSizeofType(ASTExpression):
@@ -1279,9 +1284,10 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('sizeof('))
+        signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTSizeofExpr(ASTExpression):
@@ -1296,7 +1302,8 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('sizeof '))
+        signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
+        signode += addnodes.desc_sig_space()
         self.expr.describe_signature(signode, mode, env, symbol)
 
 
@@ -1312,9 +1319,10 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('alignof('))
+        signode += addnodes.desc_sig_keyword('alignof', 'alignof')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTNoexceptExpr(ASTExpression):
@@ -1329,9 +1337,10 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('noexcept('))
+        signode += addnodes.desc_sig_keyword('noexcept', 'noexcept')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.expr.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTNewExpr(ASTExpression):
@@ -1371,8 +1380,9 @@ def get_id(self, version: int) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         if self.rooted:
-            signode.append(nodes.Text('::'))
-        signode.append(nodes.Text('new '))
+            signode += addnodes.desc_sig_punctuation('::', '::')
+        signode += addnodes.desc_sig_keyword('new', 'new')
+        signode += addnodes.desc_sig_space()
         # TODO: placement
         if self.isNewTypeId:
             self.typ.describe_signature(signode, mode, env, symbol)
@@ -1408,10 +1418,12 @@ def get_id(self, version: int) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         if self.rooted:
-            signode.append(nodes.Text('::'))
-        signode.append(nodes.Text('delete '))
+            signode += addnodes.desc_sig_punctuation('::', '::')
+        signode += addnodes.desc_sig_keyword('delete', 'delete')
+        signode += addnodes.desc_sig_space()
         if self.array:
-            signode.append(nodes.Text('[] '))
+            signode += addnodes.desc_sig_punctuation('[]', '[]')
+            signode += addnodes.desc_sig_space()
         self.expr.describe_signature(signode, mode, env, symbol)
 
 
@@ -1435,9 +1447,9 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('('))
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
         self.expr.describe_signature(signode, mode, env, symbol)
 
 
@@ -1471,9 +1483,9 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         self.exprs[0].describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
-            signode.append(nodes.Text(' '))
-            signode.append(nodes.Text(self.ops[i - 1]))
-            signode.append(nodes.Text(' '))
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_operator(self.ops[i - 1], self.ops[i - 1])
+            signode += addnodes.desc_sig_space()
             self.exprs[i].describe_signature(signode, mode, env, symbol)
 
 
@@ -1494,17 +1506,18 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode.append(nodes.Text('{'))
+        signode += addnodes.desc_sig_punctuation('{', '{')
         first = True
         for e in self.exprs:
             if not first:
-                signode.append(nodes.Text(', '))
+                signode += addnodes.desc_sig_punctuation(',', ',')
+                signode += addnodes.desc_sig_space()
             else:
                 first = False
             e.describe_signature(signode, mode, env, symbol)
         if self.trailingComma:
-            signode.append(nodes.Text(','))
-        signode.append(nodes.Text('}'))
+            signode += addnodes.desc_sig_punctuation(',', ',')
+        signode += addnodes.desc_sig_punctuation('}', '}')
 
 
 class ASTAssignmentExpr(ASTExpression):
@@ -1536,9 +1549,9 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         self.exprs[0].describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
-            signode.append(nodes.Text(' '))
-            signode.append(nodes.Text(self.ops[i - 1]))
-            signode.append(nodes.Text(' '))
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_operator(self.ops[i - 1], self.ops[i - 1])
+            signode += addnodes.desc_sig_space()
             self.exprs[i].describe_signature(signode, mode, env, symbol)
 
 
@@ -1563,7 +1576,8 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         self.exprs[0].describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
-            signode.append(nodes.Text(', '))
+            signode += addnodes.desc_sig_punctuation(',', ',')
+            signode += addnodes.desc_sig_space()
             self.exprs[i].describe_signature(signode, mode, env, symbol)
 
 
@@ -1579,7 +1593,7 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode += nodes.Text(self.expr)
+        signode += nodes.literal(self.expr, self.expr)
 
 
 ################################################################################
@@ -1599,24 +1613,39 @@ def is_operator(self) -> bool:
     def get_id(self, version: int) -> str:
         raise NotImplementedError()
 
+    def _describe_identifier(self, signode: TextElement, identnode: TextElement,
+                             env: "BuildEnvironment", symbol: "Symbol") -> None:
+        """Render the prefix into signode, and the last part into identnode."""
+        raise NotImplementedError()
+
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", prefix: str, templateArgs: str,
                            symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        identifier = str(self)
         if mode == 'lastIsName':
-            signode += addnodes.desc_name(identifier, identifier)
+            identnode = addnodes.desc_name()
+            self._describe_identifier(identnode, identnode, env, symbol)
+            signode += identnode
         elif mode == 'markType':
-            targetText = prefix + identifier + templateArgs
+            targetText = prefix + str(self) + templateArgs
             pnode = addnodes.pending_xref('', refdomain='cpp',
                                           reftype='identifier',
                                           reftarget=targetText, modname=None,
                                           classname=None)
             pnode['cpp:parent_key'] = symbol.get_lookup_key()
-            pnode += nodes.Text(identifier)
+            # Render the identifier part, but collapse it into a string
+            # and make that the a link to this operator.
+            # E.g., if it is 'operator SomeType', then 'SomeType' becomes
+            # a link to the operator, not to 'SomeType'.
+            identnode = nodes.literal()
+            self._describe_identifier(signode, identnode, env, symbol)
+            txt = identnode.astext()
+            pnode += addnodes.desc_name(txt, txt)
             signode += pnode
         else:
-            signode += addnodes.desc_addname(identifier, identifier)
+            identnode = addnodes.desc_addname()
+            self._describe_identifier(identnode, identnode, env, symbol)
+            signode += identnode
 
 
 class ASTOperatorBuildIn(ASTOperator):
@@ -1641,6 +1670,13 @@ def _stringify(self, transform: StringifyTransform) -> str:
         else:
             return 'operator' + self.op
 
+    def _describe_identifier(self, signode: TextElement, identnode: TextElement,
+                             env: "BuildEnvironment", symbol: "Symbol") -> None:
+        signode += addnodes.desc_sig_keyword('operator', 'operator')
+        if self.op in ('new', 'new[]', 'delete', 'delete[]') or self.op[0] in "abcnox":
+            signode += addnodes.desc_sig_space()
+        identnode += addnodes.desc_sig_operator(self.op, self.op)
+
 
 class ASTOperatorLiteral(ASTOperator):
     def __init__(self, identifier: ASTIdentifier) -> None:
@@ -1655,6 +1691,12 @@ def get_id(self, version: int) -> str:
     def _stringify(self, transform: StringifyTransform) -> str:
         return 'operator""' + transform(self.identifier)
 
+    def _describe_identifier(self, signode: TextElement, identnode: TextElement,
+                             env: "BuildEnvironment", symbol: "Symbol") -> None:
+        signode += addnodes.desc_sig_keyword('operator', 'operator')
+        signode += addnodes.desc_sig_literal_string('""', '""')
+        self.identifier.describe_signature(identnode, 'markType', env, '', '', symbol)
+
 
 class ASTOperatorType(ASTOperator):
     def __init__(self, type: "ASTType") -> None:
@@ -1672,6 +1714,12 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def get_name_no_template(self) -> str:
         return str(self)
 
+    def _describe_identifier(self, signode: TextElement, identnode: TextElement,
+                             env: "BuildEnvironment", symbol: "Symbol") -> None:
+        signode += addnodes.desc_sig_keyword('operator', 'operator')
+        signode += addnodes.desc_sig_space()
+        self.type.describe_signature(identnode, 'markType', env, symbol)
+
 
 class ASTTemplateArgConstant(ASTBase):
     def __init__(self, value: ASTExpression) -> None:
@@ -1730,16 +1778,17 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode += nodes.Text('<')
+        signode += addnodes.desc_sig_punctuation('<', '<')
         first = True
         for a in self.args:
             if not first:
-                signode += nodes.Text(', ')
+                signode += addnodes.desc_sig_punctuation(',', ',')
+                signode += addnodes.desc_sig_space()
             first = False
             a.describe_signature(signode, 'markType', env, symbol=symbol)
         if self.packExpansion:
-            signode += nodes.Text('...')
-        signode += nodes.Text('>')
+            signode += addnodes.desc_sig_punctuation('...', '...')
+        signode += addnodes.desc_sig_punctuation('>', '>')
 
 
 # Main part of declarations
@@ -1780,7 +1829,7 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode += nodes.Text(str(self.name))
+        signode += addnodes.desc_sig_keyword_type(self.name, self.name)
 
 
 class ASTTrailingTypeSpecDecltypeAuto(ASTTrailingTypeSpec):
@@ -1794,7 +1843,10 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text(str(self)))
+        signode += addnodes.desc_sig_keyword('decltype', 'decltype')
+        signode += addnodes.desc_sig_punctuation('(', '(')
+        signode += addnodes.desc_sig_keyword('auto', 'auto')
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTTrailingTypeSpecDecltype(ASTTrailingTypeSpec):
@@ -1811,9 +1863,10 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('decltype('))
+        signode += addnodes.desc_sig_keyword('decltype', 'decltype')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.expr.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTTrailingTypeSpecName(ASTTrailingTypeSpec):
@@ -1839,8 +1892,8 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         if self.prefix:
-            signode += addnodes.desc_annotation(self.prefix, self.prefix)
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_keyword(self.prefix, self.prefix)
+            signode += addnodes.desc_sig_space()
         self.nestedName.describe_signature(signode, mode, env, symbol=symbol)
 
 
@@ -1872,7 +1925,7 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
         if self.ellipsis:
-            signode += nodes.Text('...')
+            signode += addnodes.desc_sig_punctuation('...', '...')
         else:
             self.arg.describe_signature(signode, mode, env, symbol=symbol)
 
@@ -1888,18 +1941,19 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode += addnodes.desc_annotation('noexcept', 'noexcept')
+        signode += addnodes.desc_sig_keyword('noexcept', 'noexcept')
         if self.expr:
-            signode.append(nodes.Text('('))
-            self.expr.describe_signature(signode, mode, env, symbol)
-            signode.append(nodes.Text(')'))
+            signode += addnodes.desc_sig_punctuation('(', '(')
+            self.expr.describe_signature(signode, 'markType', env, symbol)
+            signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTParametersQualifiers(ASTBase):
     def __init__(self, args: List[ASTFunctionParameter], volatile: bool, const: bool,
-                 refQual: str, exceptionSpec: ASTNoexceptSpec, trailingReturn: "ASTType",
+                 refQual: Optional[str], exceptionSpec: ASTNoexceptSpec,
+                 trailingReturn: "ASTType",
                  override: bool, final: bool, attrs: List[ASTAttribute],
-                 initializer: str) -> None:
+                 initializer: Optional[str]) -> None:
         self.args = args
         self.volatile = volatile
         self.const = const
@@ -1988,43 +2042,51 @@ def describe_signature(self, signode: TextElement, mode: str,
                 paramlist += param
             signode += paramlist
         else:
-            signode += nodes.Text('(', '(')
+            signode += addnodes.desc_sig_punctuation('(', '(')
             first = True
             for arg in self.args:
                 if not first:
-                    signode += nodes.Text(', ', ', ')
+                    signode += addnodes.desc_sig_punctuation(',', ',')
+                    signode += addnodes.desc_sig_space()
                 first = False
                 arg.describe_signature(signode, 'markType', env, symbol=symbol)
-            signode += nodes.Text(')', ')')
+            signode += addnodes.desc_sig_punctuation(')', ')')
 
         def _add_anno(signode: TextElement, text: str) -> None:
-            signode += nodes.Text(' ')
-            signode += addnodes.desc_annotation(text, text)
-
-        def _add_text(signode: TextElement, text: str) -> None:
-            signode += nodes.Text(' ' + text)
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_keyword(text, text)
 
         if self.volatile:
             _add_anno(signode, 'volatile')
         if self.const:
             _add_anno(signode, 'const')
         if self.refQual:
-            _add_text(signode, self.refQual)
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation(self.refQual, self.refQual)
         if self.exceptionSpec:
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
             self.exceptionSpec.describe_signature(signode, mode, env, symbol)
         if self.trailingReturn:
-            signode += nodes.Text(' -> ')
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_operator('->', '->')
+            signode += addnodes.desc_sig_space()
             self.trailingReturn.describe_signature(signode, mode, env, symbol)
         if self.final:
             _add_anno(signode, 'final')
         if self.override:
             _add_anno(signode, 'override')
         for attr in self.attrs:
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
             attr.describe_signature(signode)
         if self.initializer:
-            _add_text(signode, '= ' + str(self.initializer))
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation('=', '=')
+            signode += addnodes.desc_sig_space()
+            assert self.initializer in ('0', 'delete', 'default')
+            if self.initializer == '0':
+                signode += addnodes.desc_sig_literal_number('0', '0')
+            else:
+                signode += addnodes.desc_sig_keyword(self.initializer, self.initializer)
 
 
 class ASTDeclSpecsSimple(ASTBase):
@@ -2083,14 +2145,14 @@ def describe_signature(self, signode: TextElement) -> None:
         addSpace = False
         for attr in self.attrs:
             if addSpace:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             addSpace = True
             attr.describe_signature(signode)
 
         def _add(signode: TextElement, text: str) -> bool:
             if addSpace:
-                signode += nodes.Text(' ')
-            signode += addnodes.desc_annotation(text, text)
+                signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_keyword(text, text)
             return True
 
         if self.storage:
@@ -2168,7 +2230,7 @@ def describe_signature(self, signode: TextElement, mode: str,
 
         if self.trailingTypeSpec:
             if addSpace:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             numChildren = len(signode)
             self.trailingTypeSpec.describe_signature(signode, mode, env,
                                                      symbol=symbol)
@@ -2176,7 +2238,7 @@ def describe_signature(self, signode: TextElement, mode: str,
 
             if len(str(self.rightSpecs)) > 0:
                 if addSpace:
-                    signode += nodes.Text(' ')
+                    signode += addnodes.desc_sig_space()
                 self.rightSpecs.describe_signature(signode)
 
 
@@ -2209,10 +2271,10 @@ def get_id(self, version: int) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode.append(nodes.Text("["))
+        signode += addnodes.desc_sig_punctuation('[', '[')
         if self.size:
             self.size.describe_signature(signode, 'markType', env, symbol)
-        signode.append(nodes.Text("]"))
+        signode += addnodes.desc_sig_punctuation(']', ']')
 
 
 class ASTDeclarator(ASTBase):
@@ -2375,7 +2437,9 @@ def describe_signature(self, signode: TextElement, mode: str,
         verify_description_mode(mode)
         if self.declId:
             self.declId.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(' : ', ' : '))
+        signode += addnodes.desc_sig_space()
+        signode += addnodes.desc_sig_punctuation(':', ':')
+        signode += addnodes.desc_sig_space()
         self.size.describe_signature(signode, mode, env, symbol)
 
 
@@ -2461,23 +2525,23 @@ def is_function_type(self) -> bool:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode += nodes.Text("*")
+        signode += addnodes.desc_sig_punctuation('*', '*')
         for a in self.attrs:
             a.describe_signature(signode)
         if len(self.attrs) > 0 and (self.volatile or self.const):
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
 
         def _add_anno(signode: TextElement, text: str) -> None:
-            signode += addnodes.desc_annotation(text, text)
+            signode += addnodes.desc_sig_keyword(text, text)
         if self.volatile:
             _add_anno(signode, 'volatile')
         if self.const:
             if self.volatile:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             _add_anno(signode, 'const')
         if self.const or self.volatile or len(self.attrs) > 0:
             if self.next.require_space_after_declSpecs():
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
         self.next.describe_signature(signode, mode, env, symbol)
 
 
@@ -2538,11 +2602,11 @@ def is_function_type(self) -> bool:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode += nodes.Text("&")
+        signode += addnodes.desc_sig_punctuation('&', '&')
         for a in self.attrs:
             a.describe_signature(signode)
         if len(self.attrs) > 0 and self.next.require_space_after_declSpecs():
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
         self.next.describe_signature(signode, mode, env, symbol)
 
 
@@ -2595,9 +2659,9 @@ def is_function_type(self) -> bool:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode += nodes.Text("...")
+        signode += addnodes.desc_sig_punctuation('...', '...')
         if self.next.name:
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
         self.next.describe_signature(signode, mode, env, symbol)
 
 
@@ -2680,18 +2744,19 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
         self.className.describe_signature(signode, 'markType', env, symbol)
-        signode += nodes.Text('::*')
+        signode += addnodes.desc_sig_punctuation('::', '::')
+        signode += addnodes.desc_sig_punctuation('*', '*')
 
         def _add_anno(signode: TextElement, text: str) -> None:
-            signode += addnodes.desc_annotation(text, text)
+            signode += addnodes.desc_sig_keyword(text, text)
         if self.volatile:
             _add_anno(signode, 'volatile')
         if self.const:
             if self.volatile:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             _add_anno(signode, 'const')
         if self.next.require_space_after_declSpecs():
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
         self.next.describe_signature(signode, mode, env, symbol)
 
 
@@ -2752,9 +2817,9 @@ def is_function_type(self) -> bool:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode += nodes.Text('(')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.inner.describe_signature(signode, mode, env, symbol)
-        signode += nodes.Text(')')
+        signode += addnodes.desc_sig_punctuation(')', ')')
         self.next.describe_signature(signode, "noneIsName", env, symbol)
 
 
@@ -2775,7 +2840,7 @@ def get_id(self, version: int) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         self.expr.describe_signature(signode, mode, env, symbol)
-        signode += nodes.Text('...')
+        signode += addnodes.desc_sig_punctuation('...', '...')
 
 
 class ASTParenExprList(ASTBaseParenExprList):
@@ -2792,15 +2857,16 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode.append(nodes.Text('('))
+        signode += addnodes.desc_sig_punctuation('(', '(')
         first = True
         for e in self.exprs:
             if not first:
-                signode.append(nodes.Text(', '))
+                signode += addnodes.desc_sig_punctuation(',', ',')
+                signode += addnodes.desc_sig_space()
             else:
                 first = False
             e.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTInitializer(ASTBase):
@@ -2820,7 +2886,9 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
         if self.hasAssign:
-            signode.append(nodes.Text(' = '))
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation('=', '=')
+            signode += addnodes.desc_sig_space()
         self.value.describe_signature(signode, 'markType', env, symbol)
 
 
@@ -2924,7 +2992,7 @@ def describe_signature(self, signode: TextElement, mode: str,
         self.declSpecs.describe_signature(signode, 'markType', env, symbol)
         if (self.decl.require_space_after_declSpecs() and
                 len(str(self.declSpecs)) > 0):
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
         # for parameters that don't really declare new names we get 'markType',
         # this should not be propagated, but be 'noneIsName'.
         if mode == 'markType':
@@ -2966,7 +3034,9 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         self.type.describe_signature(signode, mode, env, symbol)
         if self.init:
-            signode += nodes.Text(" = ")
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation('=', '=')
+            signode += addnodes.desc_sig_space()
             self.init.describe_signature(signode, mode, env, symbol)
 
 
@@ -3034,7 +3104,9 @@ def describe_signature(self, signode: TextElement, mode: str,
         verify_description_mode(mode)
         self.name.describe_signature(signode, mode, env, symbol=symbol)
         if self.type:
-            signode += nodes.Text(' = ')
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation('=', '=')
+            signode += addnodes.desc_sig_space()
             self.type.describe_signature(signode, 'markType', env, symbol=symbol)
 
 
@@ -3079,7 +3151,6 @@ def __init__(self, name: ASTNestedName, visibility: str,
 
     def _stringify(self, transform: StringifyTransform) -> str:
         res = []
-
         if self.visibility is not None:
             res.append(self.visibility)
             res.append(' ')
@@ -3094,15 +3165,15 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
         if self.visibility is not None:
-            signode += addnodes.desc_annotation(self.visibility,
-                                                self.visibility)
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_keyword(self.visibility,
+                                                 self.visibility)
+            signode += addnodes.desc_sig_space()
         if self.virtual:
-            signode += addnodes.desc_annotation('virtual', 'virtual')
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_keyword('virtual', 'virtual')
+            signode += addnodes.desc_sig_space()
         self.name.describe_signature(signode, 'markType', env, symbol=symbol)
         if self.pack:
-            signode += nodes.Text('...')
+            signode += addnodes.desc_sig_punctuation('...', '...')
 
 
 class ASTClass(ASTBase):
@@ -3134,13 +3205,17 @@ def describe_signature(self, signode: TextElement, mode: str,
         verify_description_mode(mode)
         self.name.describe_signature(signode, mode, env, symbol=symbol)
         if self.final:
-            signode += nodes.Text(' ')
-            signode += addnodes.desc_annotation('final', 'final')
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_keyword('final', 'final')
         if len(self.bases) > 0:
-            signode += nodes.Text(' : ')
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation(':', ':')
+            signode += addnodes.desc_sig_space()
             for b in self.bases:
                 b.describe_signature(signode, mode, env, symbol=symbol)
-                signode += nodes.Text(', ')
+                signode += addnodes.desc_sig_punctuation(',', ',')
+                signode += addnodes.desc_sig_space()
+            signode.pop()
             signode.pop()
 
 
@@ -3191,7 +3266,9 @@ def describe_signature(self, signode: TextElement, mode: str,
         # self.scoped has been done by the CPPEnumObject
         self.name.describe_signature(signode, mode, env, symbol=symbol)
         if self.underlyingType:
-            signode += nodes.Text(' : ')
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation(':', ':')
+            signode += addnodes.desc_sig_space()
             self.underlyingType.describe_signature(signode, 'noneIsName',
                                                    env, symbol=symbol)
 
@@ -3281,17 +3358,19 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode += nodes.Text(self.key)
+        signode += addnodes.desc_sig_keyword(self.key, self.key)
         if self.parameterPack:
             if self.identifier:
-                signode += nodes.Text(' ')
-            signode += nodes.Text('...')
+                signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation('...', '...')
         if self.identifier:
             if not self.parameterPack:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             self.identifier.describe_signature(signode, mode, env, '', '', symbol)
         if self.default:
-            signode += nodes.Text(' = ')
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation('=', '=')
+            signode += addnodes.desc_sig_space()
             self.default.describe_signature(signode, 'markType', env, symbol)
 
 
@@ -3364,7 +3443,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         self.nestedParams.describe_signature(signode, 'noneIsName', env, symbol)
-        signode += nodes.Text(' ')
+        signode += addnodes.desc_sig_space()
         self.data.describe_signature(signode, mode, env, symbol)
 
 
@@ -3436,14 +3515,16 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode += nodes.Text("template<")
+        signode += addnodes.desc_sig_keyword('template', 'template')
+        signode += addnodes.desc_sig_punctuation('<', '<')
         first = True
         for param in self.params:
             if not first:
-                signode += nodes.Text(", ")
+                signode += addnodes.desc_sig_punctuation(',', ',')
+                signode += addnodes.desc_sig_space()
             first = False
             param.describe_signature(signode, mode, env, symbol)
-        signode += nodes.Text(">")
+        signode += addnodes.desc_sig_punctuation('>', '>')
 
     def describe_signature_as_introducer(
             self, parentNode: desc_signature, mode: str, env: "BuildEnvironment",
@@ -3454,18 +3535,20 @@ def makeLine(parentNode: desc_signature) -> addnodes.desc_signature_line:
             signode.sphinx_line_type = 'templateParams'
             return signode
         lineNode = makeLine(parentNode)
-        lineNode += nodes.Text("template<")
+        lineNode += addnodes.desc_sig_keyword('template', 'template')
+        lineNode += addnodes.desc_sig_punctuation('<', '<')
         first = True
         for param in self.params:
             if not first:
-                lineNode += nodes.Text(", ")
+                lineNode += addnodes.desc_sig_punctuation(',', ',')
+                lineNode += addnodes.desc_sig_space()
             first = False
             if lineSpec:
                 lineNode = makeLine(parentNode)
             param.describe_signature(lineNode, mode, env, symbol)
         if lineSpec and not first:
             lineNode = makeLine(parentNode)
-        lineNode += nodes.Text(">")
+        lineNode += addnodes.desc_sig_punctuation('>', '>')
 
 
 # Template introducers
@@ -3519,7 +3602,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         if self.parameterPack:
-            signode += nodes.Text('...')
+            signode += addnodes.desc_sig_punctuation('...', '...')
         self.identifier.describe_signature(signode, mode, env, '', '', symbol)
 
 
@@ -3564,14 +3647,15 @@ def describe_signature_as_introducer(
         parentNode += signode
         signode.sphinx_line_type = 'templateIntroduction'
         self.concept.describe_signature(signode, 'markType', env, symbol)
-        signode += nodes.Text('{')
+        signode += addnodes.desc_sig_punctuation('{', '{')
         first = True
         for param in self.params:
             if not first:
-                signode += nodes.Text(', ')
+                signode += addnodes.desc_sig_punctuation(',', ',')
+                signode += addnodes.desc_sig_space()
             first = False
             param.describe_signature(signode, mode, env, symbol)
-        signode += nodes.Text('}')
+        signode += addnodes.desc_sig_punctuation('}', '}')
 
 
 ################################################################################
@@ -3613,7 +3697,8 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: addnodes.desc_signature_line, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode += nodes.Text('requires ', 'requires ')
+        signode += addnodes.desc_sig_keyword('requires', 'requires')
+        signode += addnodes.desc_sig_space()
         self.expr.describe_signature(signode, mode, env, symbol)
 
 
@@ -3733,39 +3818,42 @@ def describe_signature(self, signode: desc_signature, mode: str,
             self.requiresClause.describe_signature(reqNode, 'markType', env, self.symbol)
         signode += mainDeclNode
         if self.visibility and self.visibility != "public":
-            mainDeclNode += addnodes.desc_annotation(self.visibility + " ",
-                                                     self.visibility + " ")
+            mainDeclNode += addnodes.desc_sig_keyword(self.visibility, self.visibility)
+            mainDeclNode += addnodes.desc_sig_space()
         if self.objectType == 'type':
             prefix = self.declaration.get_type_declaration_prefix()
-            prefix += ' '
-            mainDeclNode += addnodes.desc_annotation(prefix, prefix)
+            mainDeclNode += addnodes.desc_sig_keyword(prefix, prefix)
+            mainDeclNode += addnodes.desc_sig_space()
         elif self.objectType == 'concept':
-            mainDeclNode += addnodes.desc_annotation('concept ', 'concept ')
+            mainDeclNode += addnodes.desc_sig_keyword('concept', 'concept')
+            mainDeclNode += addnodes.desc_sig_space()
         elif self.objectType == 'member':
             pass
         elif self.objectType == 'function':
             pass
         elif self.objectType == 'class':
             assert self.directiveType in ('class', 'struct')
-            prefix = self.directiveType + ' '
-            mainDeclNode += addnodes.desc_annotation(prefix, prefix)
+            mainDeclNode += addnodes.desc_sig_keyword(self.directiveType, self.directiveType)
+            mainDeclNode += addnodes.desc_sig_space()
         elif self.objectType == 'union':
-            mainDeclNode += addnodes.desc_annotation('union ', 'union ')
+            mainDeclNode += addnodes.desc_sig_keyword('union', 'union')
+            mainDeclNode += addnodes.desc_sig_space()
         elif self.objectType == 'enum':
-            if self.directiveType == 'enum':
-                prefix = 'enum '
-            elif self.directiveType == 'enum-class':
-                prefix = 'enum class '
+            mainDeclNode += addnodes.desc_sig_keyword('enum', 'enum')
+            mainDeclNode += addnodes.desc_sig_space()
+            if self.directiveType == 'enum-class':
+                mainDeclNode += addnodes.desc_sig_keyword('class', 'class')
+                mainDeclNode += addnodes.desc_sig_space()
             elif self.directiveType == 'enum-struct':
-                prefix = 'enum struct '
+                mainDeclNode += addnodes.desc_sig_keyword('struct', 'struct')
+                mainDeclNode += addnodes.desc_sig_space()
             else:
-                assert False  # wrong directiveType used
-            mainDeclNode += addnodes.desc_annotation(prefix, prefix)
+                assert self.directiveType == 'enum', self.directiveType
         elif self.objectType == 'enumerator':
-            mainDeclNode += addnodes.desc_annotation('enumerator ', 'enumerator ')
+            mainDeclNode += addnodes.desc_sig_keyword('enumerator', 'enumerator')
+            mainDeclNode += addnodes.desc_sig_space()
         else:
-            print(self.objectType)
-            assert False
+            assert False, self.objectType
         self.declaration.describe_signature(mainDeclNode, mode, env, self.symbol)
         lastDeclNode = mainDeclNode
         if self.trailingRequiresClause:
@@ -3776,7 +3864,7 @@ def describe_signature(self, signode: desc_signature, mode: str,
             self.trailingRequiresClause.describe_signature(
                 trailingReqNode, 'markType', env, self.symbol)
         if self.semicolon:
-            lastDeclNode += nodes.Text(';')
+            lastDeclNode += addnodes.desc_sig_punctuation(';', ';')
 
 
 class ASTNamespace(ASTBase):
@@ -7604,9 +7692,10 @@ def checkType() -> bool:
                 title += '()' * addParen
             # and reconstruct the title again
             contnode += nodes.Text(title)
-        return make_refnode(builder, fromdocname, docname,
+        res = make_refnode(builder, fromdocname, docname,
                             declaration.get_newest_id(), contnode, displayName
                             ), declaration.objectType
+        return res
 
     def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
                      typ: str, target: str, node: pending_xref, contnode: Element
diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index 6264f20d24d..4af85bea959 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -508,6 +508,30 @@ table.hlist td {
     vertical-align: top;
 }
 
+/* -- object description styles --------------------------------------------- */
+
+.sig-name, code.descname {
+    background-color: transparent;
+    font-weight: bold;
+    font-size: 1.2em;
+}
+
+.sig-prename, code.descclassname {
+    background-color: transparent;
+}
+
+.optional {
+    font-size: 1.3em;
+}
+
+.sig-paren {
+    font-size: larger;
+}
+
+.sig-param.n {
+	font-style: italic;
+}
+
 
 /* -- other body styles ----------------------------------------------------- */
 
@@ -634,14 +658,6 @@ dl.glossary dt {
     font-size: 1.1em;
 }
 
-.optional {
-    font-size: 1.3em;
-}
-
-.sig-paren {
-    font-size: larger;
-}
-
 .versionmodified {
     font-style: italic;
 }
@@ -786,16 +802,6 @@ div.literal-block-wrapper {
     margin: 1em 0;
 }
 
-code.descname {
-    background-color: transparent;
-    font-weight: bold;
-    font-size: 1.2em;
-}
-
-code.descclassname {
-    background-color: transparent;
-}
-
 code.xref, a code {
     background-color: transparent;
     font-weight: bold;
diff --git a/sphinx/transforms/post_transforms/__init__.py b/sphinx/transforms/post_transforms/__init__.py
index 653097cd887..76a709f5f2c 100644
--- a/sphinx/transforms/post_transforms/__init__.py
+++ b/sphinx/transforms/post_transforms/__init__.py
@@ -209,10 +209,6 @@ class SigElementFallbackTransform(SphinxPostTransform):
     """Fallback desc_sig_element nodes to inline if translator does not supported them."""
     default_priority = 200
 
-    SIG_ELEMENTS = [addnodes.desc_sig_name,
-                    addnodes.desc_sig_operator,
-                    addnodes.desc_sig_punctuation]
-
     def run(self, **kwargs: Any) -> None:
         def has_visitor(translator: Type[nodes.NodeVisitor], node: Type[Element]) -> bool:
             return hasattr(translator, "visit_%s" % node.__name__)
@@ -222,7 +218,7 @@ def has_visitor(translator: Type[nodes.NodeVisitor], node: Type[Element]) -> boo
             # subclass of SphinxTranslator supports desc_sig_element nodes automatically.
             return
 
-        if all(has_visitor(translator, node) for node in self.SIG_ELEMENTS):
+        if all(has_visitor(translator, node) for node in addnodes.SIG_ELEMENTS):
             # the translator supports all desc_sig_element nodes
             return
         else:
diff --git a/tests/test_domain_cpp.py b/tests/test_domain_cpp.py
index edd5ea5bc57..7ecf89f543f 100644
--- a/tests/test_domain_cpp.py
+++ b/tests/test_domain_cpp.py
@@ -73,6 +73,7 @@ def _check(name, input, idDict, output, key, asTextOutput):
         print("Input:    ", input)
         print("astext(): ", resAsText)
         print("Expected: ", outputAsText)
+        print("Node:", parentNode)
         raise DefinitionError("")
 
     idExpected = [None]
@@ -743,6 +744,9 @@ def test_anon_definitions():
     check('class', '@1', {3: "Ut1_1"}, asTextOutput='class [anonymous]')
     check('class', '@a::A', {3: "NUt1_a1AE"}, asTextOutput='class [anonymous]::A')
 
+    check('function', 'int f(int @a)', {1: 'f__i', 2: '1fi'},
+          asTextOutput='int f(int [anonymous])')
+
 
 def test_templates():
     check('class', "A<T>", {2: "IE1AI1TE"}, output="template<> {key}A<T>")
diff --git a/tests/test_ext_intersphinx.py b/tests/test_ext_intersphinx.py
index 523ed2acc32..785faed62b4 100644
--- a/tests/test_ext_intersphinx.py
+++ b/tests/test_ext_intersphinx.py
@@ -258,10 +258,10 @@ def test_missing_reference_cppdomain(tempdir, app, status, warning):
             '<span class="pre">Bar</span></code></a>' in html)
     assert ('<a class="reference external"'
             ' href="https://docs.python.org/index.html#foons"'
-            ' title="(in foo v2.0)"><span class="pre">foons</span></a>' in html)
+            ' title="(in foo v2.0)"><span class="n">foons</span></a>' in html)
     assert ('<a class="reference external"'
             ' href="https://docs.python.org/index.html#foons_bartype"'
-            ' title="(in foo v2.0)"><span class="pre">bartype</span></a>' in html)
+            ' title="(in foo v2.0)"><span class="n">bartype</span></a>' in html)
 
 
 def test_missing_reference_jsdomain(tempdir, app, status, warning):

From 3c9a74cb0b9e5ca90adfb1ee55b2262717fae223 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 16:16:14 +0100
Subject: [PATCH 252/305] Decl styling, docs and restructuring

---
 doc/extdev/nodes.rst    | 17 +++++++++--
 sphinx/addnodes.py      | 63 ++++++++++++++++++++++++++++-------------
 sphinx/writers/html5.py | 22 ++++++++++----
 3 files changed, 74 insertions(+), 28 deletions(-)

diff --git a/doc/extdev/nodes.rst b/doc/extdev/nodes.rst
index 3976de4c709..d327e1cb0c7 100644
--- a/doc/extdev/nodes.rst
+++ b/doc/extdev/nodes.rst
@@ -8,18 +8,31 @@ Doctree node classes added by Sphinx
 Nodes for domain-specific object descriptions
 ---------------------------------------------
 
+Top-level nodes
+...............
+
+These nodes form the top-most levels of object descriptions.
+
 .. autoclass:: desc
 .. autoclass:: desc_signature
 .. autoclass:: desc_signature_line
+.. autoclass:: desc_content
+
+Nodes for high-level structure in signatures
+............................................
+
+These nodes occur in in non-multiline :py:class:`desc_signature` nodes
+and in :py:class:`desc_signature_line` nodes.
+
+.. autoclass:: desc_name
 .. autoclass:: desc_addname
+
 .. autoclass:: desc_type
 .. autoclass:: desc_returns
-.. autoclass:: desc_name
 .. autoclass:: desc_parameterlist
 .. autoclass:: desc_parameter
 .. autoclass:: desc_optional
 .. autoclass:: desc_annotation
-.. autoclass:: desc_content
 
 New admonition-like constructs
 ------------------------------
diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 3200e5e4718..f818e496d06 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -115,24 +115,32 @@ def extract_original_messages(self) -> List[str]:
         return messages
 
 
-# domain-specific object descriptions (class, function etc.)
+#############################################################
+# Domain-specific object descriptions (class, function etc.)
+#############################################################
+
+# Top-level nodes
+#################
 
 class desc(nodes.Admonition, nodes.Element):
-    """Node for object descriptions.
+    """Node for a list of object signatures and a common description of them.
+
+    Contains one or more :py:class:`desc_signature` nodes
+    and then a single :py:class:`desc_content` node.
+
+    This node always has two classes:
 
-    This node is similar to a "definition list" with one definition.  It
-    contains one or more ``desc_signature`` and a ``desc_content``.
+    - The name of the domain it belongs to, e.g., ``py`` or ``cpp``.
+    - The name of the object type in the domain, e.g., ``function``.
     """
 
 
 class desc_signature(nodes.Part, nodes.Inline, nodes.TextElement):
-    """Node for object signatures.
+    """Node for a single object signature.
 
-    The "term" part of the custom Sphinx definition list.
-
-    As default the signature is a single line signature,
-    but set ``is_multiline = True`` to describe a multi-line signature.
-    In that case all child nodes must be ``desc_signature_line`` nodes.
+    As default the signature is a single-line signature.
+    Set ``is_multiline = True`` to describe a multi-line signature.
+    In that case all child nodes must be :py:class:`desc_signature_line` nodes.
     """
 
     @property
@@ -144,22 +152,40 @@ def child_text_separator(self):
 
 
 class desc_signature_line(nodes.Part, nodes.Inline, nodes.FixedTextElement):
-    """Node for a line in a multi-line object signatures.
+    """Node for a line in a multi-line object signature.
 
-    It should only be used in a ``desc_signature`` with ``is_multiline`` set.
+    It should only be used as a child of a :py:class:`desc_signature`
+    with ``is_multiline`` set to ``True``.
     Set ``add_permalink = True`` for the line that should get the permalink.
     """
     sphinx_line_type = ''
 
 
+class desc_content(nodes.General, nodes.Element):
+    """Node for object description content.
+
+    Must be the last child node in a :py:class:`desc` node.
+    """
+
+# Nodes for high-level structure in signatures
+##############################################
+
 # nodes to use within a desc_signature or desc_signature_line
 
 class desc_name(nodes.Part, nodes.Inline, nodes.FixedTextElement):
-    """Node for the main object name."""
+    """Node for the main object name.
+
+    For example, in the declaration of a Python class ``MyModule.MyClass``,
+    the main name is ``MyClass``.
+    """
 
 
 class desc_addname(nodes.Part, nodes.Inline, nodes.FixedTextElement):
-    """Node for additional name parts (module name, class name)."""
+    """Node for additional name parts for an object.
+
+    For example, in the declaration of a Python class ``MyModule.MyClass``,
+    the additional name part is ``MyModule.``.
+    """
 
 
 # compatibility alias
@@ -201,12 +227,8 @@ class desc_annotation(nodes.Part, nodes.Inline, nodes.FixedTextElement):
     """Node for signature annotations (not Python 3-style annotations)."""
 
 
-class desc_content(nodes.General, nodes.Element):
-    """Node for object description content.
-
-    This is the "definition" part of the custom Sphinx definition list.
-    """
-
+# Leaf nodes for markup of text fragments
+#########################################
 
 # Signature text elements, generally translated to node.inline
 # in SigElementFallbackTransform.
@@ -281,6 +303,7 @@ class desc_sig_literal_char(desc_sig_element):
                 desc_sig_literal_number, desc_sig_literal_string, desc_sig_literal_char]
 
 
+###############################################################
 # new admonition-like constructs
 
 class versionmodified(nodes.Admonition, nodes.TextElement):
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index fa7360c4efd..745e76b3866 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -78,6 +78,13 @@ def visit_start_of_file(self, node: Element) -> None:
     def depart_start_of_file(self, node: Element) -> None:
         self.docnames.pop()
 
+    #############################################################
+    # Domain-specific object descriptions
+    #############################################################
+
+    # Top-level nodes for descriptions
+    ##################################
+
     def visit_desc(self, node: Element) -> None:
         self.body.append(self.starttag(node, 'dl', CLASS=node['objtype']))
 
@@ -104,6 +111,15 @@ def depart_desc_signature_line(self, node: Element) -> None:
             self.add_permalink_ref(node.parent, _('Permalink to this definition'))
         self.body.append('<br />')
 
+    # Nodes for high-level structure in signatures
+    ##############################################
+
+    def visit_desc_name(self, node: Element) -> None:
+        self.body.append(self.starttag(node, 'code', '', CLASS='sig-name descname'))
+
+    def depart_desc_name(self, node: Element) -> None:
+        self.body.append('</code>')
+
     def visit_desc_addname(self, node: Element) -> None:
         self.body.append(self.starttag(node, 'code', '', CLASS='sig-prename descclassname'))
 
@@ -122,12 +138,6 @@ def visit_desc_returns(self, node: Element) -> None:
     def depart_desc_returns(self, node: Element) -> None:
         pass
 
-    def visit_desc_name(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'code', '', CLASS='sig-name descname'))
-
-    def depart_desc_name(self, node: Element) -> None:
-        self.body.append('</code>')
-
     def visit_desc_parameterlist(self, node: Element) -> None:
         self.body.append('<span class="sig-paren">(</span>')
         self.first_param = 1

From d131ec7acbc2026c0cc05c58fa39f3d845f3e6ba Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 16:25:09 +0100
Subject: [PATCH 253/305] Decl styling, move desc dynamic classes to domain
 base class

---
 sphinx/addnodes.py            |  3 +++
 sphinx/directives/__init__.py |  1 +
 sphinx/writers/html.py        | 24 ++++++++++++++++++------
 sphinx/writers/html5.py       | 14 ++++++++------
 4 files changed, 30 insertions(+), 12 deletions(-)

diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index f818e496d06..ac41dd95140 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -134,6 +134,9 @@ class desc(nodes.Admonition, nodes.Element):
     - The name of the object type in the domain, e.g., ``function``.
     """
 
+    # TODO: can we introduce a constructor
+    #  that forces the specification of the domain and objtyp?
+
 
 class desc_signature(nodes.Part, nodes.Inline, nodes.TextElement):
     """Node for a single object signature.
diff --git a/sphinx/directives/__init__.py b/sphinx/directives/__init__.py
index e1ccc8be7a5..8e8d65f0356 100644
--- a/sphinx/directives/__init__.py
+++ b/sphinx/directives/__init__.py
@@ -172,6 +172,7 @@ def run(self) -> List[Node]:
         node['noindex'] = noindex = ('noindex' in self.options)
         if self.domain:
             node['classes'].append(self.domain)
+        node['classes'].append(node['objtype'])
 
         self.names: List[T] = []
         signatures = self.get_signatures()
diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py
index a92927cab8f..73e762c4232 100644
--- a/sphinx/writers/html.py
+++ b/sphinx/writers/html.py
@@ -107,8 +107,15 @@ def visit_start_of_file(self, node: Element) -> None:
     def depart_start_of_file(self, node: Element) -> None:
         self.docnames.pop()
 
+    #############################################################
+    # Domain-specific object descriptions
+    #############################################################
+
+    # Top-level nodes for descriptions
+    ##################################
+
     def visit_desc(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'dl', CLASS=node['objtype']))
+        self.body.append(self.starttag(node, 'dl'))
 
     def depart_desc(self, node: Element) -> None:
         self.body.append('</dl>\n\n')
@@ -133,6 +140,15 @@ def depart_desc_signature_line(self, node: Element) -> None:
             self.add_permalink_ref(node.parent, _('Permalink to this definition'))
         self.body.append('<br />')
 
+    def visit_desc_content(self, node: Element) -> None:
+        self.body.append(self.starttag(node, 'dd', ''))
+
+    def depart_desc_content(self, node: Element) -> None:
+        self.body.append('</dd>')
+
+    # Nodes for high-level structure in signatures
+    ##############################################
+
     def visit_desc_addname(self, node: Element) -> None:
         self.body.append(self.starttag(node, 'code', '', CLASS='descclassname'))
 
@@ -205,11 +221,7 @@ def visit_desc_annotation(self, node: Element) -> None:
     def depart_desc_annotation(self, node: Element) -> None:
         self.body.append('</em>')
 
-    def visit_desc_content(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'dd', ''))
-
-    def depart_desc_content(self, node: Element) -> None:
-        self.body.append('</dd>')
+    ##############################################
 
     def visit_versionmodified(self, node: Element) -> None:
         self.body.append(self.starttag(node, 'div', CLASS=node['type']))
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index 745e76b3866..c3c082967fb 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -86,7 +86,7 @@ def depart_start_of_file(self, node: Element) -> None:
     ##################################
 
     def visit_desc(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'dl', CLASS=node['objtype']))
+        self.body.append(self.starttag(node, 'dl'))
 
     def depart_desc(self, node: Element) -> None:
         self.body.append('</dl>\n\n')
@@ -111,6 +111,12 @@ def depart_desc_signature_line(self, node: Element) -> None:
             self.add_permalink_ref(node.parent, _('Permalink to this definition'))
         self.body.append('<br />')
 
+    def visit_desc_content(self, node: Element) -> None:
+        self.body.append(self.starttag(node, 'dd', ''))
+
+    def depart_desc_content(self, node: Element) -> None:
+        self.body.append('</dd>')
+
     # Nodes for high-level structure in signatures
     ##############################################
 
@@ -186,11 +192,7 @@ def visit_desc_annotation(self, node: Element) -> None:
     def depart_desc_annotation(self, node: Element) -> None:
         self.body.append('</em>')
 
-    def visit_desc_content(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'dd', ''))
-
-    def depart_desc_content(self, node: Element) -> None:
-        self.body.append('</dd>')
+    ##############################################
 
     def visit_versionmodified(self, node: Element) -> None:
         self.body.append(self.starttag(node, 'div', CLASS=node['type']))

From e012c93f1b69d943fe481982dce6d9dcf317ed51 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 16:42:00 +0100
Subject: [PATCH 254/305] Decl styling, move static classes to addnodes from
 HTML5 writer

---
 sphinx/addnodes.py      | 25 ++++++++++++++++++++++---
 sphinx/writers/html.py  | 14 +++++++-------
 sphinx/writers/html5.py |  4 ++--
 3 files changed, 31 insertions(+), 12 deletions(-)

diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index ac41dd95140..17f579c0ec7 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -119,6 +119,19 @@ def extract_original_messages(self) -> List[str]:
 # Domain-specific object descriptions (class, function etc.)
 #############################################################
 
+class _desc_classes_injector:
+    """Helper base class for injecting a fixes list of classes.
+
+    Use as the first base class.
+    """
+
+    classes = []  # type: List[str]
+
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self['classes'].extend(self.classes)
+
+
 # Top-level nodes
 #################
 
@@ -175,20 +188,26 @@ class desc_content(nodes.General, nodes.Element):
 
 # nodes to use within a desc_signature or desc_signature_line
 
-class desc_name(nodes.Part, nodes.Inline, nodes.FixedTextElement):
+class desc_name(_desc_classes_injector, nodes.Part, nodes.Inline, nodes.FixedTextElement):
     """Node for the main object name.
 
     For example, in the declaration of a Python class ``MyModule.MyClass``,
     the main name is ``MyClass``.
+
+    This node always has the class ``sig-name``.
     """
+    classes = ['sig-name', 'descname']  # 'descname' is for backwards compatibility
 
 
-class desc_addname(nodes.Part, nodes.Inline, nodes.FixedTextElement):
+class desc_addname(_desc_classes_injector, nodes.Part, nodes.Inline, nodes.FixedTextElement):
     """Node for additional name parts for an object.
 
     For example, in the declaration of a Python class ``MyModule.MyClass``,
     the additional name part is ``MyModule.``.
+
+    This node always has the class ``sig-prename``.
     """
+    classes = ['sig-prename', 'descclassname']  # 'descclassname' is for backwards compatibility
 
 
 # compatibility alias
@@ -237,7 +256,7 @@ class desc_annotation(nodes.Part, nodes.Inline, nodes.FixedTextElement):
 # in SigElementFallbackTransform.
 # When adding a new one, add it to SIG_ELEMENTS.
 
-class desc_sig_element(nodes.inline):
+class desc_sig_element(nodes.inline, _desc_classes_injector):
     """Common parent class of nodes for inline text of a signature."""
     classes: List[str] = []
 
diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py
index 73e762c4232..54d7311ea14 100644
--- a/sphinx/writers/html.py
+++ b/sphinx/writers/html.py
@@ -149,8 +149,14 @@ def depart_desc_content(self, node: Element) -> None:
     # Nodes for high-level structure in signatures
     ##############################################
 
+    def visit_desc_name(self, node: Element) -> None:
+        self.body.append(self.starttag(node, 'code', ''))
+
+    def depart_desc_name(self, node: Element) -> None:
+        self.body.append('</code>')
+
     def visit_desc_addname(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'code', '', CLASS='descclassname'))
+        self.body.append(self.starttag(node, 'code', ''))
 
     def depart_desc_addname(self, node: Element) -> None:
         self.body.append('</code>')
@@ -167,12 +173,6 @@ def visit_desc_returns(self, node: Element) -> None:
     def depart_desc_returns(self, node: Element) -> None:
         pass
 
-    def visit_desc_name(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'code', '', CLASS='descname'))
-
-    def depart_desc_name(self, node: Element) -> None:
-        self.body.append('</code>')
-
     def visit_desc_parameterlist(self, node: Element) -> None:
         self.body.append('<span class="sig-paren">(</span>')
         self.first_param = 1
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index c3c082967fb..e3a28f85dee 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -121,13 +121,13 @@ def depart_desc_content(self, node: Element) -> None:
     ##############################################
 
     def visit_desc_name(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'code', '', CLASS='sig-name descname'))
+        self.body.append(self.starttag(node, 'code', ''))
 
     def depart_desc_name(self, node: Element) -> None:
         self.body.append('</code>')
 
     def visit_desc_addname(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'code', '', CLASS='sig-prename descclassname'))
+        self.body.append(self.starttag(node, 'code', ''))
 
     def depart_desc_addname(self, node: Element) -> None:
         self.body.append('</code>')

From 98800be904eeb4aca33acaac60a06e42b181d0f3 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 17:19:34 +0100
Subject: [PATCH 255/305] Decl styling, make desc_inline node

Use the new node for cpp:expr
---
 CHANGES                                |  3 +++
 doc/extdev/nodes.rst                   |  1 +
 sphinx/addnodes.py                     | 30 +++++++++++++++++++++++---
 sphinx/domains/cpp.py                  |  7 ++----
 sphinx/themes/basic/static/basic.css_t |  6 ++++++
 sphinx/writers/html5.py                |  6 ++++++
 6 files changed, 45 insertions(+), 8 deletions(-)

diff --git a/CHANGES b/CHANGES
index 2743788ac54..fe87bf9b948 100644
--- a/CHANGES
+++ b/CHANGES
@@ -7,6 +7,9 @@ Dependencies
 Incompatible changes
 --------------------
 
+* #9023: Change the CSS classes on :rst:role:`cpp:expr` and
+  :rst:role:`cpp:texpr`.
+
 Deprecated
 ----------
 
diff --git a/doc/extdev/nodes.rst b/doc/extdev/nodes.rst
index d327e1cb0c7..77872df4033 100644
--- a/doc/extdev/nodes.rst
+++ b/doc/extdev/nodes.rst
@@ -17,6 +17,7 @@ These nodes form the top-most levels of object descriptions.
 .. autoclass:: desc_signature
 .. autoclass:: desc_signature_line
 .. autoclass:: desc_content
+.. autoclass:: desc_inline
 
 Nodes for high-level structure in signatures
 ............................................
diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 17f579c0ec7..2d117d7a92c 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -151,13 +151,16 @@ class desc(nodes.Admonition, nodes.Element):
     #  that forces the specification of the domain and objtyp?
 
 
-class desc_signature(nodes.Part, nodes.Inline, nodes.TextElement):
+class desc_signature(_desc_classes_injector, nodes.Part, nodes.Inline, nodes.TextElement):
     """Node for a single object signature.
 
     As default the signature is a single-line signature.
     Set ``is_multiline = True`` to describe a multi-line signature.
     In that case all child nodes must be :py:class:`desc_signature_line` nodes.
+
+    This node always has the classes ``sig`` and ``sig-object``.
     """
+    classes = ['sig', 'sig-object']
 
     @property
     def child_text_separator(self):
@@ -183,6 +186,22 @@ class desc_content(nodes.General, nodes.Element):
     Must be the last child node in a :py:class:`desc` node.
     """
 
+
+class desc_inline(_desc_classes_injector, nodes.Inline, nodes.TextElement):
+    """Node for a signature fragment in inline text.
+
+    This is for example used for roles like :rst:role:`cpp:expr`.
+
+    This node always has the classes ``sig``, ``sig-inline``,
+    and the name of the domain it belongs to.
+    """
+    classes = ['sig', 'sig-inline']
+
+    def __init__(self, domain: str, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self['classes'].append(domain)
+
+
 # Nodes for high-level structure in signatures
 ##############################################
 
@@ -507,20 +526,25 @@ class manpage(nodes.Inline, nodes.FixedTextElement):
 
 def setup(app: "Sphinx") -> Dict[str, Any]:
     app.add_node(toctree)
+
     app.add_node(desc)
     app.add_node(desc_signature)
     app.add_node(desc_signature_line)
+    app.add_node(desc_content)
+    app.add_node(desc_inline)
+
+    app.add_node(desc_name)
     app.add_node(desc_addname)
     app.add_node(desc_type)
     app.add_node(desc_returns)
-    app.add_node(desc_name)
     app.add_node(desc_parameterlist)
     app.add_node(desc_parameter)
     app.add_node(desc_optional)
     app.add_node(desc_annotation)
-    app.add_node(desc_content)
+
     for n in SIG_ELEMENTS:
         app.add_node(n)
+
     app.add_node(versionmodified)
     app.add_node(seealso)
     app.add_node(productionlist)
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index bb11138d61a..51cdd394644 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -7395,11 +7395,9 @@ def __init__(self, asCode: bool) -> None:
         if asCode:
             # render the expression as inline code
             self.class_type = 'cpp-expr'
-            self.node_type: Type[TextElement] = nodes.literal
         else:
             # render the expression as inline text
             self.class_type = 'cpp-texpr'
-            self.node_type = nodes.inline
 
     def run(self) -> Tuple[List[Node], List[system_message]]:
         text = self.text.replace('\n', ' ')
@@ -7407,20 +7405,19 @@ def run(self) -> Tuple[List[Node], List[system_message]]:
                                   location=self.get_source_info(),
                                   config=self.config)
         # attempt to mimic XRefRole classes, except that...
-        classes = ['xref', 'cpp', self.class_type]
         try:
             ast = parser.parse_expression()
         except DefinitionError as ex:
             logger.warning('Unparseable C++ expression: %r\n%s', text, ex,
                            location=self.get_source_info())
             # see below
-            return [self.node_type(text, text, classes=classes)], []
+            return [addnodes.desc_inline('cpp', text, text, classes=[self.class_type])], []
         parentSymbol = self.env.temp_data.get('cpp:parent_symbol', None)
         if parentSymbol is None:
             parentSymbol = self.env.domaindata['cpp']['root_symbol']
         # ...most if not all of these classes should really apply to the individual references,
         # not the container node
-        signode = self.node_type(classes=classes)
+        signode = addnodes.desc_inline('cpp', classes=[self.class_type])
         ast.describe_signature(signode, 'markType', self.env, parentSymbol)
         return [signode], []
 
diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index 4af85bea959..f0ce51e4bea 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -532,6 +532,12 @@ table.hlist td {
 	font-style: italic;
 }
 
+/* C++ specific styling */
+
+.sig-inline.cpp-expr {
+	font-family: monospace;
+}
+
 
 /* -- other body styles ----------------------------------------------------- */
 
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index e3a28f85dee..1c81584e3c1 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -117,6 +117,12 @@ def visit_desc_content(self, node: Element) -> None:
     def depart_desc_content(self, node: Element) -> None:
         self.body.append('</dd>')
 
+    def visit_desc_inline(self, node: Element) -> None:
+        self.body.append(self.starttag(node, 'span', ''))
+
+    def depart_desc_inline(self, node: Element) -> None:
+        self.body.append('</span>')
+
     # Nodes for high-level structure in signatures
     ##############################################
 

From b0a2e5cf040ab3ddb64ebc0ee4f60b59fa30eef9 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 17:42:26 +0100
Subject: [PATCH 256/305] Decl styling, consistent monospace

---
 CHANGES                                | 2 ++
 sphinx/themes/basic/static/basic.css_t | 8 ++++++--
 sphinx/writers/html5.py                | 8 ++++----
 3 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/CHANGES b/CHANGES
index fe87bf9b948..28e89863f33 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,8 @@ Deprecated
 Features added
 --------------
 
+* #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
+
 Bugs fixed
 ----------
 
diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index f0ce51e4bea..de7651e1753 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -510,6 +510,10 @@ table.hlist td {
 
 /* -- object description styles --------------------------------------------- */
 
+.sig {
+	font-family: monospace;
+}
+
 .sig-name, code.descname {
     background-color: transparent;
     font-weight: bold;
@@ -534,8 +538,8 @@ table.hlist td {
 
 /* C++ specific styling */
 
-.sig-inline.cpp-expr {
-	font-family: monospace;
+.sig-inline.cpp-texpr {
+	font-family: unset;
 }
 
 
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index 1c81584e3c1..4696425910b 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -127,16 +127,16 @@ def depart_desc_inline(self, node: Element) -> None:
     ##############################################
 
     def visit_desc_name(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'code', ''))
+        self.body.append(self.starttag(node, 'span', ''))
 
     def depart_desc_name(self, node: Element) -> None:
-        self.body.append('</code>')
+        self.body.append('</span>')
 
     def visit_desc_addname(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'code', ''))
+        self.body.append(self.starttag(node, 'span', ''))
 
     def depart_desc_addname(self, node: Element) -> None:
-        self.body.append('</code>')
+        self.body.append('</span>')
 
     def visit_desc_type(self, node: Element) -> None:
         pass

From 86eeee5031008bb0da73332cd8dd28bd3c9e5aed Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 17:53:11 +0100
Subject: [PATCH 257/305] Fix flake8 and mypy violations

---
 sphinx/addnodes.py    |  9 +++++----
 sphinx/domains/cpp.py | 24 ++++++++++++------------
 2 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 2d117d7a92c..69d11eb53a8 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -119,7 +119,7 @@ def extract_original_messages(self) -> List[str]:
 # Domain-specific object descriptions (class, function etc.)
 #############################################################
 
-class _desc_classes_injector:
+class _desc_classes_injector(nodes.TextElement):
     """Helper base class for injecting a fixes list of classes.
 
     Use as the first base class.
@@ -127,7 +127,7 @@ class _desc_classes_injector:
 
     classes = []  # type: List[str]
 
-    def __init__(self, *args, **kwargs) -> None:
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
         self['classes'].extend(self.classes)
 
@@ -197,7 +197,7 @@ class desc_inline(_desc_classes_injector, nodes.Inline, nodes.TextElement):
     """
     classes = ['sig', 'sig-inline']
 
-    def __init__(self, domain: str, *args, **kwargs):
+    def __init__(self, domain: str, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
         self['classes'].append(domain)
 
@@ -226,7 +226,8 @@ class desc_addname(_desc_classes_injector, nodes.Part, nodes.Inline, nodes.Fixed
 
     This node always has the class ``sig-prename``.
     """
-    classes = ['sig-prename', 'descclassname']  # 'descclassname' is for backwards compatibility
+    # 'descclassname' is for backwards compatibility
+    classes = ['sig-prename', 'descclassname']
 
 
 # compatibility alias
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index 51cdd394644..aa88838f42e 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -9,7 +9,7 @@
 """
 
 import re
-from typing import (Any, Callable, Dict, Generator, Iterator, List, Optional, Tuple, Type,
+from typing import (Any, Callable, Dict, Generator, Iterator, List, Optional, Tuple,
                     TypeVar, Union, cast)
 
 from docutils import nodes
@@ -1623,9 +1623,9 @@ def describe_signature(self, signode: TextElement, mode: str,
                            symbol: "Symbol") -> None:
         verify_description_mode(mode)
         if mode == 'lastIsName':
-            identnode = addnodes.desc_name()
-            self._describe_identifier(identnode, identnode, env, symbol)
-            signode += identnode
+            mainName = addnodes.desc_name()
+            self._describe_identifier(mainName, mainName, env, symbol)
+            signode += mainName
         elif mode == 'markType':
             targetText = prefix + str(self) + templateArgs
             pnode = addnodes.pending_xref('', refdomain='cpp',
@@ -1637,15 +1637,15 @@ def describe_signature(self, signode: TextElement, mode: str,
             # and make that the a link to this operator.
             # E.g., if it is 'operator SomeType', then 'SomeType' becomes
             # a link to the operator, not to 'SomeType'.
-            identnode = nodes.literal()
-            self._describe_identifier(signode, identnode, env, symbol)
-            txt = identnode.astext()
+            container = nodes.literal()
+            self._describe_identifier(signode, container, env, symbol)
+            txt = container.astext()
             pnode += addnodes.desc_name(txt, txt)
             signode += pnode
         else:
-            identnode = addnodes.desc_addname()
-            self._describe_identifier(identnode, identnode, env, symbol)
-            signode += identnode
+            addName = addnodes.desc_addname()
+            self._describe_identifier(addName, addName, env, symbol)
+            signode += addName
 
 
 class ASTOperatorBuildIn(ASTOperator):
@@ -7690,8 +7690,8 @@ def checkType() -> bool:
             # and reconstruct the title again
             contnode += nodes.Text(title)
         res = make_refnode(builder, fromdocname, docname,
-                            declaration.get_newest_id(), contnode, displayName
-                            ), declaration.objectType
+                           declaration.get_newest_id(), contnode, displayName
+                           ), declaration.objectType
         return res
 
     def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,

From c1da955df2f14ffc5a686b8724d46369abf847d4 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 18:02:07 +0100
Subject: [PATCH 258/305] Decl styling, use a post-transform to get the domain
 name in the desc_signature nodes

---
 sphinx/addnodes.py                            |  3 ++-
 sphinx/transforms/post_transforms/__init__.py | 10 ++++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 69d11eb53a8..23cf0acb81e 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -158,8 +158,9 @@ class desc_signature(_desc_classes_injector, nodes.Part, nodes.Inline, nodes.Tex
     Set ``is_multiline = True`` to describe a multi-line signature.
     In that case all child nodes must be :py:class:`desc_signature_line` nodes.
 
-    This node always has the classes ``sig`` and ``sig-object``.
+    This node always has the classes ``sig``, ``sig-object``, and the domain it belongs to.
     """
+    # Note: the domain name is being added through a post-transform DescSigAddDomainAsClass
     classes = ['sig', 'sig-object']
 
     @property
diff --git a/sphinx/transforms/post_transforms/__init__.py b/sphinx/transforms/post_transforms/__init__.py
index 76a709f5f2c..b70677e4f56 100644
--- a/sphinx/transforms/post_transforms/__init__.py
+++ b/sphinx/transforms/post_transforms/__init__.py
@@ -232,10 +232,20 @@ def fallback(self) -> None:
             node.replace_self(newnode)
 
 
+class DescSigAddDomainAsClass(SphinxPostTransform):
+    """Add the domain name of the parent node as a class in each desc_signature node."""
+    default_priority = 200
+
+    def run(self, **kwargs: Any) -> None:
+        for node in self.document.traverse(addnodes.desc_signature):
+            node['classes'].append(node.parent['domain'])
+
+
 def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_post_transform(ReferencesResolver)
     app.add_post_transform(OnlyNodeTransform)
     app.add_post_transform(SigElementFallbackTransform)
+    app.add_post_transform(DescSigAddDomainAsClass)
 
     return {
         'version': 'builtin',

From 70708e4b24f70aa84b7c46c0b83175eaba32baf6 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 18:07:11 +0100
Subject: [PATCH 259/305] Decl styling, add CSS for the C++ domain

---
 sphinx/themes/basic/static/basic.css_t | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index de7651e1753..7f505f6b15c 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -542,6 +542,18 @@ table.hlist td {
 	font-family: unset;
 }
 
+.sig.cpp .k, .sig.cpp .kt {
+	color: #0033B3;
+}
+
+.sig.cpp .m {
+	color: #1750EB;
+}
+
+.sig.cpp .s {
+	color: #067D17;
+}
+
 
 /* -- other body styles ----------------------------------------------------- */
 

From 87414faa92fe987b70dc2d4cb61d08a609a5e56c Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 19:27:13 +0100
Subject: [PATCH 260/305] Decl styling, fix cpp tests

---
 tests/test_domain_cpp.py      | 5 ++---
 tests/test_ext_intersphinx.py | 4 ++--
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/tests/test_domain_cpp.py b/tests/test_domain_cpp.py
index 7ecf89f543f..52aaad8505f 100644
--- a/tests/test_domain_cpp.py
+++ b/tests/test_domain_cpp.py
@@ -1210,7 +1210,7 @@ def __init__(self, role, root, contents):
     cpp_any_role = RoleClasses('cpp-any', 'a', ['code'])
     # NYI: consistent looks
     # texpr_role = RoleClasses('cpp-texpr', 'span', ['a', 'code'])
-    expr_role = RoleClasses('cpp-expr', 'code', ['a'])
+    expr_role = RoleClasses('cpp-expr', 'span', ['a'])
     texpr_role = RoleClasses('cpp-texpr', 'span', ['a', 'span'])
 
     # XRefRole-style classes
@@ -1227,8 +1227,7 @@ def __init__(self, role, root, contents):
     for role in (expr_role, texpr_role):
         name = role.name
         expect = '`{name}` puts the domain and role classes at its root'.format(name=name)
-        # NYI: xref should go in the references
-        assert {'xref', 'cpp', name} <= role.classes, expect
+        assert {'sig', 'sig-inline', 'cpp', name} <= role.classes, expect
 
     # reference classes
 
diff --git a/tests/test_ext_intersphinx.py b/tests/test_ext_intersphinx.py
index 785faed62b4..62456a3f47d 100644
--- a/tests/test_ext_intersphinx.py
+++ b/tests/test_ext_intersphinx.py
@@ -258,10 +258,10 @@ def test_missing_reference_cppdomain(tempdir, app, status, warning):
             '<span class="pre">Bar</span></code></a>' in html)
     assert ('<a class="reference external"'
             ' href="https://docs.python.org/index.html#foons"'
-            ' title="(in foo v2.0)"><span class="n">foons</span></a>' in html)
+            ' title="(in foo v2.0)"><span class="n"><span class="pre">foons</span></span></a>' in html)
     assert ('<a class="reference external"'
             ' href="https://docs.python.org/index.html#foons_bartype"'
-            ' title="(in foo v2.0)"><span class="n">bartype</span></a>' in html)
+            ' title="(in foo v2.0)"><span class="n"><span class="pre">bartype</span></span></a>' in html)
 
 
 def test_missing_reference_jsdomain(tempdir, app, status, warning):

From 3fdc9bcf9fca90e30246b972651cbb29756c56fd Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 19:43:41 +0100
Subject: [PATCH 261/305] Fix desc_sig_space

---
 sphinx/addnodes.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 23cf0acb81e..5d26643ede8 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -294,8 +294,9 @@ class desc_sig_space(desc_sig_element):
     """Node for a space in a signature."""
     classes = ["w"]
 
-    def __init__(self) -> None:
-        super().__init__(' ', ' ')
+    def __init__(self, rawsource: str = '', text: str = ' ',
+                 *children: Element, **attributes: Any) -> None:
+        super().__init__(rawsource, text, *children, **attributes)
 
 
 class desc_sig_name(desc_sig_element):

From f769dde254e6f25f5b8e6e29718b90b425c3f235 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 19:48:54 +0100
Subject: [PATCH 262/305] Decl styling, fix html test

---
 tests/test_build_html.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/test_build_html.py b/tests/test_build_html.py
index b01d6f4ebd6..c74552d9e83 100644
--- a/tests/test_build_html.py
+++ b/tests/test_build_html.py
@@ -285,10 +285,10 @@ def test_html4_output(app, status, warning):
     'objects.html': [
         (".//dt[@id='mod.Cls.meth1']", ''),
         (".//dt[@id='errmod.Error']", ''),
-        (".//dt/code/span", r'long\(parameter,'),
-        (".//dt/code/span", r'list\)'),
-        (".//dt/code/span", 'another'),
-        (".//dt/code/span", 'one'),
+        (".//dt/span[@class='sig-name descname']/span[@class='pre']", r'long\(parameter,'),
+        (".//dt/span[@class='sig-name descname']/span[@class='pre']", r'list\)'),
+        (".//dt/span[@class='sig-name descname']/span[@class='pre']", 'another'),
+        (".//dt/span[@class='sig-name descname']/span[@class='pre']", 'one'),
         (".//a[@href='#mod.Cls'][@class='reference internal']", ''),
         (".//dl[@class='std userdesc']", ''),
         (".//dt[@id='userdesc-myobj']", ''),

From c0ef6a92656cbada6702d0102b19d58c881763ed Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sat, 20 Mar 2021 20:08:26 +0100
Subject: [PATCH 263/305] Fix isort violation

---
 sphinx/domains/cpp.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index aa88838f42e..057cc203737 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -9,8 +9,8 @@
 """
 
 import re
-from typing import (Any, Callable, Dict, Generator, Iterator, List, Optional, Tuple,
-                    TypeVar, Union, cast)
+from typing import (Any, Callable, Dict, Generator, Iterator, List, Optional, Tuple, TypeVar,
+                    Union, cast)
 
 from docutils import nodes
 from docutils.nodes import Element, Node, TextElement, system_message

From 7126503eeb2b13bba35dc18c87631c6e728bf6f0 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Thu, 25 Mar 2021 19:42:50 +0100
Subject: [PATCH 264/305] Decl styling, update writers

Add test objects so all builders gets exposed to the new nodes.
Make the fallback node post-transform change desc_inline as well.
Make the html4, latex, and text writers handle desc_inline.
---
 sphinx/transforms/post_transforms/__init__.py | 17 +++----
 sphinx/writers/html.py                        |  6 +++
 sphinx/writers/latex.py                       | 48 +++++++++++++------
 sphinx/writers/manpage.py                     | 34 ++++++++-----
 sphinx/writers/text.py                        | 30 +++++++++---
 tests/roots/test-root/objects.txt             |  6 +++
 6 files changed, 101 insertions(+), 40 deletions(-)

diff --git a/sphinx/transforms/post_transforms/__init__.py b/sphinx/transforms/post_transforms/__init__.py
index b70677e4f56..bcc9caf0052 100644
--- a/sphinx/transforms/post_transforms/__init__.py
+++ b/sphinx/transforms/post_transforms/__init__.py
@@ -206,7 +206,7 @@ def run(self, **kwargs: Any) -> None:
 
 
 class SigElementFallbackTransform(SphinxPostTransform):
-    """Fallback desc_sig_element nodes to inline if translator does not supported them."""
+    """Fallback various desc_* nodes to inline if translator does not supported them."""
     default_priority = 200
 
     def run(self, **kwargs: Any) -> None:
@@ -218,14 +218,15 @@ def has_visitor(translator: Type[nodes.NodeVisitor], node: Type[Element]) -> boo
             # subclass of SphinxTranslator supports desc_sig_element nodes automatically.
             return
 
-        if all(has_visitor(translator, node) for node in addnodes.SIG_ELEMENTS):
-            # the translator supports all desc_sig_element nodes
-            return
-        else:
-            self.fallback()
+        # for the leaf elements (desc_sig_element), the translator should support _all_
+        if not all(has_visitor(translator, node) for node in addnodes.SIG_ELEMENTS):
+            self.fallback(addnodes.desc_sig_element)
+
+        if not has_visitor(translator, addnodes.desc_inline):
+            self.fallback(addnodes.desc_inline)
 
-    def fallback(self) -> None:
-        for node in self.document.traverse(addnodes.desc_sig_element):
+    def fallback(self, nodeType: Any) -> None:
+        for node in self.document.traverse(nodeType):
             newnode = nodes.inline()
             newnode.update_all_atts(node)
             newnode.extend(node)
diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py
index 54d7311ea14..d633f07e8e0 100644
--- a/sphinx/writers/html.py
+++ b/sphinx/writers/html.py
@@ -146,6 +146,12 @@ def visit_desc_content(self, node: Element) -> None:
     def depart_desc_content(self, node: Element) -> None:
         self.body.append('</dd>')
 
+    def visit_desc_inline(self, node: Element) -> None:
+        self.body.append(self.starttag(node, 'span', ''))
+
+    def depart_desc_inline(self, node: Element) -> None:
+        self.body.append('</span>')
+
     # Nodes for high-level structure in signatures
     ##############################################
 
diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py
index edef5417f72..546db9e31be 100644
--- a/sphinx/writers/latex.py
+++ b/sphinx/writers/latex.py
@@ -698,6 +698,13 @@ def visit_subtitle(self, node: Element) -> None:
     def depart_subtitle(self, node: Element) -> None:
         self.body.append(self.context.pop())
 
+    #############################################################
+    # Domain-specific object descriptions
+    #############################################################
+
+    # Top-level nodes for descriptions
+    ##################################
+
     def visit_desc(self, node: Element) -> None:
         if self.config.latex_show_urls == 'footnote':
             self.body.append(BLANKLINE)
@@ -750,6 +757,31 @@ def visit_desc_signature_line(self, node: Element) -> None:
     def depart_desc_signature_line(self, node: Element) -> None:
         self._depart_signature_line(node)
 
+    def visit_desc_content(self, node: Element) -> None:
+        if node.children and not isinstance(node.children[0], nodes.paragraph):
+            # avoid empty desc environment which causes a formatting bug
+            self.body.append('~')
+
+    def depart_desc_content(self, node: Element) -> None:
+        pass
+
+    def visit_desc_inline(self, node: Element) -> None:
+        self.body.append(r'\sphinxcode{\sphinxupquote{')
+
+    def depart_desc_inline(self, node: Element) -> None:
+        self.body.append('}}')
+
+    # Nodes for high-level structure in signatures
+    ##############################################
+
+    def visit_desc_name(self, node: Element) -> None:
+        self.body.append(r'\sphinxbfcode{\sphinxupquote{')
+        self.literal_whitespace += 1
+
+    def depart_desc_name(self, node: Element) -> None:
+        self.body.append('}}')
+        self.literal_whitespace -= 1
+
     def visit_desc_addname(self, node: Element) -> None:
         self.body.append(r'\sphinxcode{\sphinxupquote{')
         self.literal_whitespace += 1
@@ -770,14 +802,6 @@ def visit_desc_returns(self, node: Element) -> None:
     def depart_desc_returns(self, node: Element) -> None:
         self.body.append(r'}')
 
-    def visit_desc_name(self, node: Element) -> None:
-        self.body.append(r'\sphinxbfcode{\sphinxupquote{')
-        self.literal_whitespace += 1
-
-    def depart_desc_name(self, node: Element) -> None:
-        self.body.append('}}')
-        self.literal_whitespace -= 1
-
     def visit_desc_parameterlist(self, node: Element) -> None:
         # close name, open parameterlist
         self.body.append('}{')
@@ -811,13 +835,7 @@ def visit_desc_annotation(self, node: Element) -> None:
     def depart_desc_annotation(self, node: Element) -> None:
         self.body.append('}}')
 
-    def visit_desc_content(self, node: Element) -> None:
-        if node.children and not isinstance(node.children[0], nodes.paragraph):
-            # avoid empty desc environment which causes a formatting bug
-            self.body.append('~')
-
-    def depart_desc_content(self, node: Element) -> None:
-        pass
+    ##############################################
 
     def visit_seealso(self, node: Element) -> None:
         self.body.append(BLANKLINE)
diff --git a/sphinx/writers/manpage.py b/sphinx/writers/manpage.py
index c11c4989268..a43f117ae57 100644
--- a/sphinx/writers/manpage.py
+++ b/sphinx/writers/manpage.py
@@ -120,6 +120,13 @@ def visit_start_of_file(self, node: Element) -> None:
     def depart_start_of_file(self, node: Element) -> None:
         pass
 
+    #############################################################
+    # Domain-specific object descriptions
+    #############################################################
+
+    # Top-level nodes for descriptions
+    ##################################
+
     def visit_desc(self, node: Element) -> None:
         self.visit_definition_list(node)
 
@@ -139,6 +146,21 @@ def visit_desc_signature_line(self, node: Element) -> None:
     def depart_desc_signature_line(self, node: Element) -> None:
         self.body.append(' ')
 
+    def visit_desc_content(self, node: Element) -> None:
+        self.visit_definition(node)
+
+    def depart_desc_content(self, node: Element) -> None:
+        self.depart_definition(node)
+
+    # Nodes for high-level structure in signatures
+    ##############################################
+
+    def visit_desc_name(self, node: Element) -> None:
+        pass
+
+    def depart_desc_name(self, node: Element) -> None:
+        pass
+
     def visit_desc_addname(self, node: Element) -> None:
         pass
 
@@ -157,12 +179,6 @@ def visit_desc_returns(self, node: Element) -> None:
     def depart_desc_returns(self, node: Element) -> None:
         pass
 
-    def visit_desc_name(self, node: Element) -> None:
-        pass
-
-    def depart_desc_name(self, node: Element) -> None:
-        pass
-
     def visit_desc_parameterlist(self, node: Element) -> None:
         self.body.append('(')
         self.first_param = 1
@@ -191,11 +207,7 @@ def visit_desc_annotation(self, node: Element) -> None:
     def depart_desc_annotation(self, node: Element) -> None:
         pass
 
-    def visit_desc_content(self, node: Element) -> None:
-        self.visit_definition(node)
-
-    def depart_desc_content(self, node: Element) -> None:
-        self.depart_definition(node)
+    ##############################################
 
     def visit_versionmodified(self, node: Element) -> None:
         self.visit_paragraph(node)
diff --git a/sphinx/writers/text.py b/sphinx/writers/text.py
index 5bd96de7689..d8dab91816a 100644
--- a/sphinx/writers/text.py
+++ b/sphinx/writers/text.py
@@ -536,6 +536,13 @@ def visit_attribution(self, node: Element) -> None:
     def depart_attribution(self, node: Element) -> None:
         pass
 
+    #############################################################
+    # Domain-specific object descriptions
+    #############################################################
+
+    # Top-level nodes
+    #################
+
     def visit_desc(self, node: Element) -> None:
         pass
 
@@ -555,6 +562,22 @@ def visit_desc_signature_line(self, node: Element) -> None:
     def depart_desc_signature_line(self, node: Element) -> None:
         self.add_text('\n')
 
+    def visit_desc_content(self, node: Element) -> None:
+        self.new_state()
+        self.add_text(self.nl)
+
+    def depart_desc_content(self, node: Element) -> None:
+        self.end_state()
+
+    def visit_desc_inline(self, node: Element) -> None:
+        pass
+
+    def depart_desc_inline(self, node: Element) -> None:
+        pass
+
+    # Nodes for high-level structure in signatures
+    ##############################################
+
     def visit_desc_name(self, node: Element) -> None:
         pass
 
@@ -606,12 +629,7 @@ def visit_desc_annotation(self, node: Element) -> None:
     def depart_desc_annotation(self, node: Element) -> None:
         pass
 
-    def visit_desc_content(self, node: Element) -> None:
-        self.new_state()
-        self.add_text(self.nl)
-
-    def depart_desc_content(self, node: Element) -> None:
-        self.end_state()
+    ##############################################
 
     def visit_figure(self, node: Element) -> None:
         self.new_state()
diff --git a/tests/roots/test-root/objects.txt b/tests/roots/test-root/objects.txt
index adb090a44fc..d5ec2a48634 100644
--- a/tests/roots/test-root/objects.txt
+++ b/tests/roots/test-root/objects.txt
@@ -213,3 +213,9 @@ CPP domain
 
    .. cpp:function:: T& operator[]( unsigned j )
                      const T& operator[]( unsigned j ) const
+
+.. cpp:function:: template<typename T1, typename T2> \
+                     requires A<T1, T2> \
+                  void f()
+
+- :cpp:expr:`a + b`

From a1ac0fd1ec97edf783a93cfc9fdd5c65621e4ff5 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Tue, 30 Mar 2021 11:50:36 +0200
Subject: [PATCH 265/305] Decl styling, C++, fix alternate spellings of
 operators

---
 sphinx/domains/cpp.py | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index 057cc203737..1c876081bd7 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -1246,10 +1246,12 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode += addnodes.desc_sig_operator(self.op, self.op)
         if self.op[0] in 'cn':
+            signode += addnodes.desc_sig_keyword(self.op, self.op)
             signode += addnodes.desc_sig_space()
-        self.expr.describe_signature(signode, mode, env, symbol)
+        else:
+            signode += addnodes.desc_sig_operator(self.op, self.op)
+            self.expr.describe_signature(signode, mode, env, symbol)
 
 
 class ASTSizeofParamPack(ASTExpression):
@@ -1484,7 +1486,11 @@ def describe_signature(self, signode: TextElement, mode: str,
         self.exprs[0].describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
             signode += addnodes.desc_sig_space()
-            signode += addnodes.desc_sig_operator(self.ops[i - 1], self.ops[i - 1])
+            op = self.ops[i - 1]
+            if ord(op[0]) >= ord('a') and ord(op[0]) <= ord('z'):
+                signode += addnodes.desc_sig_keyword(op, op)
+            else:
+                signode += addnodes.desc_sig_operator(op, op)
             signode += addnodes.desc_sig_space()
             self.exprs[i].describe_signature(signode, mode, env, symbol)
 
@@ -1550,7 +1556,11 @@ def describe_signature(self, signode: TextElement, mode: str,
         self.exprs[0].describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
             signode += addnodes.desc_sig_space()
-            signode += addnodes.desc_sig_operator(self.ops[i - 1], self.ops[i - 1])
+            op = self.ops[i - 1]
+            if ord(op[0]) >= ord('a') and ord(op[0]) <= ord('z'):
+                signode += addnodes.desc_sig_keyword(op, op)
+            else:
+                signode += addnodes.desc_sig_operator(op, op)
             signode += addnodes.desc_sig_space()
             self.exprs[i].describe_signature(signode, mode, env, symbol)
 

From 9cd9e124ff45553bf5a4385d37eeca6be47f9a80 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Tue, 30 Mar 2021 14:12:56 +0200
Subject: [PATCH 266/305] Decl styling, convert C

---
 sphinx/domains/c.py | 223 +++++++++++++++++++++++---------------------
 1 file changed, 118 insertions(+), 105 deletions(-)

diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index 72b9746ac1d..d3aad012ba8 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -9,8 +9,7 @@
 """
 
 import re
-from typing import (Any, Callable, Dict, Generator, Iterator, List, Tuple, Type, TypeVar,
-                    Union, cast)
+from typing import Any, Callable, Dict, Generator, Iterator, List, Tuple, TypeVar, Union, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, TextElement, system_message
@@ -132,6 +131,10 @@ def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnviron
                            prefix: str, symbol: "Symbol") -> None:
         # note: slightly different signature of describe_signature due to the prefix
         verify_description_mode(mode)
+        if self.is_anon():
+            node = addnodes.desc_sig_name(text="[anonymous]")
+        else:
+            node = addnodes.desc_sig_name(self.identifier, self.identifier)
         if mode == 'markType':
             targetText = prefix + self.identifier
             pnode = addnodes.pending_xref('', refdomain='c',
@@ -139,21 +142,14 @@ def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnviron
                                           reftarget=targetText, modname=None,
                                           classname=None)
             pnode['c:parent_key'] = symbol.get_lookup_key()
-            if self.is_anon():
-                pnode += nodes.strong(text="[anonymous]")
-            else:
-                pnode += nodes.Text(self.identifier)
+            pnode += node
             signode += pnode
         elif mode == 'lastIsName':
-            if self.is_anon():
-                signode += nodes.strong(text="[anonymous]")
-            else:
-                signode += addnodes.desc_name(self.identifier, self.identifier)
+            nameNode = addnodes.desc_name()
+            nameNode += node
+            signode += nameNode
         elif mode == 'noneIsName':
-            if self.is_anon():
-                signode += nodes.strong(text="[anonymous]")
-            else:
-                signode += nodes.Text(self.identifier)
+            signode += node
         else:
             raise Exception('Unknown description mode: %s' % mode)
 
@@ -184,18 +180,18 @@ def describe_signature(self, signode: TextElement, mode: str,
         # just print the name part, with template args, not template params
         if mode == 'noneIsName':
             if self.rooted:
+                assert False, "Can this happen?"  # TODO
                 signode += nodes.Text('.')
             for i in range(len(self.names)):
                 if i != 0:
+                    assert False, "Can this happen?"  # TODO
                     signode += nodes.Text('.')
                 n = self.names[i]
                 n.describe_signature(signode, mode, env, '', symbol)
         elif mode == 'param':
             assert not self.rooted, str(self)
             assert len(self.names) == 1
-            node = nodes.emphasis()
-            self.names[0].describe_signature(node, 'noneIsName', env, '', symbol)
-            signode += node
+            self.names[0].describe_signature(signode, 'noneIsName', env, '', symbol)
         elif mode == 'markType' or mode == 'lastIsName' or mode == 'markName':
             # Each element should be a pending xref targeting the complete
             # prefix.
@@ -213,13 +209,13 @@ def describe_signature(self, signode: TextElement, mode: str,
             if self.rooted:
                 prefix += '.'
                 if mode == 'lastIsName' and len(names) == 0:
-                    signode += nodes.Text('.')
+                    signode += addnodes.desc_sig_punctuation('.', '.')
                 else:
-                    dest += nodes.Text('.')
+                    dest += addnodes.desc_sig_punctuation('.', '.')
             for i in range(len(names)):
                 ident = names[i]
                 if not first:
-                    dest += nodes.Text('.')
+                    dest += addnodes.desc_sig_punctuation('.', '.')
                     prefix += '.'
                 first = False
                 txt_ident = str(ident)
@@ -228,7 +224,7 @@ def describe_signature(self, signode: TextElement, mode: str,
                 prefix += txt_ident
             if mode == 'lastIsName':
                 if len(self.names) > 1:
-                    dest += addnodes.desc_addname('.', '.')
+                    dest += addnodes.desc_sig_punctuation('.', '.')
                     signode += dest
                 self.names[-1].describe_signature(signode, mode, env, '', symbol)
         else:
@@ -262,7 +258,8 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text(str(self)))
+        txt = str(self)
+        signode += addnodes.desc_sig_keyword(txt, txt)
 
 
 class ASTNumberLiteral(ASTLiteral):
@@ -275,7 +272,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         txt = str(self)
-        signode.append(nodes.Text(txt, txt))
+        signode += addnodes.desc_sig_literal_number(txt, txt)
 
 
 class ASTCharLiteral(ASTLiteral):
@@ -297,7 +294,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         txt = str(self)
-        signode.append(nodes.Text(txt, txt))
+        signode += addnodes.desc_sig_literal_char(txt, txt)
 
 
 class ASTStringLiteral(ASTLiteral):
@@ -310,7 +307,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         txt = str(self)
-        signode.append(nodes.Text(txt, txt))
+        signode += addnodes.desc_sig_literal_string(txt, txt)
 
 
 class ASTIdExpression(ASTExpression):
@@ -341,9 +338,9 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('(', '('))
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.expr.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')', ')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 # Postfix expressions
@@ -374,9 +371,9 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('['))
+        signode += addnodes.desc_sig_punctuation('[', '[')
         self.expr.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(']'))
+        signode += addnodes.desc_sig_punctuation(']', ']')
 
 
 class ASTPostfixInc(ASTPostfixOp):
@@ -385,7 +382,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('++'))
+        signode += addnodes.desc_sig_operator('++', '++')
 
 
 class ASTPostfixDec(ASTPostfixOp):
@@ -394,7 +391,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('--'))
+        signode += addnodes.desc_sig_operator('--', '--')
 
 
 class ASTPostfixMemberOfPointer(ASTPostfixOp):
@@ -406,7 +403,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('->'))
+        signode += addnodes.desc_sig_operator('->', '->')
         self.name.describe_signature(signode, 'noneIsName', env, symbol)
 
 
@@ -444,10 +441,12 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text(self.op))
         if self.op[0] in 'cn':
-            signode.append(nodes.Text(" "))
-        self.expr.describe_signature(signode, mode, env, symbol)
+            signode += addnodes.desc_sig_keyword(self.op, self.op)
+            signode += addnodes.desc_sig_space()
+        else:
+            signode += addnodes.desc_sig_operator(self.op, self.op)
+            self.expr.describe_signature(signode, mode, env, symbol)
 
 
 class ASTSizeofType(ASTExpression):
@@ -459,9 +458,10 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('sizeof('))
+        signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTSizeofExpr(ASTExpression):
@@ -473,7 +473,8 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('sizeof '))
+        signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
+        signode += addnodes.desc_sig_space()
         self.expr.describe_signature(signode, mode, env, symbol)
 
 
@@ -486,9 +487,10 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('alignof('))
+        signode += addnodes.desc_sig_keyword('alignof', 'alignof')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 # Other expressions
@@ -508,9 +510,9 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode.append(nodes.Text('('))
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
         self.expr.describe_signature(signode, mode, env, symbol)
 
 
@@ -535,9 +537,13 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         self.exprs[0].describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
-            signode.append(nodes.Text(' '))
-            signode.append(nodes.Text(self.ops[i - 1]))
-            signode.append(nodes.Text(' '))
+            signode += addnodes.desc_sig_space()
+            op = self.ops[i - 1]
+            if ord(op[0]) >= ord('a') and ord(op[0]) <= ord('z'):
+                signode += addnodes.desc_sig_keyword(op, op)
+            else:
+                signode += addnodes.desc_sig_operator(op, op)
+            signode += addnodes.desc_sig_space()
             self.exprs[i].describe_signature(signode, mode, env, symbol)
 
 
@@ -562,9 +568,13 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         self.exprs[0].describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
-            signode.append(nodes.Text(' '))
-            signode.append(nodes.Text(self.ops[i - 1]))
-            signode.append(nodes.Text(' '))
+            signode += addnodes.desc_sig_space()
+            op = self.ops[i - 1]
+            if ord(op[0]) >= ord('a') and ord(op[0]) <= ord('z'):
+                signode += addnodes.desc_sig_keyword(op, op)
+            else:
+                signode += addnodes.desc_sig_operator(op, op)
+            signode += addnodes.desc_sig_space()
             self.exprs[i].describe_signature(signode, mode, env, symbol)
 
 
@@ -580,7 +590,7 @@ def get_id(self, version: int) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode += nodes.Text(self.expr)
+        signode += nodes.literal(self.expr, self.expr)
 
 
 ################################################################################
@@ -600,7 +610,7 @@ def _stringify(self, transform: StringifyTransform) -> str:
 
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
-        signode += nodes.Text(str(self.name))
+        signode += addnodes.desc_sig_keyword_type(self.name, self.name)
 
 
 class ASTTrailingTypeSpecName(ASTTrailingTypeSpec):
@@ -623,8 +633,8 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         if self.prefix:
-            signode += addnodes.desc_annotation(self.prefix, self.prefix)
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_keyword(self.prefix, self.prefix)
+            signode += addnodes.desc_sig_space()
         self.nestedName.describe_signature(signode, mode, env, symbol=symbol)
 
 
@@ -647,7 +657,7 @@ def describe_signature(self, signode: Any, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
         if self.ellipsis:
-            signode += nodes.Text('...')
+            signode += addnodes.desc_sig_punctuation('...', '...')
         else:
             self.arg.describe_signature(signode, mode, env, symbol=symbol)
 
@@ -688,17 +698,18 @@ def describe_signature(self, signode: TextElement, mode: str,
                 paramlist += param
             signode += paramlist
         else:
-            signode += nodes.Text('(', '(')
+            signode += addnodes.desc_sig_punctuation('(', '(')
             first = True
             for arg in self.args:
                 if not first:
-                    signode += nodes.Text(', ', ', ')
+                    signode += addnodes.desc_sig_punctuation(',', ',')
+                    signode += addnodes.desc_sig_space()
                 first = False
                 arg.describe_signature(signode, 'markType', env, symbol=symbol)
-            signode += nodes.Text(')', ')')
+            signode += addnodes.desc_sig_punctuation(')', ')')
 
         for attr in self.attrs:
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
             attr.describe_signature(signode)
 
 
@@ -744,12 +755,12 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, modifiers: List[Node]) -> None:
         def _add(modifiers: List[Node], text: str) -> None:
             if len(modifiers) > 0:
-                modifiers.append(nodes.Text(' '))
-            modifiers.append(addnodes.desc_annotation(text, text))
+                modifiers.append(addnodes.desc_sig_space())
+            modifiers.append(addnodes.desc_sig_keyword(text, text))
 
         for attr in self.attrs:
             if len(modifiers) > 0:
-                modifiers.append(nodes.Text(' '))
+                modifiers.append(addnodes.desc_sig_space())
             modifiers.append(attr.describe_signature(modifiers))
         if self.storage:
             _add(modifiers, self.storage)
@@ -799,24 +810,19 @@ def describe_signature(self, signode: TextElement, mode: str,
         verify_description_mode(mode)
         modifiers: List[Node] = []
 
-        def _add(modifiers: List[Node], text: str) -> None:
-            if len(modifiers) > 0:
-                modifiers.append(nodes.Text(' '))
-            modifiers.append(addnodes.desc_annotation(text, text))
-
         self.leftSpecs.describe_signature(modifiers)
 
         for m in modifiers:
             signode += m
         if self.trailingTypeSpec:
             if len(modifiers) > 0:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             self.trailingTypeSpec.describe_signature(signode, mode, env,
                                                      symbol=symbol)
             modifiers = []
             self.rightSpecs.describe_signature(modifiers)
             if len(modifiers) > 0:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             for m in modifiers:
                 signode += m
 
@@ -857,13 +863,13 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode.append(nodes.Text("["))
+        signode += addnodes.desc_sig_punctuation('[', '[')
         addSpace = False
 
         def _add(signode: TextElement, text: str) -> bool:
             if addSpace:
-                signode += nodes.Text(' ')
-            signode += addnodes.desc_annotation(text, text)
+                signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_keyword(text, text)
             return True
 
         if self.static:
@@ -875,12 +881,12 @@ def _add(signode: TextElement, text: str) -> bool:
         if self.const:
             addSpace = _add(signode, 'const')
         if self.vla:
-            signode.append(nodes.Text('*'))
+            signode += addnodes.desc_sig_punctuation('*', '*')
         elif self.size:
             if addSpace:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             self.size.describe_signature(signode, 'markType', env, symbol)
-        signode.append(nodes.Text("]"))
+        signode += addnodes.desc_sig_punctuation(']', ']')
 
 
 class ASTDeclarator(ASTBase):
@@ -964,7 +970,9 @@ def describe_signature(self, signode: TextElement, mode: str,
         verify_description_mode(mode)
         if self.declId:
             self.declId.describe_signature(signode, mode, env, symbol)
-        signode += nodes.Text(' : ', ' : ')
+        signode += addnodes.desc_sig_space()
+        signode += addnodes.desc_sig_punctuation(':', ':')
+        signode += addnodes.desc_sig_space()
         self.size.describe_signature(signode, mode, env, symbol)
 
 
@@ -1016,28 +1024,28 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode += nodes.Text("*")
+        signode += addnodes.desc_sig_punctuation('*', '*')
         for a in self.attrs:
             a.describe_signature(signode)
         if len(self.attrs) > 0 and (self.restrict or self.volatile or self.const):
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
 
         def _add_anno(signode: TextElement, text: str) -> None:
-            signode += addnodes.desc_annotation(text, text)
+            signode += addnodes.desc_sig_keyword(text, text)
 
         if self.restrict:
             _add_anno(signode, 'restrict')
         if self.volatile:
             if self.restrict:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             _add_anno(signode, 'volatile')
         if self.const:
             if self.restrict or self.volatile:
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
             _add_anno(signode, 'const')
         if self.const or self.volatile or self.restrict or len(self.attrs) > 0:
             if self.next.require_space_after_declSpecs():
-                signode += nodes.Text(' ')
+                signode += addnodes.desc_sig_space()
         self.next.describe_signature(signode, mode, env, symbol)
 
 
@@ -1070,9 +1078,9 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode += nodes.Text('(')
+        signode += addnodes.desc_sig_punctuation('(', '(')
         self.inner.describe_signature(signode, mode, env, symbol)
-        signode += nodes.Text(')')
+        signode += addnodes.desc_sig_punctuation(')', ')')
         self.next.describe_signature(signode, "noneIsName", env, symbol)
 
 
@@ -1090,15 +1098,16 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode.append(nodes.Text('('))
+        signode += addnodes.desc_sig_punctuation('(', '(')
         first = True
         for e in self.exprs:
             if not first:
-                signode.append(nodes.Text(', '))
+                signode += addnodes.desc_sig_punctuation(',', ',')
+                signode += addnodes.desc_sig_space()
             else:
                 first = False
             e.describe_signature(signode, mode, env, symbol)
-        signode.append(nodes.Text(')'))
+        signode += addnodes.desc_sig_punctuation(')', ')')
 
 
 class ASTBracedInitList(ASTBase):
@@ -1114,17 +1123,18 @@ def _stringify(self, transform: StringifyTransform) -> str:
     def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
-        signode.append(nodes.Text('{'))
+        signode += addnodes.desc_sig_punctuation('{', '{')
         first = True
         for e in self.exprs:
             if not first:
-                signode.append(nodes.Text(', '))
+                signode += addnodes.desc_sig_punctuation(',', ',')
+                signode += addnodes.desc_sig_space()
             else:
                 first = False
             e.describe_signature(signode, mode, env, symbol)
         if self.trailingComma:
-            signode.append(nodes.Text(','))
-        signode.append(nodes.Text('}'))
+            signode += addnodes.desc_sig_punctuation(',', ',')
+        signode += addnodes.desc_sig_punctuation('}', '}')
 
 
 class ASTInitializer(ASTBase):
@@ -1144,7 +1154,9 @@ def describe_signature(self, signode: TextElement, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
         if self.hasAssign:
-            signode.append(nodes.Text(' = '))
+            signode += addnodes.desc_sig_space()
+            signode += addnodes.desc_sig_punctuation('=', '=')
+            signode += addnodes.desc_sig_space()
         self.value.describe_signature(signode, 'markType', env, symbol)
 
 
@@ -1187,7 +1199,7 @@ def describe_signature(self, signode: TextElement, mode: str,
         self.declSpecs.describe_signature(signode, 'markType', env, symbol)
         if (self.decl.require_space_after_declSpecs() and
                 len(str(self.declSpecs)) > 0):
-            signode += nodes.Text(' ')
+            signode += addnodes.desc_sig_space()
         # for parameters that don't really declare new names we get 'markType',
         # this should not be propagated, but be 'noneIsName'.
         if mode == 'markType':
@@ -1241,10 +1253,10 @@ def describe_signature(self, signode: Any, mode: str,
                            env: "BuildEnvironment", symbol: "Symbol") -> None:
         verify_description_mode(mode)
         if self.ellipsis:
-            signode += nodes.Text('...')
+            signode += addnodes.desc_sig_punctuation('...', '...')
         elif self.variadic:
             name = str(self)
-            signode += nodes.emphasis(name, name)
+            signode += addnodes.desc_sig_name(name, name)
         else:
             self.arg.describe_signature(signode, mode, env, symbol=symbol)
 
@@ -1427,23 +1439,27 @@ def describe_signature(self, signode: TextElement, mode: str,
         elif self.objectType == 'macro':
             pass
         elif self.objectType == 'struct':
-            mainDeclNode += addnodes.desc_annotation('struct ', 'struct ')
+            mainDeclNode += addnodes.desc_sig_keyword('struct', 'struct')
+            mainDeclNode += addnodes.desc_sig_space()
         elif self.objectType == 'union':
-            mainDeclNode += addnodes.desc_annotation('union ', 'union ')
+            mainDeclNode += addnodes.desc_sig_keyword('union', 'union')
+            mainDeclNode += addnodes.desc_sig_space()
         elif self.objectType == 'enum':
-            mainDeclNode += addnodes.desc_annotation('enum ', 'enum ')
+            mainDeclNode += addnodes.desc_sig_keyword('enum', 'enum')
+            mainDeclNode += addnodes.desc_sig_space()
         elif self.objectType == 'enumerator':
-            mainDeclNode += addnodes.desc_annotation('enumerator ', 'enumerator ')
+            mainDeclNode += addnodes.desc_sig_keyword('enumerator', 'enumerator')
+            mainDeclNode += addnodes.desc_sig_space()
         elif self.objectType == 'type':
             decl = cast(ASTType, self.declaration)
             prefix = decl.get_type_declaration_prefix()
-            prefix += ' '
-            mainDeclNode += addnodes.desc_annotation(prefix, prefix)
+            mainDeclNode += addnodes.desc_sig_keyword(prefix, prefix)
+            mainDeclNode += addnodes.desc_sig_space()
         else:
             assert False
         self.declaration.describe_signature(mainDeclNode, mode, env, self.symbol)
         if self.semicolon:
-            mainDeclNode += nodes.Text(';')
+            mainDeclNode += addnodes.desc_sig_punctuation(';', ';')
 
 
 class SymbolLookupResult:
@@ -3661,31 +3677,28 @@ def __init__(self, asCode: bool) -> None:
         if asCode:
             # render the expression as inline code
             self.class_type = 'c-expr'
-            self.node_type: Type[TextElement] = nodes.literal
         else:
             # render the expression as inline text
             self.class_type = 'c-texpr'
-            self.node_type = nodes.inline
 
     def run(self) -> Tuple[List[Node], List[system_message]]:
         text = self.text.replace('\n', ' ')
         parser = DefinitionParser(text, location=self.get_source_info(),
                                   config=self.env.config)
         # attempt to mimic XRefRole classes, except that...
-        classes = ['xref', 'c', self.class_type]
         try:
             ast = parser.parse_expression()
         except DefinitionError as ex:
             logger.warning('Unparseable C expression: %r\n%s', text, ex,
                            location=self.get_source_info())
             # see below
-            return [self.node_type(text, text, classes=classes)], []
+            return [addnodes.desc_inline('c', text, text, classes=[self.class_type])], []
         parentSymbol = self.env.temp_data.get('c:parent_symbol', None)
         if parentSymbol is None:
             parentSymbol = self.env.domaindata['c']['root_symbol']
         # ...most if not all of these classes should really apply to the individual references,
         # not the container node
-        signode = self.node_type(classes=classes)
+        signode = addnodes.desc_inline('c', classes=[self.class_type])
         ast.describe_signature(signode, 'markType', self.env, parentSymbol)
         return [signode], []
 

From f1d9d0aac61ad40fba8bfd82b97352782aa11a45 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Tue, 30 Mar 2021 14:13:17 +0200
Subject: [PATCH 267/305] Decl styling, C styling and C++ char literal styling

---
 sphinx/themes/basic/static/basic.css_t | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index 7f505f6b15c..450b92ead90 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -538,19 +538,23 @@ table.hlist td {
 
 /* C++ specific styling */
 
+.sig-inline.c-texpr,
 .sig-inline.cpp-texpr {
 	font-family: unset;
 }
 
+.sig.c   .k, .sig.c   .kt,
 .sig.cpp .k, .sig.cpp .kt {
 	color: #0033B3;
 }
 
+.sig.c   .m,
 .sig.cpp .m {
 	color: #1750EB;
 }
 
-.sig.cpp .s {
+.sig.c   .s, .sig.c   .sc,
+.sig.cpp .s, .sig.cpp .sc {
 	color: #067D17;
 }
 

From a840b9e4d6fcf4c9144ac7ca7e15ac66cf5545df Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Tue, 30 Mar 2021 16:18:00 +0200
Subject: [PATCH 268/305] C, C++, fix unary op

---
 sphinx/domains/c.py   | 2 +-
 sphinx/domains/cpp.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index d3aad012ba8..1eeaf65cf01 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -446,7 +446,7 @@ def describe_signature(self, signode: TextElement, mode: str,
             signode += addnodes.desc_sig_space()
         else:
             signode += addnodes.desc_sig_operator(self.op, self.op)
-            self.expr.describe_signature(signode, mode, env, symbol)
+        self.expr.describe_signature(signode, mode, env, symbol)
 
 
 class ASTSizeofType(ASTExpression):
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index 1c876081bd7..4a36f6131a7 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -1251,7 +1251,7 @@ def describe_signature(self, signode: TextElement, mode: str,
             signode += addnodes.desc_sig_space()
         else:
             signode += addnodes.desc_sig_operator(self.op, self.op)
-            self.expr.describe_signature(signode, mode, env, symbol)
+        self.expr.describe_signature(signode, mode, env, symbol)
 
 
 class ASTSizeofParamPack(ASTExpression):

From da5b8e41e337064028fb5b321155a8933c91f819 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Wed, 7 Apr 2021 20:37:44 +0200
Subject: [PATCH 269/305] Decl styling, fixes from review

---
 sphinx/addnodes.py                            | 4 ++--
 sphinx/transforms/post_transforms/__init__.py | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index 5d26643ede8..a2fb776e4de 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -119,13 +119,13 @@ def extract_original_messages(self) -> List[str]:
 # Domain-specific object descriptions (class, function etc.)
 #############################################################
 
-class _desc_classes_injector(nodes.TextElement):
+class _desc_classes_injector(nodes.Element):
     """Helper base class for injecting a fixes list of classes.
 
     Use as the first base class.
     """
 
-    classes = []  # type: List[str]
+    classes: List[str] = []
 
     def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
diff --git a/sphinx/transforms/post_transforms/__init__.py b/sphinx/transforms/post_transforms/__init__.py
index bcc9caf0052..e2899d994b2 100644
--- a/sphinx/transforms/post_transforms/__init__.py
+++ b/sphinx/transforms/post_transforms/__init__.py
@@ -233,7 +233,7 @@ def fallback(self, nodeType: Any) -> None:
             node.replace_self(newnode)
 
 
-class DescSigAddDomainAsClass(SphinxPostTransform):
+class PropagateDescDomain(SphinxPostTransform):
     """Add the domain name of the parent node as a class in each desc_signature node."""
     default_priority = 200
 
@@ -246,7 +246,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_post_transform(ReferencesResolver)
     app.add_post_transform(OnlyNodeTransform)
     app.add_post_transform(SigElementFallbackTransform)
-    app.add_post_transform(DescSigAddDomainAsClass)
+    app.add_post_transform(PropagateDescDomain)
 
     return {
         'version': 'builtin',

From cb21eb2283b0489adf10cc6799de3be088eb3fe1 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sun, 11 Apr 2021 19:55:03 +0200
Subject: [PATCH 270/305] Decl styling, handle desc_inline in manpage and
 texinfo

---
 sphinx/writers/manpage.py |  6 ++++++
 sphinx/writers/texinfo.py | 28 ++++++++++++++++++++++------
 2 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/sphinx/writers/manpage.py b/sphinx/writers/manpage.py
index a43f117ae57..3f0eea5eb11 100644
--- a/sphinx/writers/manpage.py
+++ b/sphinx/writers/manpage.py
@@ -152,6 +152,12 @@ def visit_desc_content(self, node: Element) -> None:
     def depart_desc_content(self, node: Element) -> None:
         self.depart_definition(node)
 
+    def visit_desc_inline(self, node: Element) -> None:
+        pass
+
+    def depart_desc_inline(self, node: Element) -> None:
+        pass
+
     # Nodes for high-level structure in signatures
     ##############################################
 
diff --git a/sphinx/writers/texinfo.py b/sphinx/writers/texinfo.py
index cad6f3685b8..6df558323f9 100644
--- a/sphinx/writers/texinfo.py
+++ b/sphinx/writers/texinfo.py
@@ -1367,7 +1367,12 @@ def visit_acks(self, node: Element) -> None:
         self.body.append('\n\n')
         raise nodes.SkipNode
 
-    # -- Desc
+    #############################################################
+    # Domain-specific object descriptions
+    #############################################################
+
+    # Top-level nodes for descriptions
+    ##################################
 
     def visit_desc(self, node: addnodes.desc) -> None:
         self.descs.append(node)
@@ -1408,6 +1413,21 @@ def visit_desc_signature_line(self, node: Element) -> None:
     def depart_desc_signature_line(self, node: Element) -> None:
         pass
 
+    def visit_desc_content(self, node: Element) -> None:
+        pass
+
+    def depart_desc_content(self, node: Element) -> None:
+        pass
+
+    def visit_desc_inline(self, node: Element) -> None:
+        pass
+
+    def depart_desc_inline(self, node: Element) -> None:
+        pass
+
+    # Nodes for high-level structure in signatures
+    ##############################################
+
     def visit_desc_name(self, node: Element) -> None:
         pass
 
@@ -1470,11 +1490,7 @@ def visit_desc_annotation(self, node: Element) -> None:
     def depart_desc_annotation(self, node: Element) -> None:
         pass
 
-    def visit_desc_content(self, node: Element) -> None:
-        pass
-
-    def depart_desc_content(self, node: Element) -> None:
-        pass
+    ##############################################
 
     def visit_inline(self, node: Element) -> None:
         pass

From 9b3b8a49fb0c2c0059577ccd8993fb6ae64deb97 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Mon, 12 Apr 2021 20:24:11 +0200
Subject: [PATCH 271/305] Decl styling, fix font size in basic

---
 sphinx/themes/basic/static/basic.css_t | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index 450b92ead90..25ab688e4f3 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -511,12 +511,19 @@ table.hlist td {
 /* -- object description styles --------------------------------------------- */
 
 .sig {
-	font-family: monospace;
+	font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
 }
 
 .sig-name, code.descname {
     background-color: transparent;
     font-weight: bold;
+}
+
+.sig-name {
+	font-size: 1.1em;
+}
+
+code.descname {
     font-size: 1.2em;
 }
 

From 709339ec53430691593b3a6059bf4ffc040dfe73 Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Mon, 12 Apr 2021 20:40:08 +0200
Subject: [PATCH 272/305] Decl styling, disable smart quoting in sigs

---
 sphinx/addnodes.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py
index a2fb776e4de..8a020b02ef4 100644
--- a/sphinx/addnodes.py
+++ b/sphinx/addnodes.py
@@ -119,7 +119,7 @@ def extract_original_messages(self) -> List[str]:
 # Domain-specific object descriptions (class, function etc.)
 #############################################################
 
-class _desc_classes_injector(nodes.Element):
+class _desc_classes_injector(nodes.Element, not_smartquotable):
     """Helper base class for injecting a fixes list of classes.
 
     Use as the first base class.

From 53e7272884b18e887971bb34e45793e0e486667f Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 20:27:10 +0900
Subject: [PATCH 273/305] Bump to 3.5.4 final

---
 CHANGES            | 16 ++--------------
 sphinx/__init__.py |  4 ++--
 2 files changed, 4 insertions(+), 16 deletions(-)

diff --git a/CHANGES b/CHANGES
index e8acb14a897..5b404164405 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,20 +1,11 @@
-Release 3.5.4 (in development)
-==============================
+Release 3.5.4 (released Apr 11, 2021)
+=====================================
 
 Dependencies
 ------------
 
 * #9071: Restrict docutils to 0.16
 
-Incompatible changes
---------------------
-
-Deprecated
-----------
-
-Features added
---------------
-
 Bugs fixed
 ----------
 
@@ -26,9 +17,6 @@ Bugs fixed
   - The content of ``sidebar`` directive
   - figures
 
-Testing
---------
-
 Release 3.5.3 (released Mar 20, 2021)
 =====================================
 
diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index e72c9f81c5c..179bcd24192 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -32,7 +32,7 @@
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
 
-__version__ = '3.5.4+'
+__version__ = '3.5.4'
 __released__ = '3.5.4'  # used when Sphinx builds its own docs
 
 #: Version info for better programmatic use.
@@ -43,7 +43,7 @@
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (3, 5, 4, 'beta', 0)
+version_info = (3, 5, 4, 'final', 0)
 
 package_dir = path.abspath(path.dirname(__file__))
 

From fe64693b2e90ae25489a3ebb007c63d07881c8c4 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 11 Apr 2021 20:28:18 +0900
Subject: [PATCH 274/305] Bump version

---
 CHANGES            | 21 +++++++++++++++++++++
 sphinx/__init__.py |  6 +++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 5b404164405..b7cb2554a08 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,24 @@
+Release 3.5.5 (in development)
+==============================
+
+Dependencies
+------------
+
+Incompatible changes
+--------------------
+
+Deprecated
+----------
+
+Features added
+--------------
+
+Bugs fixed
+----------
+
+Testing
+--------
+
 Release 3.5.4 (released Apr 11, 2021)
 =====================================
 
diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index 179bcd24192..5a4c931e756 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -32,8 +32,8 @@
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
 
-__version__ = '3.5.4'
-__released__ = '3.5.4'  # used when Sphinx builds its own docs
+__version__ = '3.5.5+'
+__released__ = '3.5.5'  # used when Sphinx builds its own docs
 
 #: Version info for better programmatic use.
 #:
@@ -43,7 +43,7 @@
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (3, 5, 4, 'final', 0)
+version_info = (3, 5, 5, 'final', 0)
 
 package_dir = path.abspath(path.dirname(__file__))
 

From c7b169c5a95f9d84583afcfe18773742a67cdef0 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 17 Apr 2021 02:06:57 +0900
Subject: [PATCH 275/305] Fix #8127: py domain: Ellipsis in info-field-list
 causes nit-picky warning

On parsing the types, the leading dot of the ellipsis (...) is considered
as a reference name.  And its first dot is considered as a notation for
relative type reference (ex. ".ClassName"). As a result, it was converted
double dots unexpectedly.

This changes the parsing rule to treat the ellipsis as a symbol, not a
name.
---
 CHANGES                  |  1 +
 sphinx/domains/python.py |  2 +-
 tests/test_domain_py.py  | 25 ++++++++++++++++++++++++-
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 28e89863f33..581be506e60 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,7 @@ Deprecated
 Features added
 --------------
 
+* #8127: py domain: Ellipsis in info-field-list causes nit-picky warning
 * #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
 
 Bugs fixed
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index d0c5f7118bd..dbb315e6e5f 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -304,7 +304,7 @@ def make_xref(self, rolename: str, domain: str, target: str,
     def make_xrefs(self, rolename: str, domain: str, target: str,
                    innernode: Type[TextlikeNode] = nodes.emphasis,
                    contnode: Node = None, env: BuildEnvironment = None) -> List[Node]:
-        delims = r'(\s*[\[\]\(\),](?:\s*or\s)?\s*|\s+or\s+)'
+        delims = r'(\s*[\[\]\(\),](?:\s*or\s)?\s*|\s+or\s+|\.\.\.)'
         delims_re = re.compile(delims)
         sub_targets = re.split(delims, target)
 
diff --git a/tests/test_domain_py.py b/tests/test_domain_py.py
index f5df9084b27..214cb58a078 100644
--- a/tests/test_domain_py.py
+++ b/tests/test_domain_py.py
@@ -876,7 +876,9 @@ def test_info_field_list(app):
             "\n"
             "   :param str name: blah blah\n"
             "   :param age: blah blah\n"
-            "   :type age: int\n")
+            "   :type age: int\n"
+            "   :param items: blah blah\n"
+            "   :type items: Tuple[str, ...]\n")
     doctree = restructuredtext.parse(app, text)
     print(doctree)
 
@@ -890,6 +892,7 @@ def test_info_field_list(app):
     assert_node(doctree[3][1][0][0],
                 ([nodes.field_name, "Parameters"],
                  [nodes.field_body, nodes.bullet_list, ([nodes.list_item, nodes.paragraph],
+                                                        [nodes.list_item, nodes.paragraph],
                                                         [nodes.list_item, nodes.paragraph])]))
 
     # :param str name:
@@ -916,6 +919,26 @@ def test_info_field_list(app):
                 refdomain="py", reftype="class", reftarget="int",
                 **{"py:module": "example", "py:class": "Class"})
 
+    # :param items: + :type items:
+    assert_node(doctree[3][1][0][0][1][0][2][0],
+                ([addnodes.literal_strong, "items"],
+                 " (",
+                 [pending_xref, addnodes.literal_emphasis, "Tuple"],
+                 [addnodes.literal_emphasis, "["],
+                 [pending_xref, addnodes.literal_emphasis, "str"],
+                 [addnodes.literal_emphasis, ", "],
+                 [addnodes.literal_emphasis, "..."],
+                 [addnodes.literal_emphasis, "]"],
+                 ")",
+                 " -- ",
+                 "blah blah"))
+    assert_node(doctree[3][1][0][0][1][0][2][0][2], pending_xref,
+                refdomain="py", reftype="class", reftarget="Tuple",
+                **{"py:module": "example", "py:class": "Class"})
+    assert_node(doctree[3][1][0][0][1][0][2][0][4], pending_xref,
+                refdomain="py", reftype="class", reftarget="str",
+                **{"py:module": "example", "py:class": "Class"})
+
 
 def test_info_field_list_var(app):
     text = (".. py:class:: Class\n"

From 5f56d4146e5ca67887d19db7df1dbe6b1af863b3 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 17 Apr 2021 16:51:19 +0900
Subject: [PATCH 276/305] Fix #9103: LaTeX: imgconverter: conversion runs even
 if not needed

The imgconverter unexpectedly goes to convert even if the given image
is supported by the target builder when the image globbing is not used.
This enables format guess-ing on not globbed.
---
 CHANGES                                     |   1 +
 sphinx/transforms/post_transforms/images.py |   2 +-
 tests/roots/test-ext-imgconverter/img.pdf   | Bin 0 -> 141783 bytes
 tests/roots/test-ext-imgconverter/index.rst |   1 +
 tests/test_ext_imgconverter.py              |   5 +++++
 5 files changed, 8 insertions(+), 1 deletion(-)
 create mode 100644 tests/roots/test-ext-imgconverter/img.pdf

diff --git a/CHANGES b/CHANGES
index 28e89863f33..b61fdd58bb8 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,7 @@ Deprecated
 Features added
 --------------
 
+* #9103: LaTeX: imgconverter: conversion runs even if not needed
 * #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
 
 Bugs fixed
diff --git a/sphinx/transforms/post_transforms/images.py b/sphinx/transforms/post_transforms/images.py
index f9b78837f16..c9ed572b8b6 100644
--- a/sphinx/transforms/post_transforms/images.py
+++ b/sphinx/transforms/post_transforms/images.py
@@ -197,7 +197,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
     def match(self, node: nodes.image) -> bool:
         if not self.app.builder.supported_image_types:
             return False
-        elif set(node['candidates']) & set(self.app.builder.supported_image_types):
+        elif set(self.guess_mimetypes(node)) & set(self.app.builder.supported_image_types):
             # builder supports the image; no need to convert
             return False
         elif self.available is None:
diff --git a/tests/roots/test-ext-imgconverter/img.pdf b/tests/roots/test-ext-imgconverter/img.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..cacbd855df4ffdb1c9acd5dbd22fad2fce51b532
GIT binary patch
literal 141783
zcmZs@iCdG`+W(7yh=731Ghv1hrT`&KA%qY@2qA=dh7cfxIRs?#5fKm(5fLdOqNP?5
z6%|nt5tUlUYOS^1ZFl!>cX!|Y?)Ufp&bhAhADr*XqqM*GoNM1*K6w(tkk9_!_xi4T
zEkC(X6cP~{$uNsxgfm){8nc81voLv8T}?ZKjXMgnu-xv}8b(-3m9DC>rOu4UGplJ<
zkr$GuKYjuI8vU1<g=N&M+8HH`Nb=>3GPAIhmX2l}BjQhAN}l@veku9B+8Vs{!#7sc
zw6}C<tMQYNpQ$iQsi~>f;hGVa-W1N@>fatePMBQVQk_$yV{o?bWY(zas{}1wjFNEN
zV~2+`BDfLcC(*XF{{P)>Y1ZNUwlkv0JK#4~cQh#(5#%qT_|s2Kp8fb!OKY0zbZSQQ
z$CtG0v^7;tW^HEVo00$F8|we9ZZgyVxWX2*Z1R`;@WKy&L-O_HEh8g7{#D5@LGF|=
z!tl{B!g6c6bmSMtCz66c=7+C~`S2?IVgC3)$Y12+&qseCAO2=$VL2U2o&ICgzmZv(
ztf~p0DgKORVWRp*U5yr>SD2!snf|qeHPtPu8uHN<)T{7Y;&(C&6W7$&sqry#BgiM(
z*rLs8t*WkJM37$=e=|Y7u3cWEO=)RrZD}SSBG)YJ!yhSD{|fw^AAWag$8OOMGm*h=
z5{BluPBqviz)0?!3yrOWMwZD2=6r+Q{2it|0~4;{ZXUUBuP|{fHMY;+VVP;LJ9UQ%
z&&VXs2;<IVV`HJwPQi8<nh3VTU>Bc+Dc`_MV7NQQz)WmF?U5Q-NDVDy2Id(%EF=b&
z=?0ckL+dP~y>de<nTd6-p=Gv#napsH+;C5xv6XD6wba-y$Ivd{)LpqJP-_;{Y01>t
zhw7|-)n+cGMvl40B=St03QU~yce>;oyW|=<C=4C54V`if9rBGF3U|Adn!8n4cvM<?
zD((HLW(TI$j-|7Y*k>2r>%^rz5(WcOj|HV23rU}3NvDHlvmx1M!*kEG^A|Y97h}t>
z##b)$s&DdZZVBpc3)Oc-4fn)N_YsoTO=<h1^wtNGmIu<dhnd<(A4dI!6r*-arh6pQ
zZDzEsrMKLXw5~~7?@{<q(t2O2eUR0G=N`#AH@73R<3U#Erb4$_(6yDT+sf~JQqc8f
ze%F)yeI#&A9(Hf$c5Wzi>lo$Qbvm-z))czC+3okT+waR-*QL#C8BKR3jd#SFRdLM~
zQT1g(#pnFe1zyqlM5^#yY~GnD`7~QL6(KzlE*%fcILZ<q2}vIfl^kV?4r9di#~2Bf
zjD}^5g-Q@dgVRRvf<WO=VDdr#qyxSQectiC3~m>R*lv%QeTIO^RA8`Mh%h!28SPFr
z03T)|V++YnE2*)qY_}VgZ)mUBu@@h3nz04na5q82$VO)6U1{xIv)ifA*fPUlC*N>a
zA`shQlDuPQ%8s3a?JzVJYzMF<f$wJ~G{m<wOE(~Ffhs~6E)1<Q4Xx!yd$UdKa?M?e
z%{;42T*@dT$6^DUJOi72Bin2fTlp^gd{fs7r?3wD@E(_#LGOek9?_J2P@}bX)h_oE
zL#JE=d%2;b!i1odZ|qcP;#|DbCC|jAV5f88E^=LgFmbH}p4JStwReM+U$b4X&NiaM
zj@{+LrF;dWL1`1A(o<22c~;h37?pF5CW~9T$lZpkcJ+V2mC?GHp?wI%B&`oJ+BWqx
z5x#IiKqKR0Y3pWs%euIEEv@OUxS5VMQ6oTG&uo7H?xebnKcam@+IC;oM%~Zpc&N}m
z%I(;qnWEtWWqP<C<aVwrI@fc%HnQ8-ffYioy(eqCBWt~z)rLFwx8X{wza>^JiIj`N
z%8P>X3;fd0fLKD|xtN?;PWDVx)>NeIL<GU>SQw#aj42ucRTNDYutI=4FvSuBtC2wA
zFv#*39P;B)2;ap0fXh3f&j*yn^|*67ciUwfLNLt5hI=H&)|p0-4ND1P#~!GN#Lzz1
z*ty8SKG(o5*U&cG$X04-Bi*rAYT~Fc_bA%yS8v6rGPIN$P!KOu{*GPA1}1{-*s&|c
z&{Sx+>yI!n6_MB_+Oa#$&@|1!Ok%Jn)4)PvY?TGE0#=6B*@iYb#&-G8L^Ib?%fLo!
zW;4RrL%GAX)X=He#Ie}Kxzy5E;~u@=BleJc9Dcn?Hx4!66wzhnS8wiKY3f*HVyiH<
zk?*vT7};eSImvfA<rq8Vn>ZKjaxOG=DKc}&Ls&Q!Sh^IMx+*OgYAfF+JEqo!)5}O0
zbm1O!jT`b$oeY=GM&&I;6<vraxdh2V{K1y;#{Up53Tj1yW~%)Wp{#8a0ph@yto`u^
z#M&O>W#XoFL|W6DP_vraa7)~L2a(o<aho`Dk=}SGqj?R=qvvB?-nyBidz{z##Wq{O
ztFY&BZs!99rMnN2f^2~=jC#KA(`4c65t%LbfLMCN?X=pfBGr<xdQqrc6jWVI(!&*(
zHy4`=zNVw)ry_}hO@wD050#9wM1W~DL?5_diN{!Jqk6GA#1w(5gTDL&-n{)j2~;1*
zB5)=2LBD9q+@d=y-78ET3JomrxhhOt3QgUL5oR8xCa(EAopVjy3XL3dj2*J^=@>f|
z8QA3**ykBK<{2UJxD=Q%YOK6eM%FR|<W<O#X$q}?2Bt&@p-v>nnvn|xMIP^#7?>i`
z4b3D*W*IxoWd@cq0<*OYYGrJbyTdxiU~i6zQ!%pEPRAls&pIprCOcNUg-?UATa~Ft
zorO=6xqqW|V5?2A&L#SQ8+XtnY0QH+>dil96WV7P*lgvm*~3uob}6)QP?$O>kRgp7
z@S7BxP>?XEd{d|V-Ofd3F2$A}<(3{5Rzc0SA?@~|olX(m9-Mw=>O{EoOmyz&?CeiD
zc^BeK7vsv8;w!GimR+VVkP;J>H<DB<$^WNtff!&!*lK?y?RYHFJ`}fYB5)sUW$Csu
zwUl1J+8$=KK1^@k6gNFcYg|vMza`Y%1Ye@YRiS1DqgZ`wJJQrEpaBU@+;}Im`M#`W
zL*BNTt$hdu%kBIS1zk^bbX(clM{<0d)(47qTx`l(H)PElcztFINr?!sMd2Tk85?h;
z)?Z7hyCSGv5~waGSLr3Jcp*Oj4EW;G5+;L$og_&zV<J>SB1AmSN;}3%!$^{0Q0icy
z@DQ+KB=j&6dLdK)N5uDf>4nR}xfo$=qcF6}+CkZ7p*}HnEwJ{jwDhVp^C&ZOFSYcp
zLM3Bpm%YPQZeS+|WxL%=%stBxrXEU5FO{)fu7O#afeC6dfstwIPO~&*RYQFkker)}
znv5>#c9^E`*p+U$TVi4%Gd7nR0j#~*Mtc>=ipG{Q6FVx$z*=Fr7YVJ<%DcwQU1{uE
zY38j4Tzi>q<~|xTZ;gd-gC*b!YQwdCXcw}g3un+Xe#C*@zc-}EDQ4I)vfm-B+l*0f
z=~ZRPP$B7Ado^2mYAoH=79MI-?|RF?R=d!BP7%G%>^|41{m$%Om&iUw?0{G7Au1sG
zSZKx!C;#)LitGH!>wM*n)Ve#Vnl+%5TyqN}?;}}!z@@$;tiMZ2uI3F%EAru^^tMNm
z_AT%Q%1G@6+?q*xl;LI@)a;Q&i<)dx)Vz`2{6N&WE>HuhJ4rRm$#pjb>Xj6#ekHZ$
zhN$)?9cgtdxWF9*umBvi3V|<37!U(Wg<Vg{h4vB10#<S@319^z@p`(_qQ91AOWM3D
z*4z-)FQ=-nrPMAZD=#G@J(eIho{h_==DE3ZF*!4kFnx;rz!xYBlN@KIjj@23cr-X|
zI4E^EfIom7=*jK!jO|2$wH+RDT^@1W?y+5N+<nF#<re;RX1+B$8I?xPCFWk$Hi4SG
z0rlqI%H51A6Zi5xzN+1x6*~ZsEy<A7E{1B4zs4%C(cDLE&ZshW%r~@^8{1{=u*ovC
zksDZ{5?2@^*OBsEO7fn$1a&&X5EYe$bcgweFf^AMU@l;**a5I@^9=SXAXXM$wFdU6
zuL_Nw%gw#&44sw6ZnYNvtrh{=U7nhq9`z=aN4*&luVxFsX3HR*Gk4f4dD2%n<t><W
zi970^c+`zM<Qz#s*KAnbdjmV|0{1yFd+nH=_RLO<HmpvYur7pMM4vO~pa*ZnEBUCm
zV9Y1wm~Zk}VA^E3Vm_+)VqC>FU_@#v%^GA1!Kb5^S_M|LY!Tx0`X$n=p`IsYRy*qP
zFS0tnl<A&G+qW{bk5NTs?|ZE1+9J`7rygZ@ZDG_`_4m_TP<!Eftfthj2-M)~rckvk
zR9zRUKo~&^;|J6}iWmh_zz+CQ=pG?Z=hN3f3>QSRT8L~xs%Ww>(xB0-Nt*%b9ZBPD
zVeJi}`i8Lfx<GlAU%8Z2c{QnQDXI7~UjA$xGNb|(*r^EVWR(0*A|@UWrbwlA2xS&C
zg_QBWJc<#w57m`3TkFEsVswkrxkl-b62YB`TcxG1dar-O9`8C+Z<V=komF6iT}Z2C
zK)sP$xv@v(9)GokZ;g>tF$x|7$3k3K`qbDn8*Tj6W*+5+4!Jw*<OVh}L+cC>W^5zd
zv4@fvS!NgksNHEMge;lChd_0eLF#tY@CY-&m4#By0Ljp{z{tK}uW!9A5vT@3r>Y%}
zWk${wX1>ifAzjw2E@RI|Grv|VW{0`IcDHZq9%j2mpmuLaw`;<fcj_k$;dEfeS&!tC
zzRAa3xr3Agn{tTQZy&kep55mZwcjOrzeCgkhbYP+l5%2GV9G6an2|W@n>-Pad?F}i
zk|~@*1g4z~5Kpn>a}fm#m=hxVCD*N{Xzq#{@1-`NIzrujPoReh(9r?TP<y37!7ypm
z0F-rc%SJlYjPeT!Q6H`MGTS$@IyMoQ1fo`#caaGpZeo@QvM_5DHQokXdhw#+T2856
z7AQ&3I))J_h}0`&vZq;<Hm-vnC=~+P5=sRfBgqhH5XrNd(*M)C4h*+7>kq^l*E1UL
zNgCEf>eV#OD&7=tEl@4<l*_z|tNhYSyyE%z!g+4qnP|lfJL{Cb2qOxH2nAevwgOTH
z{rLj`3za+A0!A)TI+w_HIw+blfVLAAFhgk-P;VRDZ0TQb=3TSLS8W}jaR}9#GOA5H
zs?2?A_xRVFxK|mwl<#6xTLv}ShqpViI~^i)HvY91jLKauC76*J+UM<bDl)Pw*y&KT
z%e{OjU<5Rl*+zS0h8CI7D+82R`Z*y+LuyZ^5vjMbP+%F^<r~=-A|Dz%7F&3O<i=ed
zDnt8XgsE?n3#Z>bZqSL-Z-<#7r{9`IoClk*Zd_Q0_Sr@sc1s+0=N<PIO*4`wnc}Gc
z;RK3&o3LJ>XA`mCIbp<!H|h{KY@cx0F>cr;YS1(8h;I@#9w?k*rJW8+KZOXE&LBc1
zv#gBM%*@%)-1*qjD^M=z67pVJ^L?Z^aq9-aL79Xk37U`+5qJR+H6+ZMo5^)6DfO$V
zjdxQUZeuo>-f~YL>ltkuuo<LU$Qp_4F38toN~U|5(FXHk9pZ&z9^!?x2;~A+1SJ*7
zx|&>d6)Fbt!ibMQweBV+dx&(+UGO1oUI$7LD~t$$hC9+Ga+5suC*gu*{W*w^QTp;r
zs#%rP-xAf`6xJ-K)Lh|LE%7QYC6s@bP&gl#KNpib3%-yZ*_oK!pu(R3T&%Psdf^)I
zO+0|Ch|&sh!E=CKfiFmwb3~g{cq={bW>lMbtIWJqcEQbiLv;uXW~)U|i**R4+v%k?
z^{ln>Yqa)nvG#2?^QyN9Y;oZnKsZMBxyKGTNA=nSYmHp1%ow$1UJb?`wL5*(mdrK_
zR-0vzcDJ|M(4lyTUB01Bp0P!)p^4nULT<1p8)0abLn?PGg#qS=cCe+82~pJ*TKZ`0
zLv*OJcDhwjhR$U>eH$IPhny2fJd;Ol*uB;f`&|={IdDfo6GJfRmM~_^9<b*ewu>6Z
z=#ezxB|POTp79i%bmLDr#~t<HO}NC3IdexHxkng$pm!!9btWWzK1%+1l>9=d<Q!8r
z8wjwn&Ooma@U!4*g=f!)=Pq!lVifaNlj>FljccOTjkLB0bO@W*afc3J!y2?KS$UJM
zy2Y<q;nyw;)YnrQZl<-|PH(%55I2Iy`v~Y*rglr-`Gve|E4%w)rf!4Cmv$qwagCNE
zjF1p9)JaVjTGWkH09CUrthvEgg0f}gM}4VJo)*=vpdgcIZUdq}2c7zW4_%yn7->aA
zwrtq|eKdgNnlAA5@}<|xYe^ML38k0fOD=K?Kck{@&#@Kr9NEd}%t>~}adyT;gydM5
zcq~YG#GgOxmw3o0{vac^&poEyHCpQ&+3FI7Xmbf`c8h3r4R7&?)S9?gnlV%s-nAA!
zwbmi+PEkDwTv)MM%>x=Od^Ps0cDoRrQ`kNycDE~+^5Ty$k`8<DhTRedJ*oIX=cqnF
zXY8Uh^;E$wF!8OmB$R3$BKO&Zx0?so8+nuy7X$2&`Dl)zb*|Cg+#Oa5z(x47$=4fL
zxjP*TcG%>?ezFhg*c;Sp=BqJutu*#+aOWR!PCRTM)9)BFU>9}Jfiq~s9so2x!c%@}
z)C@qgju_YzdH?~Myi%t8(q?=`Gv2~ectudgoUiB;Z{d`G+6+7YQi5_NUbPypx|6Kg
z5HxJ?>ee_VmqK&q5#f2~!}Ay5l!7mI?xzv?7dXX>@fFwNRX2Djx|`QiTkg{%2up8&
zh=&MD)U-}i49OAtRg1WR;+(I(k)l}<YHp=yZb9adE@_(;?w73nVJ4j(+c#j4A~)jW
zhuZ+pK~#TBP<ta?b4Of%J59YRLM^YSEJcNx#TA+@Af+$JuG864OsQAs)JKo>%#u!k
ze})TMM(Qv<VstWvsX@wqy+MK3<IC~ZU>1oOd?l7G#uZ=S<bTS^KOZGO#g?56C$$%;
zz#v~C;$y(eH(|g#j_PN`^|^7hZXBet7RQKYhwvshb}Qf_!EQBzq3Bj+=2dIyr?Fyb
zErZ+a*<B8i-Hwr6cH#T%!uHvO>~o6T?-F$Y#fw|wkhk!dPwKb_|A<rE0J4-LyU#A9
zYloB4Hn<yAj7Q>_d;FMZ!k9<mF_-vJx8zaECbG*qq}9-+$N(m+O&$nBAQ|r1n`>Z=
zivokag+R>MzG#O{fq`B5PIt9k$iBTH9fqDYM&3<syrV9>F>5wu7dhY(J8aGBHV@F+
zhEt5BanGa)hG5E*e*%foA!fuWb`*FaH~OYddkIcL*?dHwgiwkFcHttY_-cak7Jy3A
zK9RINNo$5z@I>DAQrK`eLAe}Lb{RE%WYGn7;R4K3xLGl!OHeITU2&*HU^}R9liI6k
z9SSDaZc22IfEXr($dj1zr8eF}aYopxyOpd)ZH^3wxP=gEC`<=Qz$ZnnL>ffZMGSb|
z1HeVx(zf*s<i=(Icw5x4D$<~KyZcAfgEGhzohq+GUg!W~;0po015$KlMN@(iinPrZ
zMF^tdLaE=nL9oJ{QtxQcFQWB}o|xj@K{BuWGWgQ#*M;buxhTaMwtR*yKOHVR6)v3$
zO&<>xjRqtQfiJM-!PP;yoY<`n;mvlT4Nf7AP%VH31>5PS+(mh)%rV^$ZnKNnXA{=3
zhuLZy-su$C>l{V7a0cAChrM}6efi@)f^mjm+(R%%hilRiXU>34Xt%jvtFc?17w>48
zd_E-mQ>OGB1jAo^#!ozBA3J0l-R~4bS^6VG=IyY}!>Y|6qivyqE%G5%y2G}_(6-pn
z7Sn_3oo;Fi|29jO&d5h&!R+zigOStzX{TMdqjv0py{s;CBxoP}9zE`HBQ9}AT;j)Q
zrl3y9fp|!d&@O+;8UM_=(1MGx$`xJ>KHSH$_GhxLm+9Ik;<hg^VsZy!C|=D<yz)A?
zVu@3F5ygCD!Dk#jTnUxS1g@Huq}p42=ofNe;~Mk}h!M(Afi)93BcZti`tX7j%^IpS
zQti`~KZ+<a4<w_gk(j0FZTF-)SYqoE?YbC&6(Fh=RTriWx8b5f;}EFq^b1NG;>LU8
z`qd20EqwL>3ZMO-l#93)bP)!`{;XigliP6N0u>mcN{<wTi(F_oVPbq_iz4oq9xl4p
zyN0<VuN?VtF`@J##0$Yz%poGOXTviA*YPm%QI?SK1@jbexkPE9S|H1YRd3I%2Vc&i
zO^&PvQ_mVy&&Dp5NPt$%w!O%Kp`93=IepI2n04)UjT!dhjZ!F+gC(Z|(k9(_BaX3$
zToQ)tV-8reyR4ZyQ_lw1n1jB837?cnztmIV*$Xj6SECD;q6(Knb1pa~j@U)@IYqR?
znFU$K4uy2=bS&QKSYm8ny3?WD(5}S5ro_;$+{mud#9eJ2+yPlMVd*S_dtBm1k>>&^
z$()aH%87dzb3yy?UK^&?%)iwpyw5&*$S&%Tee~e&pe_f_uuH<2d(v^w<P*;EM^S$H
zOJ@D0bHO<ak)>BSrPq_x>yqxLIs4z{Qr{^0zLs^p%If}-q&O&#`gT(7O`hs{g7O--
z{Bl(3#hCKTv6WZis;(wf-{7gJ6<#gTFH~Us`r9cDYpG4^smPU0>q7knu!4jMQHp7Z
z^@UVPJPKsX+GT$2H9GVjDJF+&8Eu3qIz)P79#qi*!wgiV6Wa_v*+xb)W_IMGr-0A)
zybg%bX^}Q5fCXKtk)<6>CH02sb{z(Sa1DoFuH7Ib$kJ;UCIYylM^Eppk`xTKh#J!J
zMW@HuqJ@}(^U+k^d{pjyH29KDhe;>HGRBz@FTsdULcb@s(=`e%bdwEBV--|q8&K=O
ztalD+v=367xL2Eb)tR^{F`D{l%>A1z0-N^)wpg>YcI<AHIxa~^Jd#Ekf-x`QcwojU
zfAORTe-!sE!@KN5x-7h!O*}N7yixyjYT83^+%;*OrT8?e_zI_NnO(HR%Kbb*de)0S
zY0Elb?YD1-bESbp`7X~|L+8pJ&ZRq?%62%H8#t94J5?Gxl^Z#g8afmiI+pHqtHC_b
zA$G)pGqfwP%PxA@DekCW`YcmA@6H={i5)@J<q$P!9nxpb?6C{)cjF#$U?0N&69ycj
z4?A&20z@-G;#p)&55Y;lj9FIhLU_?)eAO*63hD!2<sW`mIPxB&;?SF%1240BzRZB3
z-u^HRH9N8#aDlT0r9vT(YO4MYaKUw=>Sk=^wS=ncD6XJODfEgp?5)OiC`~H#hQd|j
zJt6e#PjCs;q{4@Tl~PYkEa+Ei!zx+h!4we|7xYSx6<O(NLCz%g8L86r+LhJ}FX5iF
zX$>_Q%@*(iKzi*W>5-N)5T;ih>Ly-<6p5e_+s==Gi%xx@lvXZ`BvtCo3YuA9B~U`L
zt{^Z;MF1|OM`%}E@n_sZ$k#c#2;=0<heEzGPX&sO`y>r}#`QU~JFJ5mDeIsHTUHBl
zqGPbeo~b5qAuZ~&qLqK+F7JBqwcED=aGCnn8^aX{>vT*Qa!ow!oG^?u=p~x)OFIG3
zAYV37eYSx*TfcT2W|vdkkX_u6Q{t!tZ;T<HW+^@kEx5$W`#h{@k)@aqkj%KmjJk0~
zttsF7-R??Lw<;U|1~d0M6Bp%9=SmZoDkGOFIPu1=<%Z5ByWFY_U6jUNZFVuEcAOE^
zQa0>EuJNOuf+>ITtUgK3c&1FdCrvm+4q60sn)!9wh8}Q;7;uRmwuu--O7u>i@)4YZ
zaQUQt;x9cDD4!2foadG=i?!6_Eb2w^*muQa?+Zu2#YM@H?~8`N&Fg=o=mTX>W!+CQ
z_kAJN!AIW|p@4_21%C^2RDTCq5$W+m<qp2|y0kq)skY<KZ1HQaCe?fhe$6t)Q(fb$
zmQ!HGlUzwgl>NBS*JQUzV$`!rvLYl5a5d?bOJ7CN(0~uj7$GmT*$Tuy!bRA^v-Hbw
zy&bfmk%yFKl~`PjYZys<?2~}U0olTP(OA)x(X+<5VxnAnvd(b|&qwE<=N2wR$j`8(
zQvsq0@1(=-v3)L)o%W$^4q-4+J5gyN=)wzZ8M{`I!plPisw{)3R_kCb@}mW_$&%G-
z9RfSM$ANRuC4SgBe#j}Ffaa1g47iZEtb#jif?%M*A|H3<A7!LYGDK653TD>%(A*15
z`T0PE4AcGd-uSSSCLP#4rhZL3+-ope2kXpyn~dORxhqXPlsny3#%?u+E-K2{wc6OT
z-ZW^RRn#EFCs1<6E^5#+q|Y^eEGYd<pm^3lZ8lIc>&6?m=L}hfQkKEJmaIO<s6n^b
zBX0Z?zT(rKDMYfoh0{#gd_=)TR_=u$#kuH`D?Ihx6zv0f|Eq$LZ%fAhQZeyY<>cR$
z6Mri^`a{v+yMn=Y`2%nBr~_{ly)UzSUPwEhh+7|tnm0)qk98XGrLUr3YoWr2vxPw4
z4QhVc52LMmc&UGe3uN(BR}!n25|oz{tF9n;%Bu)~mZT!Vhd&NiUO%_gr%j3oAq^K%
zt|kz$Cea%U5FeU`bQJj?W{nUp82H4L0AkxT;esy3K8TXue#IR;6xHEtSJTwD#q|V3
zz)0T*t(Yi+Eeik9B|S6?egx8DG)akboc#Id{IfCn=i&;_N6Kf>F%l>o_vQ^jxd4|F
z8y43-x9BeT53~#6!Pf5fs@vsRv(vrW*iC8TRlD1_-W1Ee%w|g#5~FS}YoA?cmvdyl
zJ9o$dg?a2D;N?Q`MqB__{E%JrpmoGSlth8jxxn;UR5*dMvjOsR$U_l@mqPO{_(3<a
z=9!A~zMw%k$q=4$iW{?F_8Ku7cQbqKqXzB5dodR<X4LQUX)yI_HuY*Z4eYQA-*3wu
zcH$jHogO4P!<5d!d9VsUfY~QAW6ps~jra;CF&l-~1!oJRHG2Rr4IvmW_)F$})93so
z^M2`PIb}CeS{@489`c(u#U0N??OWo`Em{8yq{QN}A1Wq(R?YlgcjiB9Xa7|>^=tXb
zzg3L?RC@S*{-HMo18;Npe<kaBDg$BKP0S2Yv!j-$?Nf>ttfU&$V%L+Zufy7=jZ|bz
z=ojE3FQ7|$HSk#mT-<UjC|yjfyu>eG<d>q~<*K0aD%`82Y7}IIFFL@@c8Jxh#KuBa
zY`6obLV~F#l&0x!I#s`_r-@YffI_cgq*{VZ3TmzjR990}SD{4++Ij~ybPm<$(`!N%
z;wmPfbfHEslGDNk$pTwQhIBrRExLe|h+2!SI1`yOhrqm%n?s%D$Yw(&Cj*klyyFHu
zIo)6iWO;IXF*?CTjnZQJh}s@@rMV9o!IzO+)lN^<PDYJ+K!ZhKlO+=hrh^Y|7Ybiu
zzfE|z9c+i_e&`s&DR$6}H|EG4@fV*ClAgu<Fi<iFv0^C}nDTQJXbR3gACNhRg4!?R
zjJJ5kLpbFlKF!KnU?iWkVD(rq`&{FWz`VdR%}!6XiD#WDR+{~Fdx9X8!|uY9Uea0E
zp1#6qmUKQyG6%x}0Ksj5S&EViE(E}WpB0pGmXu<6$UhM%TL@8H49j2QQkAQG^@gDF
zp{V^yX5XulqkpZM_($>Rk9osy^GCiZ8vU+(;^*qAUu#bPUVrw#0GE31-!-$p*G~OI
zdF-!cqkkzq{9PgV>ibIG{an`d1T`7Tejui=sn$@6LBx19H+d-a5z6b^Y(c*CLFwTF
zUusxi*AuI+B6!tTcyPcg7kTBENa6umkT4a!WDU5;oD!e$M<F6|q~{BW{gL7zU!V^_
zK&ikATztHhK9-ZKuLzVRQj}MS{?HCTDWMP*SNIi6{Bl%LmlDe^CRHqgFHnhZM#BY+
z^=kMbH-6NvOUQ~*xo0s;BojsXY4{S{-1(@i(}XR-7$f$e8+eMq!cQm77FHA)+<i6_
zQ@xu}4&|Z)a2dK(8ah{C-0h>@<EydsZ$+P{C9~Z;plwf3J940HShsy-A01eZagKx6
zH457@KyoH9V-AR63{@<IDLz9&Linf8!fAqC?#@5KNSSgIOa^Ct#*$w^_Hs#}#z6!e
zDR1FP@3b>6NfS04Ohd=**h6-lBQE?&Pw{DA;c0KdC!R@D4E`y95%S?_JI=5}%rFpx
zo5e^ug;ho0wAld3S(p_;(sRMNi{VAfoT}UWhRux5msx#ZXCHW5c=#`+V?URV|GjeJ
z??{HF<9{ii_^E30@04o#x7wLs8|VKM(RA+Lb#uSh&-_z;^0%53zgCR>R6P71`jtn$
zR`e0Rq@7zZw<PV4#BC2SMHDpL#ncf+7@ZsG6-FS2f}hTrBuSF>p<8-q^(M^K#44=b
zAthenRWG6R;!(70=`$mqrb9nr`yYnG4I)zjjjZ~hWV$2K+|egSvI<G3GL+s3e&r%U
zfT&nZu2@VeyT~j3oL7o|t&54p7ZQp;BY`{R7eN@ml3IeCfiFG7#Oa`wa+_P=i8sX;
zpyWbU1X&UC(@?HRP?j|lnsG8H^|(*MpgRYvifC6Nd=bQA_IX6<_WIZCaw{>#s*SfA
zqlt&g#1#z)qyhtNdweuj{;d?&hW7+v(%)hc*apu5VH4T~#IVZe!0yAxY!8u1ngBk4
z2q;0tkhqwj3<i^!xa0`3Ov9T9z_SFsi{W`o!Pyu5Gd>N=TMErz@<^Qx$-N?|-{6+r
zh{(SZnE9z!>S;#GX&=#CASIq>Nf!dr&iV>xeTAsENb+Uq*L9eg^B#gJ=fvYKyh+FS
z;~s+PfQ)nOvYXLWtC5wr5;PmB?axJ>&qW>2GJ0O-4t|?I{C(lb_xgPJzVd`#wWfco
zKJ_=v-0#ij|J^wMuiCla>SundpZaI*<Ui|9{f1Jk@+kFVF$%H%ufSJ!FZ{7TBn&DB
zmka&_W|kk-iZ~Cbz({4L&x**Q$dD+)=u$tqW;F?7r@ER{i#qI@K9-Yfu0z?j<4;pI
zf(r$|2^ykTD5NqhGGh7XL%$cD4CxviFNG~dutJoRNU6BY2UA5@Bt$FCLVUrearx&F
zaI8>7#g|+FH25k67^0^Je|mFbN|1M^Ncn~NBH;@zSCnEdI`=Fn3(1@gN;@8)FS*<}
z-5|>{K(m+G<QCQC#o6Z;(PracgT_FjT8vr*90}CaCLS=out=yj^KV3(izS3BupJkB
z0@|#CbQb;uHLGCV-jFW4Fs$?S+eA{Rc8)l3hcS!8ItzlVzogFk>DOFPDtV_&L7lJ=
z1Ba8P_&lQE3M*$ZqG*|wdpV-;8mIJTpbRnx+wuw>u@$Q!Ig8%nv#!b0ZhS1|obeN#
z36`7-5YGAwXIZlI;dvKB6`zF@i(@`K{}Pp=zRxYa0Xg)~ILFLij3~X%QLYMGwo-M^
zQ#+msbzcZ|kJ9%&&**t2?R%L?y(l>RP5H!+)u;Zhn)ye~sb3oB{?&5szcfgRpZv4#
zlYiDv|5H8rt9t6U+KFGQ#(pXv{jPZMn}UOH^7>!rQm@ENvU3X=5_uAhrf^WjRLcfj
zG8!V3S+q|9%>r5QtI%l*V_wvVrqX+<n!8AS$#p2OkS8HtS5WPL^uS1EM%E>ja01|5
zUckq%C*T5|!=N_EWGU5G)9SX<Ch77Lswf!hABrSYa}X>9O&OFcq3E;NymMd*BeGdc
z&RJ46<(|dd54h-s?83*l-geH&dL`rw?@lWl=!R8~Wk%HX_$s8wp!7+9(J`;&QLn^7
z%7fF5MQOCvpw+>KNz5%9e-$iEG-n!lsCT&4V#EZ^gwbg1sWI_tH1^P#Ff^v#jb^?r
zh&=&7jD)#wyG1~UWf0bc4md{*!oNiEW5YgZ8##bPg~A$Zc>2|3EXquJr=0ZQonY{%
z85Dn-DLEe~p7)i^bIVs^D{seCtR|?|aUoDYU>9C>Pd?=>!us)fjKSF#x#hRQ^RM6n
zwK;+zobi*K4b58&$zP1Bx)H5fiLJgZZhw;2{zTIGJYDxRxoI<^Y}r@-DKmQ^EdNq?
z;bKh1^`tsj2xxJ6p3zPbPd=;XwSsz+4HX*rN^$6Q!I5{BlRsBa{-T=tRXzQC?euTz
zncoq0CrQ;+d*YXxiC>iCKUa=@Uq1S-Xy|qRz{}kJ=eg8NTET!AbZnb7Vx@vGy_+h6
zvkJqWzHVH{ypO_M6QQ30;sU=k94`nQmX%P7k*TDfHQ)vrfta8syGRQL_`(t&MyL%B
za#RibX^H;Sp*f%mvO@<5AX%|uk<1s$NmZv$iJv1M#!-6B0$d!3k9-yZFO)olDXIqz
z?+)96mPlwPz5y~X0v8`7tm^8=)kdsj&oU)bfnqr3V_0c+3U9Y#HCy=BTKU%#$h=8^
zsfkO`F4tlc??z*W#>AUy#MLfejj>nV4iD8%Z#5p8`Zn+OYay*u0quJI(%Q0mZ9^%C
z@Bx>oVb|y*a0ndWk4GNDtj{s#Fj#Zq9)V$iy4xilO?$^tFM05$5Wd1Wf6=_Z^juW&
za-!;9Y}K7O<=x2Q>zvY+$f9KcMBzW^7o-X)E+qSN`eB&jA|rK%<j|~7gXN!dD{k>M
z8`7SaGU^SgsFGtp7mogrb>M4p*R!kxZ_>M;^8pkV51SuKv|9qrIzrs?IBVYvuqE$#
zokP9J>U%Cf@G|@0tDM2tsOyUle^)Z{eZ|oqmDKpp%Hu%kr}D8MtH%GTn)n%rRUZAJ
z;^=o}qj=q$!lAG72VVj%dCyb0`Ut>9kF=JdAj7nh?wz0)hsgR6={F^zzjz>q(vf``
zq`d|X7hUN?!QlVnKN12ZfeUH{l#q?K;ewXI7$C?X=_#+#$q-n5tl0@-bTLnlNO9y&
z#T5avC0GMu@TYR;xj7_a6lY@;bDZ3>dbZ}dg`ZOJ9Donr8bDzZN!MYh?C=mb!5z{r
zm<Q@ek1XjarsRabXu>1zpbNVLOj-MD_69aUyUabyO<anNoeOunmqMLPy_=v;7|s3B
zey7{z-Ga8fon8&Qe45Ps+RXg5=6;A)ODa%j8Q5jT?6wXjrZ{{{xJwAD5cJ^<V$sh!
z?7-geekbmT1NSgSC+?`X;Iv=rnc$31Q8-0pUkb}x49mlk%I(COb?^naV#-!n3S_y9
zP%YP_lMZp?wlQ$x&!U3b8-2uqbJSaSIyC2EM9~#i9<`L9zMtIsIA`d6`S`Dz+5cTX
z_kXEo{#|+E*OIZnR!{v?HT`?p(Z3Z8eV=piTRHVs*7H?n_X|nq6Un}<te#hRDC>Qd
z(etIO@2PD6v&{X^WE2si{DIenhrTX7{0{R&MDgMGrK3MUuPR4>C?6%NRea=|q7h6A
zzNYd9zrq)w{GyqX;k|mEWOhH1c9C59N6n9}d8}+}$u=Nq>!Xa;M;NiA3@y;u_k$f|
z^fC{8dh`aOg93U*YZpf774!!H;Q}OqClK}lG75kcL%*Ofe+U-pd73o{4s;DB13Gj>
zwbzMvMR!LlmxYx}$z^B&ynxy(uJF@1<io-RUdaWz+Sk7!zU5^aEEIO&2?4zR%oeHt
z@lt3UQfjz-h9x~2D4t{_9C8fP+A^Df6%Ch_Z}lGUDpU7TGf%Xck~9d7GV^QR?b~h{
z)Mf79feVX3G~{)e!~XWySp;=k1az7DqU7qrLo;6;Ub81~pLKAbO(<m-h916thwy_K
zDeG`lVFR$fU?!kL)QJl#>ZE@fku9cVA)@$tM9Foo@(#c85wCGGu4au}eupJrL?sTm
zkQ>35SK4eu!IEDFQs^90I2R`S9MUG#K1pu*QltYGuS-V%T08x3^~`@a&;Q?=GykfY
z{;lfdFRGc}YG?nWnmYL(WygLg9s7IHk-rum{vmhpojwP?Pz=1x>VJ{h_Y^BVbSeW4
zG!PIX;DVYx@8DMjhu#zqe^WH{7PCZ{swKnkVMpM)@X$9H^ZVZv93)dm1WGPgtRJG2
z%p?&R9TYJvAYo)R2{TJX=cDuv5*hop()B&{>H2O%vI<$hCLoOz!~=uDN(Wsv2`VqA
zRKYeN=@BA^fPx`FnLc5DSe^Np#<o4IWlE^RLeMP<HWO*!sG@827L2acI(;WImIjnd
zAP9=4&!JcNWtWLNf!=1!8sKP<)-e=uWU7ji3vlTl5_oChLJbFvL)8_YJsX-i4dL?P
zA9jmEceBnWxXCI|V@CPZ*f47m<~|j>y~@x;Y~-%q1)cJ007}-Zo;^WbCf=<;X-{DH
zUe^BIz8!$elG%fYxCVC!Ge5$YWe`NH*Cu2?5QC1{hV|Qo_gjYS#|pAJs|QOqd&37E
zIHMlClb%VW=!&jbWtUPnBP&;9RBK6^&A94&ag}!>@~?&ETtcyhl!$3!K<4?7oQueW
zO!-2f2<GV&Q+6S-?!L6|o9u(%79RPba^fGVssB(-{i}BRUzHPoQ_q60f2wBw39qW=
z)PF+Lz*he74|#*%<qy8c5+dsNg2V6fhrh`gc%#_=f&vAY>Cu6HEL;Ex6jI<0%Rlno
zX9z{#t6b`J!NIQ)`3JwI5yJ%-%-R0}a1ojS7r{!8Smzea><6T1u=J48oFQSN4nrqv
zI@LmU{2)@)ca!UGrPRZuxVF7Ogf37XJOt=h)#XGe7fNy>UL;BCgIH8_GNkjN{^KV=
zAaF;|7IDR}90}{4UJ8N@Py70?=Os-P*{lXTmb8!6tq49g@T7n&IBZx1Lhl6{7P0*d
zJKoeQxQV9-lBCQ2a(w9rQ#C{iYv{N)Z<q)ds~L-mXoWX)Ewf>&_XgFOd7}$LX&biR
z)K|OHyV;o0Xa=zYTdZ!%Dzq2Nz(kMOhpdA8cKH#$@KDcJyQz;B;)OLms2lX_V|3$L
zFlZ6jZ63JKJh0OusK+X}-<Cb>%pG%y9rsSgD&K|3;+3e<TkO)6nDRTE(p6+d4n5J+
zS6q-UP!&NHEcv9*;VM9eO6x*Y@%7MxEBuxxiUE-FeaX?EVJQ@i{FHO(y^Q)waqt_I
zUsaR;sGa%G`qTeiIq_S`(Z7*#^yl0|-{ud!FB<v2_{a~$g&6!M_rO=c0$zJc(>>a8
zC#HMLeUPzTN6EUVC$fD{VV+_I2<t$(2VP_4ks$Wbl=x6}q0sAkhF4~Geo0u<2jHTy
z1x;XfyY?a%&G$*Ek8TS6%Cu0umQsHk8_M*vL`)h#M$J_!iIiVU#0{%Lmb{!y+Fuq?
zis?)JOSFMNk0_IH0j!`l!WyK+6;TbmP?%xpH$|&6S+16~V0{{0&}cthlc7OTdmkej
zey~>!7?Cd|U|z$u5Q{@t^QN$>j>UA)*RYB)6_lYwgvE;)NEPuVunxq^m;zi-F3c4j
z!?k;vjcBRb#Za32R3rBI)gT;WM{T2rO#-`i2JSOs?lTSSH1Q|vFV^7$a4TIC&`&&K
z5!{Qi$|mdp0%=pPT@=ZibkJ~tDWpy;AzS$GBbgLSIKe%ZLHn&j588weI!2FrBush>
zV1Qi=mM!|Ged;f{5G=pUlwV*fE}(vgYN4D*dJNCMjLsOI3JrX>IW@OanjQt`U1nFT
z@HJZ^?U(5DL+vE*e@!V4zRRNC77Txn3y4(NvA;vk>OT3esuTYNTo_A_{w;s#FUXBW
zBR}R3{UGjop52d<{v}EyeEc8_Owp8q1Hgs*fCg|7HEVsCq5A^T1a7i=o@e)AqDU5m
z3J2cM+Lc4?f05Jo3IPDg8d2911l|QYg}1{u_<$7_B|ipf&%rXdej|t8xPU_jj{=1~
zrjEp&*pB2nm=eUJNUkC4I3naTQi^>DeO99&Bc$*`m5r1IG{8t|%{5WYtyI+=VKtmE
zv{P(g7YFI<YWc8{1C0>qQOw%+kaSmfJRsYS(6(QFEd|R^AQZM1QYe}goA0DH-TpA5
zy$sQe-ViJwpdaK)V);dG{yFM{awQFWaJrBd(NAR;(qb71Z?qn!1X`NSy=#0^VLyH1
z$)7-(M3#U<_9IZ9TLka73O|Upb35+H-mn8!VNf#)+GQ2gWA4|v+XvPc*y=(G#fU(q
zPv1B7*6#L0mDXiJF}ux~-Ma&OOar>D!v>sUj@rc>-y3z*j(gmVH|>^$)u35l$yr}?
z#-z;z$v=-*uEA}9oW)h5aqcOqF%)Nr=!#qMHTRM<kA$tLx}FJIw@`t}x?iVvy^s%l
zgXv-}N~0rKC;UY@^_%kKZ@AD0^-JlopCM{RBR@dG<o#dE54@IjJqItCN{U)GK@bQ4
zUjPcS1G13ukRAaCx*&*y)k0dT@D#W~A)j~P73wguvfcj%YL?p%;$A7Jms!0}KS-H=
z0*Tk-ZIc`BQV>P_!$-T0<_<1kwxXF3-8)zS*H0Gd&Qxd_npM#hLB}n8y81SWn}WI<
zDG(EU-e^6p24!SPkX|+fadaeAT|uRUNCqOPmuis4(1yP%thpni>h4M!?q;^ENwHhI
zeN(P`B**@su19o$FL4{1#qNPhl5k5Gfmkv&9Fd>nrnq@Et%(k_FQQiiiw)#QNmgD#
zUXID150Rb@L`MYg5QNJ;s)xbtbC2#qhQz!PcmXU^PfCf!8~B`L1y3~X!5hbRhuy#@
zxEIztd{HZQza4iNt1}MqM=ZiA(vuf?2=hY=X4me(4%2|1-GRLba^c@&>fdGRrw?Bg
z|6RNM@EW|J$1JGNGPK`1^pGukgbusN5y$AGE=g0AbIOcY#)5Cwh0vm#Nt&$~<y}tI
zo%q@fe&bex`azs(Ewu1zRQU=@F23dwPyIm9@JP_GnbLq=rC+9NpJw*HQuM#gqTZmo
zDjxl*X!J+S8_UN3h9rq7KmPZE!+!x-$eejY?=yOy%X?nt^u5mNdXd@rEJOFDjM57Z
zoe)t-fgr#II*`!lv_=<981XDL3yBeYAz<61@-H0x8hl~8iD&VJ2v7zR@eTkM?*Pi^
z5eR=!FkCca4?kv%7}5Vg%CCDOZ2thyWcwPLy-2?*`8YK<^c%795R2hAK14m~pCCRN
ztk^nY*rV=7U{z4RC`k-fgrpH|U8`VA(r_=M;hwB{Q=!EvCQqSSik>Y*cK2i1zAXxH
zLG|KbrWIjz=wfW~=bW;OaWMJS*YR`Us1!_W>7!EM1Y<iua_#kms>M(REJ^er03CFZ
z4!gznJ4E)_hId#7x7xE>Xt=QH$2DQxCH@#1puEs3C7SWzPmoN=8G%a$?DnG3g^C=o
zi8<`VA9qX~v*R4bUAyQZ^e0$`qHgaq1zbUWX3YH-EXq8XvS1ysVD+2%_w4fTHUVe^
zJp!ObFf?%heAz?{AxSz!9dU{p^-P)Z5T6UoUyiC=4=q~dH$F*j-ioW+NT}b$7^Auu
zU2&VMr11a##~>?N^C(t%H&M05Q?0?n=a#NuSvs|COVa%Ut2^@kxA{ZgLBjG6e-9Od
ze!-xqocy)y*v~lw?*Jf-u~Z$@32?nZ-@Ls0Ra)y7XaE*85Hvji2!!Dd%?CiC=yZpt
zF;k@B!rYP6_5<)$p<k~s%f#0}^)QmRBMaS6QHr6|2U&E`wBi~Uq%4ChqPE9gwH9<r
zZ;D$<q_;lQ9~MER0vD;++uwLgNP(<|6(M;*@>N>PT?8)h5V?y?>flL{?LxS~$`Dz9
z#O{vtrdwk0g|4lp2hv9DkKN2_c`R@J0(wQmmDBr$y!#7T+Xm__2v<xY77x#|(e_Yy
zKBn{n=C7Dyq++(&Op*O@Qtbxzz@@jsD8>TTwXnQ7mSUQjJ?)o1!AO8mP<HGdge6N$
z><E2s#C9Kl(P;+%q+7yqm$+l-DL{vmO9Hy&Px_%}N<8bDG~vdd#JHC;?3_4`<r|-r
zQ})rr#BX2^STHFIfECzFnFS#A=>sZ8gsj^%uxD3bw`ow18I&uq*PMxLd(bLu2(c&R
zkOODTE^5qGFykY;z%E-&YIqW>+6*ne$*EpNwI5!5gOzucU9!T=UE);U5j1WgKwM1q
zUD#v%+I3KcMI%o6N<#fQS{_m<?H9tfEm<#oceIw0P)_~^vXB+Aq?k^Mt+&#?SG>k`
zv~vj>?k8*TN7@jz5OqS}!$z?Lpa2Jos^Y=7g@bRh_dkbwC5LyR_e+5e*dltRPmDR3
zM^G;idc5G3!N@r9iY60v7-j)<HAV{`z5!VMKSH-9(LTn$e-f<^=uQ9Rq6NDcQETI9
ziOmcM93~qLz(`;AG~G_aCh69DXpp7@8$HDOQ*x;E=DTG2*Njt~?x8Ifky?LS+_;vG
zZfP9qgv5_+jM&!JMp7a)E4S}SKJ`@5`!q}Y05XSJX>1ub`kVt?;kjob3(v*D0a0E~
zuDymeD|{R543~G}Ac6;?rn@N1qKX#6^X4P+=h-=D!ll!Gl;Ega>_Ke4z=lM~7WhKI
zu@97?mG9G_tOXbVzT!Cq+)IS7<eaB)29~CM>``alq#bw6I(!Hvd2q&gAHj?*dkE@=
zQXPtfqzACf{OKG>k|d;TSAhN^up3~R1@u}5Q<Qb+L2LFAtB4V6_EC$_!`AFEU&(@>
z?4obx=l)rj{ACvd6<EYxW|yuq6-&6oskqC^yB1n-on3M(UbVrkc@R~$8ee%Qxejyq
zM|}0eq}u!O<=FK6kXL;l^;xQBOVaZ)qxU7o?1OKMj{KNE{GGJ#E7<l~{a;g=y<Z6$
z(OUXA1G%B=Wk$!d)RxDj{y|NxuekAHqZ)(k$a`ND?0=QB|D_z!2X5XFy*l)+Waxdx
z=nut1-{Ov<=Ovjac0NVR7b<#M0WogN7Zi*x;Ajz)Qh$OA#DQ4w4CrXQF=7fpILG-*
zsPbB|nembS931R+B(8-%d1CV;4y0HGUt~8L_7CZB4g~>in>d`ygySdZ15We}_~a-G
zL~0{N+FEfy1(XYXLA(GL5W~(Rh+tyPwb+Wqs1odYI*X+pbZ)`TLTQC51g5lUm>0A?
z&eA=R>9+7DScS))D0bmzk%jQS=fY*v0jc9|aRZLgeS5<?P<0_3LfdSZO)!@*M?;_w
zh6>MJWalqo{TGHnP}T*8=rrK6##YnVW6lW^d%_1TSO;x6qn`XzHtaz-SilO31hPmD
z^zSB!1@_TJ7)g~RXOf3z%s%AIJ*)#(>?5e?o#LmQ<4?IJe&U;P!Cf?O&zp7?&bg$V
z@u#vbMHH{ZsW!q2Z}><rfT_sRRp18taED!amtDLPU9tjWpI^Hv&}^kNJWi;*lcd^+
zuUv~M#ir*CUgHM8c{8PLOQd^(B_c`J3vuUD1g@psFH@Ru=FAt_y|0T7eV5n&E}Qxq
z(nLPr_RSPh)KkzF{p_&onY`~w?*8Y62j3J8d{YL;{>Z!1qwh+`-zmp_Dub^v_zpnH
z^-}{N1|*R=X@P_G(YX<K=xhs;kO@K3pM?w0;vw$SNYR8*1TOs%O!R?E68)+XxdT_f
zg&?Efvq5BJJIF3IEoL1k->@)_Y0y3WTGJ+BiZo>05x~jPw`h<KM)e)Q1ia|n2)sz)
z)wzkiNSH*#Q_3qG(z%8GJ!jB4fn}bgip%6UgIX97YxoHOJl>S_eN<iNmM=vWT?);f
zi^%!}aCs&UImb|dOFwVaVYSgdv^4}IWt<C=o)3kaRCqPI=o;{f$h(YI7_{6uB}_QR
zkAW~O#9+bCHHkXul6b-~ZX5?P*pU6rV>XdTEJM+XdKh8B8Xz1Y0x8pgE`nR&L6g8f
z(;&)>)o&R#XdN}?5IgB9nDY}a_=?UmMCZID3qU6@`!XnV;7vom!i#RQa<2x+7o%Z=
zmEVafyNx@LufQB4YZQ^TvenqCd-1gok{h;?>o${XH+f3r%1uG-W}NCaPmRUn&6LIm
z{Ce#6+DvVEBx-$>rri>2zesI;ggcqtFY^YzEgt!?bo8gZK@@7=C<fk0y1qnYc0bGN
zewI(Yk@vmL?tYQo_hs?e8@#N1?AP*RzgJHDFC}&CuMn@&;rFy)0Y<nLpbQ+*0kUub
z(0~uvp(mrXjfVT%h=I86go&4JzY<g-^dxP7E$9SI7?LDbkECtXBP309TF}yl<G#{y
z$bde`qyU?bNa**6Xzuc{zoZ%`^juGZzm9`V&=ifzzvV8?7gVdT|2fHxJzIKH0=;QB
z;wvt53$SvCj%IYp!z{gs-ZZcUD(RLXinOSq7qaG7OxYr*<TBt26pi}|j(TB>bix2m
z%%k^HJ4JOnu)9KKpM_*DV8qg2Q0Ax5FIY}cFf6!)=Pkl}a!NSn&Yyym0WKf$9Fiy2
z{TQj!4zX|)&_#91jepu(blxFu(v;c1ht+RI1yeR5hxRc0tRm2+I*S}=$~=TL=*GjA
ziZg)Al{dpknfDhjxC&++`7^-ELySiIMP|+w8Z=xm(mxH(y^6#bSACyf|2V326*&_r
zG%$N9xbS8~$!b*PT}WJf^*X=i0RmtFvIG@cPpLIg6P$z%ELo>EJxI~qPieSMmsxzx
zdP3bDs2l44GQI0sGWG+a^w^KE@r#apS3L4v+2QZ=sn@v&N&Bg^_m!ys>-=Nimrwmv
zIr*+~;x%T8u<8q8e;gz&gpe-?7dS(?MF)~0MUzDf6Rl0OrABn=&&xs|J$&4x(<2z9
zvmy-_S?ktsFhd1Jim=wl(zY#}>V;F75c*f5{{QeAWKI|z#GIuXNP8k$7_mPtv4X7Y
zz+;6UhPs`Y`8fKkbq#z$vry7w#PkslaS#gjhbJkQ6HAu31s9`pKjY-1591OJB};$@
zh8^eFx~bnR0M$ZP1Y6iL47LCk4)}y{fi1T<c<xk>V^ptGRG(c$7fPtGtP4!ZIjqp2
z<qoYaXhuNch1`h1L-1vR?KHgO&b)EI^m)h`!Yz3k4eGw>3tpmgj8trdzv>}4vnOmA
z6Gh7ql=?$<>=Ea<$)L=OZv0t?xRXu^)38j#6ias83487Y<(x3(C7O2^%sM4wzBmv4
zLOu*Fyn#Tyh3v<WEC4P@81zff@CC9W#0xL;mcnvf3eLF_TDZb4y#;Tdr`q7xZ3>Yj
zHIL&}x04`TsH~t-O^?NGPsqksoIu+7Qr7((YuMtB7oxUDVyfdw?!f!9v0sXg{!lXV
zzGURviiw{}CVwg&`%C5Ize<OH%pUwv-t%=%-?#gybDe{C)rYt8hhAj#zs&5~!a{Wp
z^{U{&+tNXJ_HS@qI`o#95{KSl4vAR+bWEyyLL6BAf+M&=>O;^BLCVtFs1Fb5TNpti
zojw1oTz|kt?_tz)M0@){iBwcX+R$SGGROtJAuX-p9@+6mTKHG^%H{Ynvh<DFpx(m2
zCcsQmfBx#aw0#35dL}s_69zKcYwrsia2&xhe6xg-E1bN~WAZP?6<x-0cVz2%384&`
zFt!340hXdmE`l#k>0)@^xlq{*`0`8~24b$U*zDJb@{7SE5B)`0P(I_6GUJv&dO5Lb
zj9Q*RMhRzNmV+-mcH=>9CY<8N?KtE1+!G$jv#z{Pd_-7j{@fdI3C}Ww^9;efU)q9a
z@~mytQJbhytMJ1viI}P`0gmv(8v$9DTvN^f7Z<@SLwp_umS_5T@5~E6vWu+3>+JG7
zm?-iazlg2bK!!xE6_QUalS;mH6;&4^NU`Ld@fnm0K?Dw8R<sgV`ydKaM&%m6;jy^=
zg-H7>x#_W>2{!&yVe6CBc2rtlNqb&p?SGR)(%{b}hkwc+c#}(gCDFm;+{{1twqWpe
z&e*T=iT{)x`KhS?b?xZmrc+yOllS|NT%=A+pX=4>=J!|6x8=>W)(v#b<*FazLsfJ=
z&+U0xJ`Atxhr<51NRs&@e?dQC`H>&WNB&Yc_?Dg}qTnZG*~bh?>llp@tzfwRAGs0S
zfh|(JH{8SdOC%?f6o)=m9I-=hzSbA#aQNwVecTso?up2Vb;5PA`mRs~V}4Cki!&eY
z2$VOIE3fgPT@^T41P=eQuo}4COsU1jTAT}UKZ8C6vGoD=YKmL**%i*4<}UUz#gtM@
zNP67TCBTJ)I-?44XvRgHaRAD2K{lfoUkuATAC<olopYX*KJA%s1m{tC#E<x;90hCs
z!ejozF<;?~dm_$>fr)yGR8#TC9b%86rgDlOcS^wZ7}+<-9YZIvC40ysY}kx7%*wj#
zk$h%v)Hvl7e+pNQaZ}C-)ArnxNR9y+pL?d9b>V#i=vdiHp5pUCdCOeYgOH*X_w)tV
zw0UpY=OINmqN~<oYVPwik3$M?1Y<&2yb@fnOpFNSJ!lllETq9GeZ2)i!;CSea*dUL
zBfj=wlI9DZdMmbOGqwFI0oD2}v2KH-S`)OQXn&Q~@lvRLmejPB()v`WeJbgGoip&A
z;^4Q%M}Df9{H^wr|D`(lAEjg8lbIf|qP~>FlJ9;eZhw>8@vy1y`smR7*|B3IEviXP
z;be2^jU(Dq4MoQ~8$YF5#vAjGH!9BeDf<U**J>AYwKuc-pUVcQAJ8@p+oE{jCAuhz
zhu))wqU7+qlEH6D>g<18(2wQrH%OP5MA8L3XaZ%p#uPxWYoubsvtW>Z0gkrZF1d)K
z&~%>^=GbfdaU^&2hnhgaC<0yW9fY{<ZmMckpj=6=goTQ=pIai;ofPGYpz?Z3<+7k^
zg<pOnsr))FQgBp8)d~U_it6sB)ZR`;)RBq`z#{J<aC`wW9*!~qUVsT;(Sh?>qKiJK
z*+M>KQnFbb*22!34-igzCmr)h7!A)n6E6ECBx8yxJ^{p_SzgK0uJJfy=s2VaQ$fp!
zAv>~6gL&N%>&PLL?buEeS#;Go=_FIW=qLRQ&F=Bad*S)ZjFhuh>@iyoG;IoMhV17p
z{?uP~$wzV_y7)G?>RxCGwGvjc%2D1&@EgC3QQnU%zZ;;q!psFqw>VYn(PeAFimQ+#
zq(Mv>y(J5nB|@4YUJx!O5@X&q2p{0$)I7-A|DCMwy`<|c#`Lat89i^sy60luOF`=s
z5-m>zO^*`Q8*w%FVr$mGS@wbVlx+Xk1;am7P5y??32g2upZpzb*Rt+s;`WEq4s^q8
z$r>*74t#QQu;=<o-JO}f`LUkWh4Imrf=?$0XLPEG)@tB3uB-W^ulf1)3tvAP`|0)B
z+bid%=5Cb_Z02CI_V8Z-5bUmOtTFbzgqsSgP>>ZLdPjm9d|PygG*W<P8XuJOpow1Y
z#t4DK*CQ|yz*F*$FEHH)Uv#ncVY&$apdII1JSJyB>!pokLRbROt9r=PZK3KGz~Yyq
z*%{|8t%9l))onrbt>h}|20%jqIzi<PJR!tp%Sw2r*LdYvnp{r8(XLfE-Ss-^s<?_P
z@l{t5$as(}ZrK%#D7F%-uHhV5kQFYU56zlm$<Ty~?N+C7=v27;Tv)~&*zy-lu+l#X
zlg@@^P6I5TWUM0(2c*qW_z#GoVbnPRaE+i)cZxq|A2)7+rAGDuLom%QSW3}s#={xc
zY;tSY66)cg!#=+oRlFLKbp<thuxu%|bj>AsmYK8Uk#WvCb^=usyX<yg?lt5ye<Zr{
zyJFqzl$NI~cnnz={S}M;S&LDXYtpW_DOB6@q=qjzmFti&5Aj(>#saH=ObEHv>+z~5
zto&6U*&?_4en!umvhjc9AN^Z;|2N6HXDRz$<_`UsO?@kBe}RP}vG#?i^;v>?GpX@0
zynSKo(~Ny@L>({W2Z-HOJN=9L{BP<rf3F?=Hf#TrY?3X%<msMBG|SDM)Z|G@JF6==
z+ut>Rpl7bXdbGayK&fn^O><aXeV)?Ibg0kvX|9fUo*$^48=$TXb}#hRu1+7ldG%52
z*iHF<SQbz62EIXmMq&T^+yS!w2$;454{65>69j^kezj?PgcC*q$l_sAwUKqoeP0s3
zU~x5X;CK|$YKS9rJD=btA{$1D{wdH0jRRll>NU`mRK84PO1VNrOs``EDNv@mg&^0U
zs+s_Z7t?`<DHS&oDwgA^N>cX6;Xn+GRm(BuU<$_pp{OD!4Ac1+BS6FXQeil=Eb|OY
zG|d#AWMNZ%#tc(5g=4gX#W*_xXI!2Sk<0)z&x8@2=HV^GDOR(A>GK#-xg!B0CA#t^
zU3e4LoI(4z(GbN2P8oFzE6O}Imir#2v_47GJ<sU+3W<kTyU8iN9VopRU3@F4=23XT
zN_6>MU;zmVFTTmsYzdm5LBCKqB{x0I=z5#p@mkRQG(r7{i)minBZRmE9>Ck;k$;sR
z{daoDJ7)e$Na6M9%DeoAt<=_Mp@r*_r8q(BB_(KhQ8fCCYWlzH&;CDEGyh$F;&;XH
z5AuQUGrHdhTEBp7q0CCtK9lvnm3F`3H*ZP0zC!RCAIkc^Dja@acKrK_slO^G-q(&k
z&l`Rt*!LD&sFk`KYMHDygEy#_pXe%IJh5->{E=(ZtxJ>IvqKFV3&$=D_Z+RO7^yFr
zp}K3&AJoiI%88EZiMHD5cI84(>&3R>Bh+vuwW>JqRp#K|@(#W$?|o57eFLoMi6gX#
zc2O~V#5FBeSQDayehA`V^`qZ{bo5|7yyv;1^9dM25U|M6syIRwcEP?c@dQSk2MzS-
z><PF;I3^R~MM@~NKp^gCG~qC}2e?i}x>I7g8<~&<p-G9&Y3Sg(gQqYOy;I#nffZYF
zCARc~SmB&bB4Xt@I*J6@ZBn~R;UB_R*<x(TVszdDOEMFXG8rJ60$hQ@lYWAUz|@oA
zD?&C0){r3?I8{68sGr`F_r^9Z;S57~#x-f$DPa<>f^*`uSL%W*e?BB{g;)0w3wyEE
zYkbXvjIP&m>Ro2f*NBwXFT)C!JyPemRcjoo@-AeHTeTiqa0As6N_1iCi{$3#aH{;}
zmjnJ^uHFMG$}HUio#|2A91)Q$A_5|kb0~7o8H%DPiUJBKiXx|9GDrr=Ns?p{kt85V
zKr)C3NSn3Mwr$()>FJs2nRoBog>&z_>#g;1JQRP4OE&xa&i=x2=+t99G-S^Lai-zR
z0G&Q-RyPQt(So}FglEAHt@L}R%uS2<Rm+4&+6c*`7IoQElCGWFtO?`DIV<9k=k*<*
zvLF4czp$JB;aC01Iq!u>{wv2+)O0<yPh8UvAtsE&pj0j5U#G`@U_+oR`6-a)uv@)g
z6+300H1C!5*e7$%CgY81{2U{?HH{T+D0({3T$kf$66a~{r7jU>twVU2aBQ?fEL9p)
z11hctbXVr(gix#FnGJ~n4GBIs^O-%>$vu^Ew{pW86BtE7?$Ml7`-o9e{42tOSanXg
z=a|HmP~rE$R$n28&Hn~ffR$|w>cbXsptO#9xO=9YGDpE-6v|`g9Ec_7*jbnOd6;9&
zL+gl1m~GUQUGy|Qg*jjvc=QZ-jO!kEgEPPjBxV~v=|Du!0Daiu3vj7;6#*HL#SN{v
z)m{C@yPSoiBtki;Rxo|WT?3yUU9UUpZXN3GoiG)*R%N&5uOU3>3oa3mLNtcc1Y9u4
z4KFIWG+`F8xFO0Mu1lGf?$T72s5XHxz5w`=GA<U;%HmT_I;}u(y92qf;u?fa$OWjg
zlC-!fW7{ld+$dsvQ_QkefikG=4}6VjF$Q%4CoH0uVV1DCCA08ZQS(|<D{J}>U36%M
zr~uJQgE3|iwQ9g#&<UJDU@lMY1yhk&GX!W$(QD9{GjA5Lj4$i6=H<Qa$$8y#$a+Pq
z{NP>oj#~V|v*>%{_+`tab-VPZj#<y#^4>UJd*Pn{j(q){YyK<m(hp&+|D;!bbSrq}
zS@gys<q0|GJEW_jTcO6wE^);zbJIR))jDC(HFL`YVrRyNZOjbUgJ9%85xd}?wBwh!
z8lTx&mYJ4DSJoHjXPE1I>ubb0nb0&OX<D*m6&bdbPFA2tZ9FYI&_0jD&=EbIALJfu
zuao4Y(^n8XR75mhrPU<{G-d?WMYu(Ixp=ecOi`Z^Ib$2u@0jq28-eX+!V$THxPUNZ
zB*9%)QN#m)3*{IV;j@+zD7=7RF$1N<Bos*ksH<}@fCKFG6-PGQanKI{B|wZzT)Xxa
zT-*o@3>J=Y&=`L?<rp_>AF~U(@CjrmzxGjbRe3rWTVLaSz>B~RhXEi3J-k4THm2)R
zx-{K76`k5tki$h=m1C2FLmiHSI2Iyw=aLtuS^M0<;Q@yV412}k0(A=F{APLQdMWD)
z3De>WdIjfna?X?TBn%1xEVxQBog99(RKSZ{m9U#ggn)J4<i-WUjEk?!_P6Anx>ej!
zTXk2$y6e2{O$D#J8va9wx0GoE=8=o=JutACS>ytaW(b^3qvrKl2#~tYnKh~TjvBI;
zOe0oxgU02!$U<&q-Yk68JbKMGVbePPiAngfap;0Rdrm8G$~bDpHhqg){N6q9wM!Q9
zoL2hLqu?E-^aHKplW+CUl#&nbMekhm-gxA{!4uBe&wR>1cox1U7rZ6sy>>``<dy%z
zyYP)?{wqr18%q95v{a+=8Ad63ODTNep1BSpLCvxWd)kCGZj`!`n18#D;8ge<7YA9Y
zojpb&snYaRy|u0+x|@5dUL@k(OqixBVKy2~sX<vmE}20T!;1povUG|`0mC+fW}4+|
zp2M)n@i#AFJC%pna`Z2SG6)BHBPnE*gr*Gkgmvr;lrYrI8;77A@xBH0dv2Z29GD7;
zNb|5M<OsAGgQNfmyLe#Sh&2v`nTJgq29H?~Y}~OiX$uuD2L5rzI_v>*dg$)hP3s}>
z+GVZ?gk^A&*w0#V@ik?STE^%ZI~+hm$1!#lwbPjN1oY_pBJe_w1_t8XgP8?jNHA3V
zAzk`iTrLA=sOH+Pi2h{jMp+9~XVqS|CTe65v?E>Ucmn~J0tQy%b_XwX?{WtgX!`(J
z9hkj{!JbzfYNV{t{9b%sHyfj~C5?+E42!sjM(v!lN=YX%<5)KOj3&CcAS6Ihs1!4-
zmD;Tlm9}n&Ix1t|dC8$u&i$^WV<${2V9X$7T95UB&}Jg=!f)z=Wy}Kl<k2hPoVH<&
zDi-1qiN%$fEMr&gu5Nf-dx<h+W88w2whnILM%J0%k+WVvxpYn6c1+$fj+`fPW=!K(
zopN5-W;}JydTw!b%|7#)XYqS_^=F@|&y4Dy>6JghfHtRV&&dVvJPO{p5IN86(>L+7
zQ^q!`|G-ebB|H8VKl+ruM>RdQ@OePxdu~Df^%vCZAKaikqz`(=J-3P3cFA10R@s>o
z!D{fcte_c`#(I!W9|<(p2{6`-b~NNztLORK7Y93)vK$FVjcgy&G>RcrQ@keD?{+$;
zI)q&6@0J%}na?Dw6W#R_T=di3?4#^REMqygvm1+<r%&%!qR(p~FA$7IjEANX4>0gV
zpK(v$4?-2H5+*D{K{E3;Q48i_v%nGZ=SXuRg$`s{M`4)GL%e7jgv$`%@!<ES%tI#d
zE^E%TT_kWe=NJv2x$GD-M{r#vd|(v5FlEjLf6drLJj9AeE!huDgU3yS#z?-Hn%}R3
zzF^;bCd^Uu;Bhlp5E_vt@ePcb_YM4pG$=io;;H1?ridX|*7cXIYA>3WOJX>YRoxZz
zEjzZzq2tO4x6yQHP;RSxcB!~^D7&`F5e_$HZ0e+~s>O^;`O&AUmM)@s?YwRd{Nn|^
zd_h$INk<(#7kpTZb<VIB#-oaCAy-U5Ugo?>ovKH_ibo#=fb&*OD5*j<3{<M!U}?cT
z3g@h4BM$!a=Fz~6Iw_Rpk@HaL`4pT17Qx>8I`M{H`j&eA6}@!FGxrs>;O*Cr2};g8
zm}mA|m$c_*(eoty_r@)nCM<!utdrKw;#ag-6Q=PiyWI7bT*!5jUf17y7Jkp&6z+KB
zzCj3&$1JWsvQOVOj$T9^s(tb!&{SacXW#N4DEZ$3TbNoy;DeI4>6-rB`P#a5#-L5=
zR#4Vjd`?4iIxX8-tJzDZiDBFnZezs%ZM=(tmySd_!@Q#~;$B_yowDeuj-2kYn94+Y
zZ+YBgb6Q@YMIqCyA;!Ie?Huo}l^<kR9^uuL7@X;88)a|AGFA4~y2!NBiVX~p;uO31
zbdo&ps1siJ;Y~WTMxA1o91#YF&zc2K7z7L(1dN!nr_4FC;3=!fS@i0{AAa2fWv1*&
z)1V29kSVLs8LW7VNg&{cbK|5<*sNW|f<x4zWAvN@(oHDskDSI_Xp=wyaLSTBvuo3M
zqgn8zp+9k7ht{u6?bW0por4+@X!z)90}`i90s+0r-M@X(FaT+@dz#cc7(p!O*eqjH
zk0xeR^PSVjG}#hd7jeP36eC_RSmv^Iy{t`xjO7jP<SOHG6lh^a2ftSCaarW~qEB3o
z0!?8quAo}-Ny+dd=UK!)LCg_kTyf}70*Fj*oHMGCg8XgKBxTp8&zv?4oYnQ4l!m<N
zaYq%B0J6iZ2jDAU$~1Bw(vor5EEFWyjHl?p@wxuJcfl*a@|~a?A48je4r%=CU-OP$
z@rGXZ-naZcy$s-ZMJ;~mfljagG~{fMh@eSj+Mw;#$JSRLTg9)MMK6+A4@mf*347?6
zvS~>?vW5PczHNhj;yP%{IrD{W@}_mt6AR*zL&i2<G>Jij8H%;mozgd`MQ<4u9|J0P
zSaqM!FpW+#O7Sat&UfgXcCQ5MZA7Pcm#0UqG{%$#S`{#DhHnx@12;0fbuU*XFv}DC
z8q<Q>vso=U?4Ih>d(HVzrn{!PYsOoP?l+|m)n2WPal1i~XPVPj?v&287c^(E8&ZNJ
z?R8w`WTGsrsWM_2HpXE_3QUa)>7LHPk(EZAAr<y4(tCFJ^^2KzNm#Z;Wk&FQ;~>~5
zru~AW2-GP8P5MmkCoqE`q}oRTD2tE>mTcf<$`m<w<}l1S5JCGSfCCD1ik-KQ0+G$y
zhR@)2ea4W1-!L!;0OGxP7dCpn_q3^Z)ycQjJW(=wSJ!6%&lod-#4$tv5j=)x3<$qr
zJ>PyqzabKBKn*Dp=hn-14JhJ6pXq58%q-3k(kT>xj{dcU-k=!s7|!coKZnsV8d;~6
z(u8z!Pb#Gxl!`cfAsC(0-v}}Go?{-m$i|%b{b<@3!pumTf-79;E%ZYudvqy5(WDJ4
zPzRx>s~`XmA|606Qb2t%w{m?(KjeW<AYv&bR%VPjT<Ow0cF_?5b@p?B3lIyb|ApQ3
zCA{s|$oAi{Vb^^Mto{&O|0$>rXFLqQ`W}sjU)yqU#xp>HT=Xm@_mxN1D_i2Rb^Mxf
z_?$`joK5^A_*+DE*b_!ktNLM!I;>ff2vm`78AmKyBFf{Sc4iq*K;@#9e{{;)woF=f
z&E58|{sdHqxBfNs<`?`6g6e-^Rla36{EEY6WcBl+jKbzf@6qz;JGrcuT+ZE_S>;8X
z9Di~ylakGJFJOBVvR$q*ZSz8%3nD#wN)!4jlIn<b)=)!MS6*aaIZ+WyEsby=ZA$N}
zh^tEpXiDeQCx@1Eyg9}y!6exrGo=t4jSOGY9I6GI9>%#g%1B%DAXeRy7hO}JFsyJJ
z+O94*5G&4C*Bpse0LvI%04$W&jsQ|$-6PjSvQWV_0Rxy!gNRYU2jDV9s1$G?6b4+_
zMa+T4zOtJ!a|~ZK@V^H~XT}0>h793?{qE_}`!zgoD>=8qk71)pLCU$;fH8;%07et2
zN&drdiArvmR@<TC+O6)|bJ@C4!lXvbpi)@3?2K~GX~islwS0mXB`osjdrm;FAy!^A
zqN3^fQXIxO;B_=j>=#43G#jnc-w0v28WRoF+z~dI@U}b1M%klV!S$A`W4n@jw;FAP
zYd&1l@<WXZ_lIr7nFf+}gZD*!)+7`z<FJR&l*}UM&7)?`i0E09$Qk?OHFVlAt3L+a
z;QoLk+y4>X`ZrF~7iQ&qFbTWy=a7caK{tM+m%Kyw1iknjszYgoJAS2~sD&R~GG4i)
zZCl4bQu7^Bqu+yg25{jUgD8P5-H<tD`l!0!gkjjC3C<3o+<y&N&W>33F52;}B7UM4
z@3`eXb3%V~@eZp2-~0Edj=y7#ZTlnc&c9;s{*mARQ`ODU!cfotRIi>qCS>@TyTvoZ
zwYOWdX(XjEJ424GPHvD>aWpy8-?BQ=wLaRtJ)Pc~Mz1F*nGEBuf{64$>zYJ*0+|$I
zEAMYA73WS$^R^Cm&@Tug6Af2`vI1QylY&}{lOibw=`_m{rc+*YY+}x!d-ew?Y%Xcs
zLVJ&NRJJ0K$u06H=RNmG+jLG`vxSrk#~6k@5O+0Zje}tTBhU+0JtVb!aSIF(Gpvni
zQ23OAYErngX?Q}IK4S#)mk?L=<89n`Vi1`xkTqz)7=lYwal57FaT_&M>f~+>&pUX9
z<TIe*h4Ps`9iO{uo}G%W?U!vE#SE)Nbjt+P^H0j9^QmMXzLa=KIv$002c_b$qR$IG
zgnL9;-vUM#!qIrMS2P6uguBhqahN}eCa;jMutG~UHr(Mg=ll<d`0Wv(p|MNO>6V&j
zzcy`1jXI=ByRYEZiw((tQja+ajzXLcVbUrV2^ZM1Ma+UJrhY`tqW4B0bq5?wk(mMo
zk+YuxG>ozxX7#7groVA+{*6`lnO^c1{q+Q+9O3o{X4OY#?MIC83$FhOgVw@Ze+z5<
z&A;XcS_QE7#y(}sK54`D>bhIj3#W91-p`<T>9FUGB3DSPSvks}EV*ARXk0(^fob$2
z9HV>oON8^((hv0VPp&!79j|S>=e-H8{VBBJ7hpWF`bSRdZ>+9At`7WONAzx2r4sox
z!=XZUTWZi~O~TqhS#w@^1lhzxLzb)w<w5Nl!=ftOxs2o3luD~2+`Ec6T}5Hd*+KnP
z2`yQ{3*ANcYOhwsQ+kUy{UzZ|iN2+w<TR>fps|9lp<H<!qbV<T?cqRbs7ttwTC|~d
ziJvQxkmQv*<%-01GV#P2=^)Gpi(hb#TXIc&?4GvanemjG^^Bapg_=djgcTI?e+3tb
zKCDB#r|UCh5;&<(AJ+33`f6HUecDt6QT-$zs8m1}BKL=QMu$3}?$M*>en;D@Ux(VS
zMd{U{4jM8>ckMojb`P%;2)w{kSYbNeBP5?um=5i}CZ%81tw+iEwzOH}8Rfj=vgrcq
zdFaqOdim-R8DigssBa~>V;jEq-UDL$&xh_4#dVh$Q-d+1L4OerMw{!m=YzgI$2AOs
zz`BQ@zE{8(>z{e4VkQle)~&LHW0w|ngycJ}Ngb9&(hr}~P$)I5i|7yMnAnxCdN<lp
zZLhAN&Bh9a!_l*PLBm=oN@R~>McJoU9@=c4qR|=IJ354fqPOV7;YLJhPmtZE7QFH)
zL$m!3{3NIOOVq7@#&-X~YWd>d@R3?de00cs=A8Y~E$6js?km^4R~`j#owA>s#;%#g
zJT{GbbkV6>8WlH`JL))g#V@-Ty!FU?Lxwa__|`q|txd{?*YzFeEN%mT$c<mnXN{Rj
z%<3<(xBgnt^Q^L{IE!K0k?cLvoH<w&H{O^q-+iq<!=K|wGP-!yQ~Pof#gr(IaB0t?
zcNc{W*2H(0$M#poPIqK4_m#|a<=-j_A8AbPDhbO7FzYShG^KbqCDThe9?3W{I%@lo
zE=4<%x{H$so6E;q@?tC$!wt-XHD$uREc27A8QE)|sSD)PCHEA})<Mk=`Xv{^SD1+6
zkgx)5xu+tFzUD$CuAyawD|!V_n*=^EfM$&hhG)M9xlh|`P>TZK+|!{BX;B98qMq-4
zqX2|WGg!4K18VMf6;T=B4v5_aR`3dm22_q1_>N+azd_NdQ`WXc*0xpFwpq@xTgjzY
z)qOyXJg7k)QF822b?sMjB)X-{nuT>Lgh^!rT7~FfJ|>&IPdo+&o&sTkr_eOL|2!Mx
zLtuXq4&2?a{vyKsMudS`5Pue6{E3hLr?d3GoTY!m_jUC_E!JiG4jJ2a1?O%Ra=!)@
zh3J^vFr?`{qD<*k^BpwcOe1~=wg`NfMPs(rB6@5bQXX3qOU9fj5^Eep1_8`4Yzk99
ztm2pOfK|dG#xppluiGXfkeWu@gig?XJ=VAt@et#R0;=G>eu`}UJ)-k>R`VDC8z23u
zzIYUTPcHhwz2Jju{u`(e)Y6ZZDH|pc%eui_315{lDowa`>xa(iu&3?P*Xb3X+zP&T
zFL>vk`@$w^-5i{n_}G$IbI#cE$bF7xSx11m>T_!2R#9eVUZhWbv}I>LbGp4?s5G@C
z)UqbgZK^XbhGL~Ja?;O4HH&UtMNnH(sXf=jhia2<6^0Gf6Zh&<R{JX!yYp@&Q=6~(
z_m&dTo%x)mRIeL^XJe9Ybu2C0*EZ9`B-KGb(o{Xm%eFFxIbNGp;A@)Y?vqNkPIOc+
zbTLe-SPL&+4l3TJm2Wr};5Tj4F=4?ba^5m>PCsY_Rs7aa45PSXovfnfF-y#t`M}VB
zLZ30FN57BiZ8h>;W!G*Mw{8#=q2oRHA6D{*_Z%}}PU_K7%RZvxGpO#_Bj*G?p;N)B
zL&Xg-791er^dW4NT)Jc|>&5hOz$-y{!Z`!X_H4dl*P-ZiTaB9+Zj*PorR;L&vQ^6^
z^P6INmFMw{ZV9ha)^XWX_(=?DI3W{%1i=+?K5VZT=Pv-4D07bpE_Y(>5n+M6{v^o!
zMvwt;!La!gulJvLX}ha8iV?n6AD|`=$znNBtj`eaid!EtIGXe!y#Uln&6{xM4OvLt
z&FKX_FonDxwqPEP*m@ad2=JDG9m-wIqXD<@Ii&UQkO^lNnL+)a8Fl)&hVO)u*YFkh
zeht3?lZa_ZV$eK;tA7cu|Ak(KB89hZxi7p+-+Pz+KrR31Q})p@^BK$~`-M%)69;G%
z$<Qd4jiVQw(qA~FzBG+}Y!tC%mH5>4+H2SJXU?fl5u%~U#wKBnFd)9Sj~S<AEjw3y
z@h;q`t!Qsb3A~vS+L=tBs)-z}W)BpH+(>jBZ;CICr9`_}DG48=o2VAj>{?^I?>8ns
z=*YTV8lB8A&0*Qrr837GGfTo9uexZ2n8+l#l30dvg&_`|*H~@ofwghe9HvDU)g;M5
zE63ZsEX*aJ<32>xrd39flRZf(UPgIzn@A(21WtHX`E&?k%hE5j;tfj9id*s~LVA~^
zb(CD=ss;UkF$>m1bNmW1#y~h+_u(^c<Ueh~d`O~=gJBdLdlZ~{v^<AN-edZ-aRd6K
z0b|OTIcwxUV;t}hdy>xtOv7_n$%*JuaOhTayrbmYqwYSa=Gw33HlXO(BW`d*Si1tN
zsBV>zE;My+c{w&%fihtd=3$rfsTZA5DLf%}O<1eoqEQthu%j}`Fh1q1(+U}<<kF5`
zPTtSuvCzGutZ#&Z0W8E}Sicbp`bL2HXa0ac@%t0_fJ5BF?+gC=^BLM@=Pnd2pnwVm
z>q2HX&f7M_WZk<jIp30YYE>Y2YWVbN2MlTX-_u|WXfOt^xOHGOmR=xg*Y9ikk0KRh
z82Zo%N5{xT{B*Gz0#zXo&|;%OA3#T#3T;ROxoyOAIDIlF^oZaoq!*0=&PedgGuNDF
zfR7b&HaX9b%b{F<3y}flmix-P<b!Y3FFqANyXAimV^sb~F4%EOe{B@`$T)n_Fl@;(
z_OUT%PRAeLX-M4%GasgOqZX|q$8C}yn<uX)<+U}(G4EzEyD|gX^Mc2lh>6Ceo&qAa
zI?kmwk(w7mwv~}qIDOb%LoV6L^hP+fkZs>r8Vk8A+DWZ0k=~xo8Lm#eQxH@c>6FDV
ztBfG0dRb)nm?u*V8wgrGLCx?r&!$?(TatV=E;Yn(!fXwgmP)k=UXbvMg50jUniDRj
zr7Y{T*!<YiO~2Bgf-u6caFZZsd<R$Pl)Ubix^5r4XvP9kKv<Ke$W-`Ge#MK9_n4vI
zv?02i=p!obJ(um;l$^U%T<^f?!PMX?;UsB8I^Hn!J`HMl-NT9p6dZ3|vT7DLM$KlO
zjCG5=LnmI5G;b6pVQ^?IzgCF=p<ODfUkx<zsul7m<q2t(9lw$#Zip)*%1$fgAHAG@
zQZ7wUqW~RVqB_NARdY|tXM(?u%A_2Wyt@B<^j=YJJpX4w1Y5hv5)R@Lmq6g3`I&z@
z8vuh#+%+Fy3(XMc%<54(jN(rj$F2)jt%8O`t)y-HCEGjr1l2L}lmQv{yI08l>Wp!%
zfCuuFK3Q^)0<|B8F*RBN_aRWAOaiVGnPO0wQP@L0){LhA7~U&nepB40U7kFs;CatD
zbdePNP@OTULLbu%m{F#Ts4_-$IS<U^7R=(895Krw7kTJ6wkaC~L{h87$K<>>?)fi#
z%HMkyy`~nwqm=B}rad)}U(*kt(+{1|3!5jgXSAR*v!@|m;D`xjSC2DgAG4~$9CwWE
zY|hW_3bW`h5AVribQLm3nv-Taa{6<^`f_3^TC$GHmt>EgxWaeJR!J`0h?GUPDT{P(
z%?|0UPG~0zLh6!y%Ht?GA=Vjwx|zPDI9HWKvVNkwVSbQRX_#YMntv9<Jdvz@)s_^b
zekIaGEuUr|q%Rw4snB%QuOPstB-kO7W?dfU+Yo71N^nvNZZUJW7zH1E3V)#FZF^@u
z^U8baigRP~x;1CcDs0}I{m_&(jn&X^Qq`U4lXK`&cD<|VIig3ORQDK?we6O*xy?1}
zE|{FdT?NNptS}|#UU|o!EB4)T_IJ2nwe6BJZxbQi;Mb^>G;Ni(=#aC!bIGzplvF2X
z&>*N)&Bd2?DIaRiHLeS5mkDSTpH#qjnCoX$3wadtcocJZ6f@BNmkQ3pdf;NhLCiF|
z7`;a<47T?iZboG9hV;A41@hW;jDHaXc?EvM&xC=s_V6=6TyTsM_H7sK+tBeW<Jci>
z*LA_NQ^??^gk`6=Wrw6aV(4CJ_kL;T0SWuN687Df-S5hw9F*L9nV<~Hq56;8A2Fcg
zKcvMNMlp^d1VKbsAyXOwlj?pCm1qyd?YqV8d$gGIa+FaLYuPw<$vAr1FmgpR@F8AN
z_n%VtAJ+;R)e4@{gJzbnW`1=YM?}-OWeZ}>Hf75pW0O*Zu>BP_&M0t5TEmwtuOhf2
z)=c7-j3VbCwOPh5J0?FtS)gm`OKW1xHfG%^a<rtj@@8gGT_oj3yjN8mr7qcfv^IID
zII1biak??fPF3dYo^J#W9+VP3qsq_gA}e0x?^u)I-d7pZSDi50lseXu-d{_s_FbR2
z5qqa7xHT)FI?k)e-@YM{GEzgdXN3^u;p7At5=&2(rYM%`YTOVT&=5_znc!U+L5;Lg
zOK>F>1UfWc^=l`5YZ3zUQi=GY0iV3LJ_YZ6^0#P(&lwmKoxP4p_m0GdXZj1*q%FJH
zHOq)alHa5{br_~X8C0hXYEbU0k;l}?ql!)gvbH@^7PnyH#;xLnajS%BJ51cT<(xs2
zsD2|>n3!R+sD6WhcCDapt)zK}nBmQfW*vA;R3FbYomQ<lrJVQGcvSMwYL@bAl%7<`
zJ*9x|`U3QCosdfxP(!?xckFV;Vd>O^lF0|fqmNvS+b0^nS0rqoNcgv+q5E(P&pCqq
z7hwcm2)_{C|HnE0SrA%R5Kf8^=HVN^;iJj8_FO^g(5_w5w(XqxO;OVpVdG{o^Hx#w
zHlXQ(UALIcEn$l$al2dSx0i5i6Gx7d+N*|wJob!1$U~h#)MX7KKcqzMSN9*%WR9vZ
zMpS&cxFM8i6N=trN;CxXi>kiU3e<5c6w;-CXCAwz?msEz(x>h>t>iNy>p3h>8B(B*
zDEmyP_&(4LUN+!7*5|C5#cmr%0c)7t_S!W1iBTl<_%%ynRVQ>*3#|xoOVBRJnXg>Z
zA(DLuk<2=7%{mVy4;uxUH%p_8D~Wj5k@D33%BY@PR)2B$cthIFG<tg`b+j=vp5c7-
zn{W32d5_r1qgPHIrD@4!Qq79lww-xF-KCt~vZ$U?&QxpWQdd!B4EbgPy)`+gfncSQ
z9g0}aB^*!GKj$%A*ycJ6k`h@-D$GhR(cO%om{-L3Rz^|FIn*05e!2dHa}moU)86g|
z!>O5|7v+{RvgRSNpn%^c`4MXEy|OkbnOjZ-=J;-Vq;0#WK6OY~bBf=x4qvs4UN>gV
z>oX=aC}T=4!^*D1;I2znT^G&Tr7dp(F(P_sRDhV?unQ(Qz51^vsB=R|w@y%}?yP1t
zaYnt8U#o^!4Qs7139r_kQZ7BI1X(@zgd#2$%sQr!!K0dkz6o@`qdEDw+_h5**}O^x
zd@2RUWitUT*ddA7!vL39<X+M6eWH>3&T;mEyUuaG$`M>(A+8tZ23~NFfY%-Y#$G|c
zy#juF2!4h<c}UK!U)uimMVod}i&g>SW<ldtA=8%Aq=s`=UFU7OMa(-zEpJIV-4izN
z!Yh1+%@TIKSIDE<Om4-DK`83gA80Wrlzi?fc=yYD_se+=%2NlGXu}tsZYz0@=>{*U
zF=mXz*8wsO)NVzr=!Y&U(MDy-sIMTVHT>sf$)lHC5SmTOd5+7tjmeUSm1yI7p^KKp
zCW$?#&6+WbUDFMj1)h~?BN_qID)h;VPQ5CO2aajm-i6OFQl4J4V-@>E(|2A!eyOPV
zZeygw{o?4s+Sq%Q@m<$Lnv<!W*#VF47LVMBzf;T{ZAh$3XYuX-^O5}r3E{&B75RB>
zuSmo=8YZ}C7l+%|rFdNnvWRffrjcYrtaWwH@o1dmwUiNJ>R$=akxZtV=LNZ3^R<t&
z*N-+)qiZWzE6MVF^Jh~Hm9{i?e|kWDtXFNcM{}Z2XC|{L$!FjyqdJ0C8R6PQgv4gu
zhD2h6?#7q}r^HqF)O9+M_tHHT71B@KQc#8u#cP9-{?;Sqm0Qva+vs(}fEi7%aYg50
zX{#Pt+q;tH;H<WbW}PsQmzW_at64xBII88-s5z@y10?ZjQ~^LdD&>OO4ZAN^pH?kD
zsZ;{vQGqk8Jfl{^qg=$J!nNay1pX-HRV_QEc>TD1{t1PG6Y{x;x{k`EpOVi8dF?%)
zaOmRI{TJf*ipA^`i^aNEEF8%CmJ777ecbR1(!_3H4}9(FUVjl_!u9}Vf`Ky5{a0KE
zrS0#CnIW8S=Qr*UG4JL#ZUct+ja&JRS}}j7h2OXt$P%@<BW%_wXwuGa)GlV-qvA6M
zdIFRn4?u^~Va+J}4#{ytv0(+Tdzaj9UqX`wbrj&z@SoKTn7ib5Pl-MS64MEs2a@0<
zEn~Nh!XBy6CoVemDEmyBL_XCGd7?(2QK3ID3|ldeeQX}Hrc0oXl`*c*p0|qM&<|Y(
z?qng(P{(B{W7@0*C&=9C-`OWV(G8l`V$Ap@wlpRu_GMEB>QV=h608j9E@0oUjh$&t
zpJ~m!TO8V%MIEgS87_-*)w#lZ;DFGfz0$lV6wmUys3`{M=~8v%?UlsMFNtaM^QoLX
zC9!WG-I6f%G}S-<?Ke^fzafe9s_~yt<v(hC{tQD~nQf@$tSqe|!Y6h7V0kpXJ0r9^
zHJ~-gyE&F}E1A)i=3gJ<(Um}{y~?~1>(UnCn3-7OmHEsyam_kv(Ip9;kC?Xl!Zihs
z5iOAGi1EFyedn04?GXReJ{C@L6W9V}5t0^nB+PG%8{Il@*m+LBT~Pa`fL4=`PP4FX
z3pV_kjeP3$ys9^N)#^^GR`YAt3urY6YB!$KZ{t(1J+4rELg_lMYUvrZGJefUK8<n#
zty+GKY8bCd`Ei9JUbS)_<q{sH;zP1IM`hs{a}G*l_Q$S2l-%7Al8O7oiGAYn`@|FW
zh{x>_i-e2Z1s8Y21=lWfebprp>T_eS|1nY1)?I74V9_Dra97Z@m4{TvXLwV<u#L~C
z^{h!7P<6(jiHFo6V$mhzIxOWpBw*SpXm;zO;~*DF-h&F5KLb~&>^H8=7?z{-%25Wc
zPzIF!#^k(*q+RaFk?*TBW^`D~q|j9oYYCXr=d7yWEFJmSF#M5L5Q<P|)dL@@20S#3
z*i;Kxa!lPJu~!UH>=nIi1f?T#(Ev%t*hj9}Z)qieHI3d>p^dBgPwB80RD7otsT11%
zlZ5@%b&bILR++C7BE#y~#(jCT8zr%K8d64^BL+(&@0Ew&zd^vuO*X`jRt8O#GyC(H
z$-WLkhxVU2_LoZ{ys~_!RQPzc1w>TOo>AmGsv>+?OYDe_*a^dnyx7>P%E+EQA$t6<
zD9<UW;|DZF`BcuHG?EY`YbaSO$$06?-XPd6-SOm}6#wP~T5BS;Db}++(WfUfuq)MX
zFf*(<i`~SrE+H!=GQwS>$DNb6+|#$+QXe}eJ#x#~^1SxcF<})F7cP8+I$;y}$TDo%
zg0p1CUa&y!EofPdJSAn_BW>9uZqgw{x+$R3ETGdUpxtm*tDaX4Oa)XCH9X3dClxDB
zD3za9tL9OyI-`y+z#mres8sN(m!4EEKCM>9t5$YgvFMaiF_`MCMkOfgq(U*TO37)J
zVu0)5rJRE@*#~4Y4qQy$FPXgmV$weGtFVKTiQisG*n2(>288Vui$GAn?_9(l(cS1?
zG<1&$n}GDStA24$kbe?j!nom=V2~*86>#a4c526*8Byzoa~KF>cT2<q?9_VNsD;O*
zmEXKmz_RnKc_%hP);+>DeSBuOVZ6qjV%8mUo<q{kcO@LU<vhpqILm55GYbBb8lel?
z;mb;lNlB+3S+^lopD7(8aM6Ihsv5YU#a^{d-_Z<xWE%fe$$v%#Vh$k2c_hb}lJ}cZ
z445$|UYN!|Cxxx+gg!P++%QYrG>(64obcEh2l&Dt?9*RaCq8w#_R1yal|k&Ly#Jbe
z<d}cuCvwfN=E;vM<9x;%GM0MEXWOrJm9x68`*r592CBmc%Lq<aeo$9Yz(AG%cx~`}
zdulAjLhR@Pfqe&L&hp9f@hF@*DR=U){Hdd|#}26Q9#i1uQ5EFZ6&KbMKdUNqLP>~6
z`pk)od^}1*r}Zz1T|BZ^>d0R4gZrJ8FBY*}o0FJ#i^BTL!`gHFThjd7vx4pvhP7rg
z@xAMESk=+q4MCnnO<Z(5iyd6JfU7+0i8br6Mcc?H&R1W!q&-9B8@H}EW*G@KlTeIF
znL*#23YDAW)$yBC^PZKm?-w=c6u0OSG-wgj@8HvJKCRKnqtS3mt)5r8?vz5!NxABi
z^3^95Dq$z&E3h7yuQ;JleL|t)xI)QE#qtw`LisVd(&O@F$K{GoDVFi7;8B1J5m+(&
z;W4>_{Zi@sr85r7TsthCeNZyvfMhyW7?AbV_Dc}oUI2q(Om5`2=cD$Bh67(*--sYg
zgtJ#TbdMnWFM=5V&2^GcRsk<1?_qWNn3C5$^q=05bZLh-lXmG5v+m?KY~eF&J7d`)
zWPeB0xnII#<ebx>sN;aJ{UDF&Ek4UT*oatk!$hrmU}9Fik}mhe-TUPNW>iBKb)(jG
zxE^ncOE2CN;4UryIh}|V&9FsdV#_3X+aPvJm9-%6|3HN`s~^2-p8SH)k6Bj;m{JLz
z*5oW|g|FyFu9+rnc@+QXS^AT0)+_ahIn#tS$IKVd@ck<O;amBePxY^ci5s+>MfR=V
z!u$VywQ@3#Wzm`!(peDPS;QW!jvi}BoNddQyqPvw9yL;#Fxiwmax;3gF0{8Sl;x}^
z$#dk~{$o-+r{(y0<<A^fBKVGKiJVd5J)v;&m?|%i67MNpVLsDyXADL848?@BgalOh
z&dBl}zj$o_<<m!Gcn*mk-ft%>T+VhYV7s-XGuyNMyYiTQ1!1>ySc4@|2)VklgS!hk
zcZz~0s>7zy^^p;om)Gi_HK!jvqaO9hoOo&({n#>U-8gK;h=UFjVo^5;-34=6{<9j4
zX$8uCX~$k^#{p@_At{G@7p;56%x;}C?c&pIJ*(S#2Kdr!I;qyctJ1)ubmJuO1p~gg
z5UV~RR|RC9RIELzSbb8d4Dr?p#o}Y~MaLDcAC<*LUIj-k7af-?0nU!g7af+(1#2CU
z&Ls9rXCAnewF|Dy0~bMIT>C%BO88dd>Ry0LJnCEV=x@%2e<K?9mB020hwl{%+at(<
zakGuP>I5QusE?ZTVf0q0BL=75mm?3!dk&ws?UJ<VL5w8k)XQhxDdyZSM}K(1ZR9Kg
z5IGE9biFTReV5;&Tgb9c#Ckx?c1YN&U&!pPnC)Fz>ivrz1G3(uTAURP_L64sJlIK#
zwWQ|%P|WU*EOm-&v>BDaWkm$?^arZJv&uo!Y9X_F_<v4$Wt{L#H+<tV?STe+)jaW~
z@zqVYqK~eHKafj58zyY1Gl>ZtG%44AcFlR^n2vhp4?%UGQhNR#+xth-$iGu^+J?#!
z2kHyP8m|pCTpMjlyx$ZvSRFi86Me5PY_u+VtUhYIHFCL=m}^UorkIKz+b?+Np!mt7
zO2TJBT&nyhwa@XZiSVh2o>db*BPYP4CdzLhDxfbWtSc&{DJ-NREKFz!omJ*PEysIY
z=Hy|q!+WA!%sSH9omp%ssyEY^-9_Q8*XW(O%-&KESwvrH*m!-)L~Gh~cglDjajz)C
zMVmwkZZb{SHop48F>M`_@qs6!kVo2nbDF*nHRv-MKJ)6{bLzA?tdcgp;^y7Lh8@C)
zwM@E1j5{O<%bpA7eIoj|1WD~@wOUTAHS(y|o>Hkfsay>^g;lBggkmLk1&b-xU<Gqw
zJtklN)lMmvo{%p-DqD0^w(zKI@e$dALozvsF6AAN%H0pjk^#0rS(#t$kkmEs73{#p
ztFUh+h@^cN;2fj(U5G{OwMRS>UJ?|BbL1Y8usy;!L2~|sEMZi41>sH<WAyv6U{m_c
zSuMtt24hl#KA}LqC+|5ZNgX`rbX(M+SHg8v*mgkJwpY-)SHymR->Qet;`S-1CyxCx
z-jfm@L*lL@VlI7G=wpOh@S-H8U)pO}EqG2pYE79rBkMCM<~$@xo|Gof$kFC5xQ<G=
zjmgpH6&Uk+kxxjGYnq&8t*})M_9LC}O-=TixZ8-F@2rB~oCaskA^Q!v<R_=R_l61U
zdXY;G=`TF5f3it=Y7n^$-^i~2J-+w9Qv3gv)Bo47iq%UZXH$tlyXrju$!21uJ8iZ%
zZKgH$ena$d9cQjHX{0V<<Ywe}b=1g>xU>*^p@VzRojiH&)CpN3K1HFkYUj?V3h~IE
zJ}hy3pXAA7f`<-?96l_*f8Y5-`_CWTFT-<ON${*9zn~l+&t;y&lE?R+KfEt3*r_&_
zQcp0NlKk7!L)x=~Z{-mIePtoT)e%FL5d)BK%R~Drqq?p~w&jHPR3tQICxoT6YH_x7
zd{H+zs};71mIIRij2d-J*>haMZ9>^|O3rQklH-u1-Jq=Fppx6926g_j!>FX?poB%g
zm}!roUI(vMlK`oeU$=!<v+<N#-TxYoTHQ(28^m!SOQrUxV%0Ils^bckN98MyU->^K
zR}63+m-`B?>!2_o>#$7z!Asa+%>kf}NM#+CytZpu2PBjKk0tGwh{w_Kpm^dQ939Wc
z?Kuwy<9s6){=c?|KtfwMa4+u05D7A7O&SJGko@oK`k^&&5^51rgr*S-XeLG5mqNe;
z3D<sM$9`dldjd9t!uCUAj(um$Zt+_n_8O8P51w<mtKc^Y0I9KNRf8YO(I>S+p>Dp^
zV66aNiU_|#mK7MY(v%06yrvcXmH;Uc2Vzi?JgyS7qTsiH&$UChR01C<1uQA}FX)7C
z=tn=3V=O2$SJgw-4WV5@6-(W+NZTTp{^(Ww6Rq@1;Eg|A^FCOoKC@2w&a3ESc-=4Y
zH$TO9|H2;lS8(P4*_B4KGo%|Rx@pVAP%OIg7>k{mtK9`-wF#3q6K8Iv&$SZ7!;Y--
zlu(fqd(NLaA;Ei6>6`%Eojm^$RpC=A2=Dn%O7WkNILj+7z<))6PgO)nLqtSPQ0U6Z
zQ}Sm|EAaEkojD=Ldss(WI5*N0vO`srD{3Sf2zq^jZ+BK$M;7}|end|}bWcG{cTwcs
zvZ&5N6z@d0WCe8=r2EIz=@OA!#_UIW{!^rIZuSb`l6CHrwucQ}w7v_%lD6%~dLBna
zi(U!K0b!%tg8H3jw3>O;8~L<b&+4@DX}6q$OVqpxWC2rO@dac7RmYWUj;quj0jj`P
zyVyD=R{=XNSGjAY$K?ool)yi7nTrdqe1PjPm&>jnzMOwh5+PUCA*t-IwjYzP{>KhT
zCVeY`Y4LI3vj2cfEasbYVgDbpz+*zedxcprY%l-@_1uO*=suZ1YTi0w*@jrLC05Y?
zzHEZliKs=LkU2%1``t&Rokz}D4xTaUzU(n+7{0E;m^4XvY?AOqF<?@bK6=S(5+KrG
zFX%-rnJ2Fq5lf1J6Y~BuGT!3|*JP-ZmuXWPA&+&#Hx>OCWa%@PydTKYXD?A7N>LtO
zp|7a1p2+#ls{}1tq`WeW-%=o$4<)Jh5ssN&-LlJm?NRcPT=CH{>wAm%ZMW?AwDRBR
zm0w(Q-`b|4-|S6L#k-KYkMxGWMmNrmjNExSSMuy()%TBDUrkg$Y)foTr+4N1w`5Xo
zmoV=&5o_JVd{_8HOO~b>|M_D)m-zVA#l<y5gf&G4v_u3nMFdra`BjAoekB1R1wQ`E
zr;ce$NjU4N*=tJsSSZ;lT~X%aQ#;GADa7w-q+S{yP|6`!#(G!B`_?7-wq6Tpx#o8}
zmwh`obf6@rry#OB%eNzo-jKm;%uZ-1iq42FHFIyaiQKSDe61fer^`fSh01^lQ=E<i
zS9BQ5N|b3?*RhNCgM^IpeOb3LY5Ngz^FDF29udP%VS`(OdYuBKPJZ3?Gg>V$0F6hz
z{;T~je*t3H|A)ACxeN65)qu6HG5<-#`Em&DOOIVCJuCxM6&<<4jmEG!CIfF-aFCGB
zJ17lR0&C{~v2@^Tza)VZ<UaA(uL8whWE;=JNpcM@?iFV56A9fX%-$muf^Ioe?sTCk
z^axm@mo9GJ`YQ0XjH$GkO>39AVVSU~8#-fvqWKs!j&19+A1P4BjKkNo0*QyZ5%W06
zX>pdMy+&kc<M3v1bUK_hU_vo)j1;|SnetkNIfEcyhqFS8Sd;gg)8ecvF#*6$)2nYU
zc~75rzc21FDn*@E2v`#L7*h#e)sK6v5x%X)+0u;ojug3#=dIJ<xfXn~$a?Bt_>*Dy
zrcosBI{)BX{)q^v{v1^OyI0<h`?VKnPNWw-^Q-%=y{mKUe$vu-&eFY<&Hk9Rf&3R!
zrOzizw?+#W1`AgvTE=gsE{|j_57w~U)a3-vDv1e_E}hpp2gDrH5jt)ndB#>*G?wPj
zlud+rm~KqoM5$n1GJUKjvA-ak@G`fPldzH!cU6{3CHyR_L0CzQ`fGu=ud^R?q|Of(
z%np`~-N}D4dvk57X?wBb*;dE1Crv+Wb^o|F^6QI@sQ4y%w`NOdFp*noj7iIIZmEfR
z*s2nF<g(+Sp8u+5;A6eeZLOduiav{1$di|x#$@bABrJRQNjF6dZ;2Xp3zE9{wA#;T
zww=)=+OPw%PHQym9vr#+#r2F>)$8FKx$aSk8-!tVOsN`hgPl^ShMknJ+I5xXz}Jz>
zh`_ENxxytbP}vFDQULAH<-&t91y~PAU;AG>D4mTnB%I_y$rJ=#+_U4i7q0FG{9GAq
z?|H5gwofFCtAQZ`6J(=~+bj%|6VU>UqVxqT?v+bRwh1e!S$0f+Y?robo3U)0zGjoU
zVVkz)jPBI@S0=HmnoL|hx1_`zR}Olh7V=Pn+$Tesxac}6={_#)K7NG`b>XpL^kY3D
zdP$8vrOKW%OWv?d-7<=MX_53!C1^>8HmMi+OegF+ImV(CWl}L1h+CB)Kai#^O3{`s
zQWq2gx0HgulcysCy{-}RM3eK#JYm~4>w``5OUI0Nl)_KmWuLvvKC<io!MXVl6bw3~
z;x^%Bo18C(&WR1#QM31|SNhU72Z`j3iM-A6%+;aP?;llsKUY)1B4;pNXD91dXIm#*
z;#I}@FPu88A$~?n?6{MzVsB0A(9PJPhQyh!yyh(b@y@KZg|5-Q%8{<}NU9yff>a$t
zzY*`3L@}$0^_^@YdP;(NiX%IVSe<$Fu5!PzcAQ5ukioo_9WqiL8)>IRBzRh1r@5s$
zDj3O%U6fX%q|TCyel$z^&OH4!`P!BTrb{P3w@Y|t8n!OuG$?`7l6C(@hhePZwy*(F
z^Bz%?+Y%PNB8FYU`duI{fa{EQ8?RO?3>zpCTv0;30g&RFDtCoI0iVeOBk+m(4ImEq
z;yOx293rc@r%8pXT}N5E8`1+@2<)+PKRqT}$Yn9P;;*(}>e@l+tOL7t7$hc@#*M(F
z68DNH>=nPdUn1#{RPrGyNMi9{xr>{B+|5FMBgnSK{LkH{-3N}bv(8r+orndrR=Ovz
zlG7g}r|O#i1Q%1dq(7nNzoF*8rRKe&<h@6|yJPZqws9LqI1n-(nuc#1vA5-@b5d?o
zV)nxl?xSMPeTIqO+2y`BC$>qfRr|y@#^D?8nI8?4U+WRC)FZb=$O!NsNVw0-P*(|A
z+Nu(BN!EK(j{X4LciwaIB6VJpx*|bYmGWMcrY_1e7M1<yY*U^(Uwi42^~$I8lYjNE
zXk+xR{SsLHYgof?<eZndI|EZCZF9CA3!by$^WTr8ZwzEi^%p)GDOexMdeocx<A<4_
zzpTyO$#2T0j5Kj(+v8r1Bu{h~7Za)e?xxa_-nwH0RlTjLH*+YJ9NUe-8?ysdQxnzG
z(<MEPm>J>PkxA{%V#IkEwPmq#gYErHWm<Ehr&@A)3jL;Q6GqCTYa?mJfzAz)t}XHI
z!`ImhO{p&iD>nPDJ-gfTZmM=`vmzm9h>`V!Wy~5fpzf(}ZR5A~Adq?!b855&!{7~)
z|Ed~gO3P<W)_F?8YDm&%NXQ5$#cp6qNVih}{!kD8u#-=_gI}lftab+s8-CpmJ^)R#
zg-@%EPa9OmUC-*YpVnyR)o3}b(R5O^0X)VH#Z+psa$|gum_p?d`HG_oRoD>t!0w<d
zB>K|Bpe=5wUwl}m@X)0KXch+`eO=1L`qlPJWqb?iOEP1>Bv1w!3@6JJoFl)UDY5Q5
zANj3#6wZ*}h;q1X;h4!DKIuv<x@Y3bw>4K>DxSLRnu!~j9y@1jx@JH3B8pz4)s({R
zZ+=cg?MuOPddVx=_2;g+&#jU-v_t1rnUH5zw1XaBbR83M=$G{xQ4X0iAU5ohpHoYI
zv`c?(n~vyv+Z8R1B_C{3pV_6q(T~O(ACtnj<b7u?Gv9ev{laMayJg;6t;omH^eIt9
z8$L_tJSHTm(|S?FhI95CPV;ZExBo@-{8v!@XL`jCA<chf)_o4B`s`c0<A8zS*Wdb-
zeDJUO5Ze1kMAh(8PwBJq^u>wt<&nJQo~utsGuNl9yW8`ZXZwEGS^4eb@*iI|U#@j8
zjWzuI?&0!e)5z_-sln3e_U!IlMprI#slW8ohm~Ld_VTZv*PqV!5O-?g@7G847khUV
zvFg&P6@=SNNBT&8^hkT!WPj%3XwB`?h#T=fz4;L%)iEnQ1>5&)pN`c%9;)6PzPa9?
z{IEUC-Zb2W*tSSQN^2Qawc7Ma^N3CBm{*$gr7Q0DHGOB*sFRl*?q0T^l69PxbDoyA
z9XoG2C~DX%Y|tY}=-mOb1ogZ4NnK}kZ}I7L{;%=tcJXR<oYp`P*2$;Uc}5dh<8FA=
z04@Y%H@V<aYdE0-?yBY5ZnTe;>m-$GzuGaS+QSOvN8}OzR~%C)J)ux~Y?ru>%a<I!
zoPGE*k$p%e3$WVduWastQYLR71Te{K@RFEz3+DP?rIjmCoafqK#3G!DMc1p#PVoya
z#F9tyI?NS$E@Bmg?UDM#Ee)3pKJ(6fLCtwd&V1^X`;>P51+@rw_P+D0{(usBkK9)_
ziBHU8SJ8hxsSz+^LA-R#`oSP_U6;M!n1RwiZh@&S^0Vb1Xr(*!>K$go=kSg{f}4Kx
ztNq2j;0KfVEr-l^wDP|N)cqdN_;<hNf0D~TLl-qmd*)gGi+=2u@zw3Hu77iG|2?qo
zQ%KX7pa$^O50M?e$M*c2)%3-u_`Pk?x>M$Q1~K~Ik+=SVYW%A`|IWSrVsfx%WiWlQ
zFMWQnXahg~p45$ptv`NTfA@ZE=iTEsuOIHbTmJN6dFRE*cN_i7^X+R(?T_Y~7Z=**
zhOQ6fh1W72pA6RSJfC>?VzQ?(@$q>1P(5d<JN{mM<ZxqjPi4qxbNqB$>Of2S*5c64
z)B9VKM9q`_l&R*h?`E482Cr|=+<1Jy^zq2`m66J|q4>p#UQXUS{m{quncFTYn;0Tx
z9{WT;ct(>ku0orVCyz_m_FuFal(rp`vYWVQGkU>#SlGDdoJpUEaj&4!T>--$01GCd
zcblJd`;2ZEAL%v>o3px|XSCaSwb}@L{7)>#-JI6Axob@zFBrV!NfkKFdLETp*eS5s
zZZyW#!<4{fm0X=nX;*TEn6Fe0h#iqDK78dmWU$?YW5J<Ixd&h}IR|7iks{i+%V7JZ
zQV&WKz}5j`m%MiKk5RZU1-9>elym%|TjC0k1yAT4zk<m>cBtl#n6(R^b&OfGkHcNg
zt1h^GE_vNK`LSE}HZE#H0|fdGapN5Q`Ui6MD|+z{LDj!d3*I@WZ~GR13~Ts%$c^7w
zwSQw&eDW%K=XmX@b;@I};&-%CVkfZS*U;8~#NPSu@Xminb^eRp^mmsmw4(hpq~Tw|
zb^jn2eX!4e<y`pIyZW<V<8Qw8zfy|O)ANqq_|Ndxe+AV30(geC{?2LnM@aKOIj#R<
zHvEQ$MbF}Q^r|1@@BUX**S{lr|48lmS7z<Iyn?vZk(5Whc?(0=*ZVRb4`we8*AU;o
zod4~Yt>1oLef50o*PkDK{IKxp!`z!!V=MFRtF!Ivt9Kqgs8|^(n5pITW%*2YX8iEB
z|HHe{vD+DoJ$d8pnGajC-aTp^?}&f3(z-cY3w({VCqAEVefpq$zB~1CU&iyvlBd(v
zPsU4OPp2xkr>ZxnDxQvByWQMG#q1^`<D*;3Guvcz1%L0F_S!n;F)Bl@P$w0<rc`_u
z<jAu!&NH&EGm`e>VwOXq=7Ykfy@JMf1&s#;jR()__wwuaV&&7jdq(dLpMKBRl~=ce
zm(<Ct)6RqN3vvD~&~S!4t={tgGhPj%6<l^ol^cPb1h|wTyjB5ITrN`vqun^JTzyQr
z;;2&TG3D~3N@a%?iucPF{zt~&6)w20QYPmxSHjN$eI2|663f_sDe<sW3haPH;=c3T
zL=k)=R^SW+aV$bH%Y2eMS1fXlu*U(9Gi?=yfdez9m|BER``z&?=+s2J3OC44d4hIn
z)Qz}jJ>y=TS@Z(^%|SIku<E$xSMetJ#)pvlAJ`3_(EjRIwL>re!Rz`v5Es`fKYEwF
zrxd^QtNAIo;Wt(T+RFYJ()2fK>G!Cf_bUG2%DsQH>PLFRudby#Ho4EqMceF~zoM<*
zEoa9r^^Nnj*MT>F1-Jt0ehH}i64~`fboaj_I{z!M;Ww=8=6{6W`51lo??lHR3HdkI
zM_bnWD;I|f)_XITy3<!D>VEs{_S^Rhvy*K*Z)X4g`?HT9AANX#e`jal`LkP_8|~{G
ztuJ2?BX8bJzuB4p;ltF{=G|wTcVBLfjND2eYEFH#-t+KI?m|!2`f%1nD>2?lJm^Rq
zYKeWn+5c?5Woz{MOndyp&iKvgqK(Po<)NIl`}y0`Wm{9VFD6QFHFWBSOsG@l%$X}j
zK^ywM%Z98C`?%Nk39pSKw=cU*NZ1WQ<GElnMqISJf6ih6uo5-z7dGt^H0~EPf(>xN
zWzdK945^2g)D3WbHC~-gUR{8zlSjLqM+@pIm&E`v9`$A(ZphV&l?Oo6K>Xi!hI_U|
z1jaSQ{9g~2yYc_7&s45CMkrSvRRXfgcTrY;NFIecDA(cI3B@u*_(x>(j>zU7<*s>0
zuM`}<oOR$*>LFB7TuM1C4Y8G*;s&gMFT`Qo$vBvT;@5}aIHn=v=FlZVCeYl(g%oC0
zgyF`fDFX~}NB=LHHlydA5{Wg(#5L!n$MBNOn$NJn+MmOk{~p==kLcDv*mb|su47F5
z%ix;N=v(x!{ES$Q)BJmM=f7DEzXsHP#zZYLH*`Z={|=+_qkruuR^u0X^#}L-=bnXc
zyf8zgc!yT@fl>7nwdB2h`b$RTU!AjFn<qS>m40SaeWI4UCW7jJ3U2xvNHC)F4|ePC
z=n}$=3Fq9G9!2lmOPA@@zti(S<lN|bGTpE~aQ)GE>H58r<=$(f%}L$mk)7E=gSF9<
z9clO5lmE6e{_B@#8*{DGovFQLAupyoHU^6yv_;Nzm%i9s{POEhTPx#3WdTFAArCsD
z@707)cNDx_?O7u3mwkCXy0d-v^;YYAcgose+5hv$<BvNtfBd{Yk9SVDY)#g!->-Ty
zTD>+>xiwS%Z0veZ^Ig-3S^cPW{XmS4nv`=Nz2Y(@V?QqKI4<usEA2QY<uE2;I|{xM
zF&hMBVHGwV5H=YUGUl4F$vvRzE4%~@iGBg2zOx4Z;V(YY9X?VIAE}#H=QgiS7q8AO
z;ENALrq%j??X(tnt&LZ^{kU4w|5)R3gkoy-IA0=xbo8rO!97xfyDE>XRKvI%h0>!6
zrH6MtBvjVJvU$Ye%Q^T1X`+KNATNL`oy%enDWnmWWkCRgmxN)1Dbj`ky$1fhh5>!J
z28R@I4=cuN16*cdxS(VKd}S5Qy?e<4_t~SEIAI0db}or)^xT)snx6w}zc8ymhcx`=
zSN1Wm>T}4AU$LPRTu1qZRsSoq_7eyzsO}4Z1`JY5cYrLoNUUhezzig2?H5eia^H>2
zJPTgB<$cF&_~mN<f3sWAZ}vB+?=~shwkglt^LFTEUzjz&dY62p7JsCceI#Gsp_II*
zmVKaCe_}TL3YQq(@h`91555H-GwX<_x4N${jaF_A*A92(&JUN(4p+~Q)wY#~_f>@V
z*2eeL#Xp{Dn4746_olDAo;lIVe%Kkewb-^i)wD2M^X22Kk00Ov{;z+2{^`|N&(*c5
z)}P*QZY+*WOx7%oHQlO>ee$sR$9MN%tTk^el)hTMxjI_XQ59N~>eF2s^>Xg!$HzUy
zvzeyN@f+*+tJlX%UyN7ZC~DW?=JJ;`eI^v#C*@qmE<250c6cCVJ9*K5Qrvn3$by}>
z8Wytz#757V-xoC<;jU(gy#Ta9e#3qNLoS1H&G<j?0>a=b1r7VS4pVQJ%1A)iEj|Kt
zrqd2Pz3VQyDAR7^`c0kolNzo6G0oPKnk}a^Z}Mt1p3(Rpg-n%8VUWajT_soNKd!>%
zvBL@_u%q%N#}o>WqnuCyDC5?C9g)pPz>hkeT?5*(j>@DSyG*3v4-grK=)*u;xDNr7
z|1mPk0M`KoVbCU|uUXr8On_ZSJ1`8ro7kh64L#^Kz#68Hq;I)khEe(k+Qb}EpODcS
zcKt1_7{v94R<z@h{lX(>8{;EzV{1_LXRNd`v{}4iHU7$O{+*y#d|*_g`T8@hY{#$W
zOJLp4p)J3$+x{NZ@Ef!Kue3@)<~M5bC+Dm;l)@kBWxqIId*hn@z4NvIm#a68YBF8c
zhX1~6o%8N}cJJ=i?zU~)R$CFrR@(t5KtKd!1`z@xA}S)HA|gH_A|N6nA|fgxB9q8W
z2qA<JLI@#*5JCu<=Q$yS5E0#d-g-jsKIi+^x+v}-`p0Wk)m?YhRVuG^p4(+;^O_8K
zpo}Pz#=kHmH(0=rCA`pMN=>QHjV+CY@xh0zwgP&`yY8k(?BPZZy@`k|YpTi~#aD3Y
zZ9)!?jf}O=*@Q|l0sA(SMR+-<=V*0CsZnjR>2-6K8LM^v%Yt!MtWguGJ*}TUEq?jq
zi`2q0%cz2JZ0EadQd4$Y<z*uNE~zt%QjOGR$9BEVY^q3aDNClcJYeIWv$~$qTJo9L
zr{m3!UOj5ubfU-k6n#f{mvaz)Ybe1f2q8EH_OA2mbqXAC3Le-HL|%Iw$VFJ|M_PNF
zw8pQ`!7|b+Z{kX?o|RsNm0oxUy3q`5iDG|Q4;=giV&?bm9gv58bFk@aC{VaHf9Ki+
z*%(mjpAaO0WCt4lI=~MR_`D1XW&g&vd#k@jGyk{W?s)~33&_cq`1Q{{Kru8_LY(|+
zM=7*cK!?s(JAq||f8Sp8x2=VL+nD#C&IM?w+yZeD=C$*d@V8C5AT9?0u{g&8wDS8s
z6Z^d`I+Rk7t5jHy10$PDDLrKMz^|AGd=Tji$s7ZLMUShXp2RqM9rP<F{BDjzPg3aJ
z>F|4?(!~Qo5ucmPi2P|F+EVg=;e`p91juavZ}4Nu)$?hMi>VEtlB(vezyH^b_n$Lb
z{<vJXc%f=O?u9w5P!?T^=;F(bNmU;&RD6mp0q!g$y;(S0ZuLf=ubDx)^5{p#=sYbZ
zPZIk~=XqDUKUKQ@`fT`Za%)4)R9B%wh?h>0rGg$I7b|9Cr$#=|aL<R@o(Krf8MrdJ
zlx6wyMJk|jCU6Qh(`wh+7iTo8G0tGURx~<iQ7zcD$Z-F=zNSp(Aa3!?;>XYbvi|Y$
zkN;l$_-X!Me^_VDeD-kD<Y?1y?+Z4mlGXE+(vVB6x{ZB)g;142Z!2QqpAR%W9BV4$
zwB74ydb=&*-OgC*_K0rhlLV(o(&iKWki0tuQa6TBz^)IVtUFHr)qh~MA90O;AK;hc
z#MQ_#!m6YApO5zZ?A`OzF+5<UH-3c|4)tXoT|Yu92ENQ4>o{~mZ2azUJNU2fT~U0y
zzZtOnVC(mX+n2kxe{-PapDrK%>C%Me{|Ddy>CpDqedSX7)xMgqTx$LS(Q;4CKlWCC
zySEAemHvP1LL8Mb=#bw1{2#vqxk~?Q=d=IXS^D=KPyfE7<o|Ae@}Ivw{Tnp!I5-8N
z@;^}jmH)S`xq$!NeDD7_-9h&hff}`ABZJokqQ`jx=z$$gM8$QEr3}J@5G3+oQN=qD
zR7`~(ydc+t4%<PGZqS`61f<)5Q@}5HeFZH_u->UKhr@**dZ&#><nclK1_Zj{ehHUL
zlwak>D{tpP3J0nfNw2M!tL86O%%)V^Q>x}bS}U&13=t3JtP@^auQq&vod4V_V3j>E
zTOM#%ajIk{@%8-Gx{nDj=faEBez{T~BwKncPj@U$bL66I=NX~bnfkJ75_^&^5#hT#
z%5W{u#bbo&5n_4awYuk-W%*ZL6x~RT+22!*Oi<p*MGPUMV{)ubE+3kjB$IkuIAeGU
zu4I(aK&8}}XXP4`cJW_}Dka-EuQFMU2CG#r<y&VoR-=$N+OC}L=8qtaJlfk)V#y@_
zrIcL7>?mgSJ|Au?BG=u;KEFKHoQto|6E>!gx0L!OR&0!-J4X#|3Gaon*5(srXDDR_
z0VqyEL+b+u*ZBdtDC>NPzxwn6;IJCF<qem{9$?rnUVxs}UihCqa6fr={|N5OK`aE#
z_8q4m9KjLwUv3@X!ce09`*I2Q%WvTpZ~)RW00hhrX#Vfg_|N_IUqQfhIJK`JNV+rt
z%f8+R1%I^ay7ZFt_1>3&f9`ql)$a0t{0@aN2$FD_gq!5E|JeTQKauSv5G4Vq3)@oo
z_pPv_;QrsX<-wYQ|Ja-Z8mb`23f6JJ!A1txv#>=E^qP8LwF#v3o=N>68U+WC_W}78
zk7Q8dX9Xh@VRyJdEEseKuLU~=U|<o(tYK&nTG_+z@dFVU_=HwoSfqpS;eHAH0=Xnm
z(TXY%FP)<bWar9^3D1mB!hk=51=JW+_CXU-qy~gNR75{D#Fm=kpU)<~UVy-OrflwH
zA?O1tF~w@k6GLLvy#MXVfE$zk+1A6?K@pDspqa0i@?_KxQ<NqxkD^g2Mg}@YNKFWX
z(#-5{;?jEflMJm%x%kO4HrO&g^g%3SDAk-%CQ+*3Nwi|MO*8Z5vvq!MX4Y)9nM|KP
zTfY3aW#P;0g3b8JwD{%Y;-@bb`<&LK6^mKC3A~)!E1c?^VqwXhrBefS)Q*yoj*=;S
zC8;)Ng7k_#Sj%Vi)Rt!VAkQziKD(5ZRsx#o8%`3oMfNyH4Qzyb{zUKk5Q0-MZDTMM
zD7HR;ygqPXbpYj;K+0<WfmMFwRX%-ypN<j1t~f^g(Wmc6AL0sc;tDUq_a6A~j&y@v
z0-Tq-<GwqBTYdx!`0hyO_eZdR@7z0<yCUr<*C0D{M@i>k))KkiLn?-5W>ClgU$(Cn
z&B^w|wXzb(^%uT%fyN7XxP%HBC<DIwYDf7$cA%})|MlB*sEz$&2XwN+OvmH@+J-U=
z#a5UfD){@>2mg2TeV`Ov6jA+WP-O)PR#5hZ4Grl2n2SKJ9#_zIxJWtz9_<pSD}uy3
z?f7+OC^88)ID-TFMxZa~fr=@CV)!U3f&;vRIrVIQ$ld9a_oXNA%TC@G2i@U<R4Q1Q
zqKL>B2i@f*l$oG57GI)|gl30)X)uz_gFil9qK_&zgycc0uY?5tM1d;ukv_6eA9zoC
zsR|0Ff5g9>yI5^ccs+BXNS+P}eB&af+;pzxU;g={*B{j4U*(OHYhFG$PiiR`>?r0@
zYx+OraEZkuP4{|VT*JS(!Nisj8gskf=P-yBJjMs!XroRt%wzVLb;z`UKQcB>5sF!S
zAyY2rC}mu^lBY3AlxB(flfk}dnw!_y7j*VdwuMEDLdl)8D(B7o8U3_U%(R&J3s#|g
zvRlpRVzj>y(CUQDI_AJzE~D3=mXJS`4t=<btH`-?Db?lV^OfP04WXmX!7S%s>edq!
zr(h}^5cqNmg!o8V9Xtg1If(jG0A;2B|KJB-(h9%+6@FwC-o)>Z_Wl6&FC6V%?nPMc
zNm%C5{jEpmGS80X9$nvgb$t(Y45(l@@Pk_?;M;?(j#5V3*ZZ5l*$;lKX&G<}^8c?7
zeSlcG`~W0j)zB;kZDN1%Ysry8687~jaAz;S+6|8E)!%nL|7sWP-vM$Jef3-MSKEt$
zVqk$~Z~zYmNf?j|EkRuDSpp<p{;30ju&?b3$vcGv6HpKd{Zqjrs6edmby!vjLS|E8
znIQNBFJvr`<6aUA2MspRY6#2((Nlg{4j<f^Kf>|7ISzCKzXnbX+QY%qVG86Cd19c|
zxfhnShA%hX|8e1!HM!CjnJ*2$FA2U6a+Jbgc(}}y0?9Cs^^uRX@nzQYuk6U#7q-MV
z3s>qEld9)2PxKHjFV}oNSGAB_W4%|yE-ok_ytso-8MZwdX)b29y_o8H#px;?tiRjy
z=0;o9U21CywjvY%HnX+j2E0Q{m7FmVTPa}-ky}Z<&1??UHfOfmEqw8`R3p_GRkI&0
z_Rlu^7n@ix(bMrxfN*g1!PnD-GFEpPcc5N2L1Ht=Y)0E4=>-{I+SgIUBovR}p9;8r
zz3o|~wv3*dt0S!sh&4Aj#On7Yce%Z7>WS9s!b{H|l!b&pa79-bQJkX~n}f-~FTe%}
zkHLcuZc%|-e_?endS2;|3;^96j2rmThqMB44BVLmjx*2=<=Rog_eb&Hdv`AfFXo9`
z?tw*PBb3L`Y#-qG=!lj;vE_%_mmO?IlQ4Kpa&2Dj3T1yNlGOskzS;K<vU>;6b_)RF
z_y$e;6<_at_07K5aESzReFb(0EJQ4YQ8vdk8+7Ow{fVtbAW{xW=7DL{@LM1n1;YFz
zn0xHV?D1e&otr)kZ$j`g6alJISz{5|6EIO1bc+?@(9Z})#shDIni)UxzA*NYJOSQ;
z5L7x6+!HVOE(e4xAw+^~1Vl;5y+C{kSO!Txz!6OOFm4EHTnW$3=gMa;zOtT$X01Z-
zSK9Cg%9Dkf)1@<!h1$^jim-eoToj{=jc|^AI&%_rXbMcRDkN8gDbbvMWja@3Nl2<}
zdirAaBVuQCl=s!$CpYGGzrEdFiI7^Ja2XvV<VK^2PVcViZ7pXr8j0O+COHE#t<YdM
z!ewz%I5oFuS6fY5t64p3)Y+|S`;6K?575rrXaBWmwA=L-tL3BJy7<Zdhh00P)?2jJ
zg*o+%k}n>dGtj4~^|bDCxFaA_^k#{aMI%&+Ii2Iwn!%oz@KnhmHyNelZ=YOit<P>P
zy(j2<HrD$J$*9{FOkNQ-wkB+3UFaZSZSVj9c(f{T@P9FD=$8=Mn$Y2u{^XVZ0|0Pe
zEB(kTefxo7f0FFq-1-4oB9}Me2k+kH;KDp{-+Fc}Khg;l`xfG%15nObf}<eYx!kp7
z+2Ie%4mW+XROdg`xa=_GWc7|ZM*T9lU%FKN51?UxZ^b|Ny!?9iE6Bi5C-(b`f9!gO
zGHhoV%pX8O4EkIDO|ET4kZ*zK0*3{9=Eq^_N7`V}O?2^mK-v(H3*NMWaS?ZzkvZ(B
z91cv?Ve<HA9?75_5nCWmc&bf&Zj67TK2xkpdNq^$dKL-}s3PSfNmPL-GG7=1O*#nd
z2ou2qOvv#Akx9faofVwP^-dl2xq(i*1Z8p~a>Wt((wIVJ+*8BZm-FDQARdA}|I!xs
z%obT_j4CogqYb3=&}akgHc*1_za#a}1UU(LV7@FcUlV<?(k2zbf4NjGR~gi{MZ3mq
zu-NBk?2AIJRxxWdEqt_mTAcgxS&P^$VuM0$w+Sp3-mFz?)k#%itywGA%auB{N~c!q
zHENwkKdV=p)jF%*U^ALNnvHWtjahG;x6RpgI+IXsm^NAETBFD?BiEbdCaYp*PGPkh
z^)u?Z1*3Iw-nwA5EzB(}eiW#MOdj3#c~P!cefhFzn?>wwdOP-g&Y8IT&fbKzQ7osE
zLmMK7*Po!R3!|<Jr2>!Egwh>=1JDX(*4i*S(Cx2ixyqjc0Dk@CM_vNZ%|SFGI5aq{
z^g$!%cgG0JeF)!s<9|4Y|L!PmxfgbsCl>O5M<K&OvE_%sskMFY-txVB+w#L7zH@6{
zcDVW5!_AQDLuLlgmVmDhR0ICG|Ls>URsV3Q{>r7|YnO^;dtZOEryOD<__43{K#&B+
zRs7?3wB!nb@v9xh5GR3TASn*Q;s@he-Os}!1)SSi>|x{#<X+uqtVC~+1n*0I-YLBx
za_)DP5_E%c{3avx&Y$J^Q;(zxrRv0TLqe(M>{IReGJS#rP+A3+C6qxv4l&IXQ>;1l
zL>pV80|K4M6#*b816F~0pjX<cC#XZfJXHoK_#VVVA?*JWLTl+sh=wn$m_oaMrp`NE
z>32)xdrRY<Dm<R44!&phye9FyE^xmraJwenbB-4r@nC|`G;33ST3q<JU|;wIU-o&M
z#cWcUj0%HZKE)eV$tILKiC!}y;txoLLzY>Y!KT-nHCltwXw_S6Hn<9!t$L$XiD)fK
ztyZMb%JfFHc~)lwPJA?5tcE$8#b#9)v^=GZWibhjdcH-+f{uz=u<9YZk)@ZydBUWo
z&+1t-I+j9A70byc3)eg&fqz`B)tcu%Sr#-h&EVOK4|WFOSDzwnjAS@PGB%tX*>I8$
zc3n7g9RgqB%wNNq8^DG#)`fs;W2^}oS>v#)gNFZyWr2gM0~`RlfjdLJ+rNRjHu4I{
z|9yHKKq-a-t-#`-R0a`pnJX;Mfrrbs6`qjn1IbV<JB&1cbMONc%Dz2>mdn0%ty|_=
z_syZ2f4EeAwI8xEbX0QrewaCe>*EXXV&Ckm_|~NYES%Aw>@4|u7gWNE|F-qf?#PZk
z&}18f+ZzqL?mG^|V-KIhxx}^aKizroOqculp2KHxZXm9kM1*y|up|e{_V6-<K<NuM
zGC`p}<n}oDG7w&jf@(t^I^2mV5XKeD;~vRk3dGUy2vjk9w#)#4HFT$owXsENxFv=|
zvqZiGQ>+OoR2|Qg`{l?zZi)_H<$0t{`(*I_Z;Qh7l*e!L4`zsWUz>7C7y9Izy>pDN
zh%BP)qj#?UH{_z=_hj|1B<-$*iBoB+#*W6(o+M7kOGaBU8~2=4lhgMuhg6&0RgsFV
zxJszb=&#Er*C8DhS9@x2^jBTzdKx*>k&Evt@9C?e(;LQ_Rl}r`!H(O#wU==f7fCe;
z_D#xQV-6krbadz~n^8B#ZkgtGPEBHk+-Cm7d!-2Jkn)?SCK`C$9_C2L^h77KuTnbR
zG(;%jPu8#~mE6%r$z-=#%@lHaHL?+-ZpsREGppKcG};%evvX>H{|YB>)|$AH^(V<2
zqR8uE<n`o;QzXi&KZzB=a*AO68aBH2e{(CC?%);;fkX__uT_DRRRNTr0|!w@cKqM8
zTH+VnHIEOj^d&+1^(U>4;eln#y&%uW0hW7Wm%-r(Tp(M%cWYSzT^B$!;Fl{ri9@JF
z83y!P?gmr$4c{KF{pW#dV3_0T`1)JKrE2*B6wCI%`PQWpm<4$l8ZJ>=`t{zjf9{5o
z*pq{Cc$ZUMF0ow);<`aq7)tU`HATx>m#J_$JemUahyEkU{T|8vu$Bh)s=^B+C=Wx?
z3zYcbsS$n?7zR{>HdgPeu*!MZFP$Eo2@91F7*vP7T@z6c#qsb^_)Ht~ScWN7#ujT&
zKLI6YB~&Xg;La-Si4A{5moEesm;-WWT+^h#Cv)90<SwcF9ZBrHDH6YXw!JAb_nQWn
zE3&;QeD@5w*B$kq6yEM6_)Vo-{9sde#~3z~`sP;O``rHe+}fgxgG~>HS{@>#_k|)_
zjga=1iGSAr{z3P<td7cCyfIuSwsMq1>FR6K>iKFBm(8RyMi>gUS|k^X<XrM_*OYwR
zV9=`cYJrTeH_0tl6;CiBkWO0`jB=$MV%_|LjW3#3%B4KPI8QVpmow<(CN86Wi1eCD
zen}sx>?fB?5E)S*B=VSzgZO81Hda7uV^do>j2FD&XN^UP{p}?MPv0EE)NjEIIYpD5
zFoPR04Cg5J`Uutr2iBh$TLO5nbz!3@90%}V5F{Z~g8PDO%#r`27812pfsn5KiIu)c
z|4QEhAlHw+;JFBZAAJcc{UGQ6w+lOlU+&ZMy%*NuxjKIIK(XQo__9A;7*OmxHy~Qw
zckT^9G2j<Cv2PDnqpUjkZrT2-We2K&Yfz(r*ywOyufcu=lidy=U+pe+Jx_8wPdc1H
z^tv<%LmD0+L6!v7tbwCfs7J3-ysnUZ(#WufDLj`Q^<esB-gFccMM3Tq`no_RHrMeH
zb{gahB0;AuXF4n!Hm;1pdS6)E8=MJx#iA1+i;%;QxG##hFN`dZ#ujVNJvW1md8i6Q
z?n|Rev=NWh$8#is_qE~0))OVRpu*X(;yJ&3eQ2@8|Ni`e>q@r_ol7e8MN5BA67IVq
zK9DNiox<OnBHn#f7M03*S#fvx&CSubCA~E{<2_~g>MRDfn2CEzsLAfFyF+TsBG%vO
zsZNKh+*tP$0f+W^5kluDi)D_>LqtQ=huE%cv2@sA5l>2~MDp8FdIOWzL?cyO^%END
zuuM+l3FuN8S1F$q3dm;j7;g&8X16Mp<cX<Hm7F-uZsD?8d7KubtPdInWfSfE;btil
ztLKxU!%)kkL(-+y2tO{`wMrF_KR8CGnMCHX`mEO(@yMyD2Ww)W6L)AMW_V-N=tjuE
zBH0@qa5^~-0HOii06?+zj!?N4;$%48!7m!v|1Y_KU;hR;E<Z=8^y~fUIB}&P$}PaZ
zgQSCS2r$kYx5B&Qd+*L4j&`m%iUs>U+T_#m!x1!4qWp4ifT#$x0)8!XYgm5x-FJto
zmoK?6D1hy+`o`tWvi+4ySbpHm*Za!8b}0kj1r*yGi`#z&1e=M6&%x^YL62mr=j9={
zivwQCG|x*Ek7T6J@A?32ZaxW3&IN)H*hqPg8*y(c3|b0vrj}kCAu67FAcCz0n1`}>
zkYy~^pDNaXg8~~>sE9As1C>rbkVfP~50e-Q4wwQN)FNUE6c8a}ia?a!a=yZT3{)ty
zrGfeC;37j<k?GX)j{&)Amumt99N7^>?Q&JV=aOt+ih6H~(j`T{Cq?R#%K9x;nw|B&
zslIHe{Q<F}6!$iZMXIE9lyE53bbNVVQxU7LhKj2mCAC<z)51|))w9fL{(wYGA05T&
zj9h_)(br!j5i^V`gWdemXi$uj>x(jD7R>C|MQ0ixW7xe<M-e*S`f+Y%abf18MZ~As
z%wnyA{mG`Z&4{PR`g)t5@<-}vy=9D^mt1PyIHks@9#RVNz&IYOslU5ygqXu37gBp4
zP|3wTghE<Z33Cw3<Fh$ryoYbxI!wprSo)UJ!<%A8oH0yi4BI(s0)>NKn<F_+kqCQz
zBx@ap{YwOMT?F&j6U_BtqmYNK2ZW6RR)x}k4yCUO8U87lwlZjFRS<1;AZ<+m?U%rz
zUjk{X0-%J^x5~e7iC-)IfMvaae-jP3*1f_9yTS*z+#9=WiDB;TK&&4<JHdkELRNS*
zedpe|%oQjG{_FjpaBcYJAVf)UWDqEUSxXTTf+TS5`L{0RV1Zn)XB^!&ey;z(8N#7B
z*kILj5Og15wa*1`UqjxP={{FRy^|SU$-}Tn#4CmBcMXbObl<B(0cj)0p^-3SEEqw?
zK{fW+wIL9Tg(_D__B5KV-<b-yJqd->C6W2lK(qomQ0&BgF(4RZg7RQBj~Y^a48+MY
z%c(M}J0x3q%7_x%$tQD>Ppy9U<iU@uzIpoHS9mVhq`zO1?z=4Cmjba-emGU^k}f)!
zp&I$nmU#v78mHE2q!N>vX|t;T_`|AJ@{M|_LCZH9Byfd;bX`3o*BRtSlgwxl>WzH8
zaY_zNsAj%g&ej`vYVEjO$xtZA6smDZ)n^R+so@SCpD5$BGih}yEl*(-7_8G$3BjbJ
zs^xuh2|+5vE7c^qjA+y|5v`gfR}Y&^<4XCEP}t9#?p3Mi8ZASv7&7amTDg!$9nc#M
zrn%1xpX^4v+4jZK*HZfEPR;fp;`TGc+s=$^jb(0*VQr4#Y>we>ImO)+4YXoAMY5ct
z*iIPshUkfPk*xJm;~P$b6LUmMhaZEm`Aaxs4HC{+9nJuXtq!IC5;}s$O*HwZ!{L|U
z;h%%ZzXXw22lfNSmhf``3AhF>?1y7LKl<WV`r}sm;eYVKeea9=@fh4BA;X7GGU&sA
z#*6lq-jMA#1HDjIfpu?$^Y`wJ-yW_(*#`7-K~Qp`xtI$|uCMn2vt9tcb}5G;YfsoK
zbFts|%8=*fk)u~fJyS+JlIh^W{L{w0l1Ds}hW)Owk6mHH?p0W5a44C!|Ki|Ls3L&G
zS{fv0w4+yOKB@Ghmxq9Q9w~#K*J$3?nE)s=KuIewlN+8RKtK-{>h^)zLQIhsTpL&z
zlt#}b##1Hc@Iu9@QfScnl-&3w?u{+1NbiX#TvO$TGnB5kR7dZcT{8?Wsam%*)uB}R
zfi(5*RMnB|lfTDOD()onIV8D!_|qrN=Z|W`tVk#ylPD)`3&!~`HiJcD|7e+;HChmh
z$!s>5tSW_>V_uZY3~aq+TCN<|i-(Oes!>jvQPO85RI`q0GBYHiP8q*NE$Y-sJ56fr
zH2a-FP14ILMhQiy?2!uFW{m>|b?=OhJYyKN&I~JMIF+bP%&yf=HyXt)CRw|Z*DxdR
zFatzQHf7hm4(Zb?dJNirgPZ_tG#c5TX4#ihYMsJ3TjPeob8SAwSR$A6DfXt=39wGl
zEGG=hDSF%~dcp}au>k`=LG1>hSmgM6lw~ZitHVZsUtqz5t%htL5Q36yWiWMBFzx4H
z+Nwa5TZn^S=;<%#1%VRItNeRcfeZtX%Xf)f&|QH>MPSwvfLVa=9qtP__5G0#fFC@X
zmb=!XbOV7VG_QaA7ro%#2oI6p?0dERKqV}f4@!q(Dcui&-D;_HzpJ#9cP68A_?SF#
z^nEcVPl(AAK<_*T+UN7du|=xWkL0n1a1WG%Xn*K!ZeYelXy#N@t~l<YIxK5C^e!(v
zR}hpn1!TfJRDiRBjTlfw4Y|t$Zu#Be2jxfr$Fl^dO09rk7)H$32Ip%|79hsh(mBj?
z%ZaBZ-+NHLGRHjqf_b?ZS-uci{yC!b^ZpxJ*XuI(8}b9`8rPdT_bZc!5+}w9RdOM9
z-ohNAR?O(9EHf&jUTHS!p;|QuWzSiw(Pl9&%$n^M4U|1U&d-<^OeTv?BQ)z6vgvlI
zdPHU5n&)I%BOejS#*|8?RzjZ|?h-RQv=d!3Vxn0KMbgnlEANv<XgBb!8o_6aa#qck
zbLm>)m`XA+Ym&~H_#gEgqj<=wq|a&S^SWV+lA;mxnB`<WugS=7Gm5*-s(!19VU>`q
zX0F;g^~owoPJOv1oV@kS2so~7abw$&IL`Ldye;wU&GF-#&aj;0#x|ZF-x$kwKE>H|
zY6_)T^u&4$8zLlXAyl3m`xB1yniHdI!$;SEBRes=CW856D9u4PNcB-lt@+aq{BQTQ
z>Nx2yZmsY|y1{d;^uhh)pw&-Dp%WGh7I=j6%cJQpW-ajx$OWG3JJ1PptpR)wdDwxs
z%MYN|;lv;hs|rjf1>ETKPa__`-Wz;{6p=O<a+MTuWAM}+dPL@MbUr8M!BlkNRLsLE
z%zX|LbDtBN&y6qS$35i183-7eBRu_30eXv|=ZU#5jRZax$f48_^*{<1^H_y}YWhRP
zsUl6xBQ<!c2v}5Bq=kcjCf7Gpa^$+iCqo^Wsq@d&2Hw;8+*1Itf(x{P4>bOHD*p#+
zpZiL$d|}{2i%*Wx4M~-GAaXavuqS=SJxv&#!G)Pqjhv#8c4}34t%9nQldYC9t#Zh$
zpD-x7Y9U$8>r!&DDgj=_$C-5`u>z}<_vn;FqmneEBpIQ@S=y<QbSQ-_(y3-OzeT~V
zld|5JgpD8NjkC%+jj~=PYcy&*3>xg51tBe%Mr?YTSxL62DOSUfK|P??lC3jT`^=zG
zjx|ZzjFM)Zv`H&&)XSRn(k27H$s*~n$O&fkfXzH&l#*v>r!_MS`E(O@knbGbu|0vg
zBLS2SCU%_VZI9<}O#n=8j^}KSpV)GSy)}-zC62fC3~yu11OR~$xjqWwBWnX@{MX1a
zz<Lb&5di0PCmoE79Q`$tu_lbZHhcsun&AhLe-8c=Yk~*X1XIAGj0=Jxz`m8oaX<QY
z|LB8T!b;!npMAQ2f~a^DyYgrkN-VDyU>F(<5r^9XFNS(9xA)(<zW?6+{g3XT%v`s^
zt?mccS^yC3yQK@|fhy07c<6$FCVJS+4Ndf+8T1pkM?*74LO@jUIt*Wf@b?fjp+dC*
z5PBQ-*6<_lO=Do+VV>aB195zjJP!O=z6kD$Fd-CEh(Nk7I$NSXQzSoKB#$hB3!*6E
zfdK5;XIi)>o_VT=LPUJ2;o@s+!kdMdR||nfX16Sr`)w^mKetT1TZZ;Pn%qC%awuK0
z|C)Y(s=_60`Vb;La?85==G?(smLu0JJ8yp8kwihBVCB3PlV14AZvJAo{{g*xiyslQ
zPAudNX%wuvS*dMCxHzX=nAO=Wdiy-oNY(JNGe57gT4eCo3>w~oe$1+*&C02>a*9Pt
z*7C40cEN(~nSruVT%n9vBOY(G8b=mwT)SOln&BJOlo=fjeqy(b8P!y!ggB$8S~Nt9
zv};DtY~t0L5y3mVs6of7(6e7lX;1az<#KxQ48K-0RWF}z*0QSf{1(wvgNff!-8AGB
zg57+UhD!aM9oc!7wG-tO*Ewziu;~nE>lx1G(>&)G?xs^*CkzJw=gqM^)Q@2}>met@
zaMnez{=%=3z%T?D#{jH7IlLx<23Q?NT^&ySIgGL@bl|5D^14vUuVK`+Arwfwe)fkv
zjPR3xH&~QkzL4AF0KhM>KX_vSKY6z;0S0s7utYR8PC{%v()0slU~V<b-D*I^4Y1s;
z76E3#T)2Z@)vjluB?1Mk81lSC3``#mOs5~aLiS1ShZ2`}D(sIR3C>`_dt$&%rvFW5
zz-<tjrw3*-Pvml7nFzEH0?-GcCyM9-QH%pnwugE}3^cSq5W*IVs7I27a{ZZSn$u4-
zkjtM&o@h@!R>eJ1fdcr+$7)Q8DXwBJ?!`jvvxVci+9TN#k8E*pu_5BQ#pAB-=xvKv
zrsZ&!z%_UBV4flX<VLe<k}eeAM4qU5G>wpEkW!U=l91goMtwtWemIORo*Jr|=&Qn4
zWj7Y3ytp0R{TgBSz2-CDa~XBh^x8=}@}4u?z!|FN4mWVg6@2O&DWe8Pz$nd7GcACb
zi!nk0tG8^Vt7xpJkcQ13?JDT5K^VO+w8CDEim8;-0SXyiqomHwa*SHKT1?an@CE_S
zAZXJHnv~N`;)z<Vs7=DD(+YYNT<pA&1)g-)JT<EvG;4+tgO2t|HBi^V-4Vvvnn>Aw
zX>{j#_O67<-_NptyTIR?Ftz0@_^+w$3EXY*(_7-Ex1N~>egUmE$4)t);-ZL|+!zg9
zn_Q13{E(AzHb8|8vN6oq1`HD>h}TBa)<n|QMGeDYT_o+76TmPEkPKM04hf~eH*j8S
zg9m>JBK;iLvpNtik@%mE_W;WPD+35Cj^lsu>jwPn)3Ms8W0g+_FbnwgqgM+=NFdjb
zM_bUdCq&CS5I0@n1wyA#selLxzN-!_(Cct~3v|!BpN9teHhAuV4ctD^HkgP&Ybw?w
z34iQLKO|+rw-{lW@E*vF%;!bt2|{4~;SFew7!A$jfSxDl!}_N)L$kR-cQ`??7A2Dd
zlV;Hca%g*qdZY-?m!5>MSs;fu>F@$s{Bv`BnHhHUU<y?s4}_rw;#2TzkF_wFA6YVk
zsj!`X{W<2vC&cTn+Uu^)?T*4LQ+gzQ=0Jw^=nYy)RS&5&gY!OTq$P_x_(nTg!Nyhy
zNmZ=QB1T&ty(Nd<oITWdn^1Xmpbnw8WR14uvRWVX*W8}yF67`I@yO4Zq!R8x*<f1^
z4V%v-J{D2S_ybSJ@%hxoTeOx;PHzzdTfpjm!b1kj6s$VsXbro&NJ^`qHf6JWo(#1<
zfDmUAw$6y#wNs5^`di*`wS2POBqqpM4T`Y_4X0(A{!YzplZ`h@#~ZcN9ddSybnJtY
zhgXZKS|v-X855~SW~>awRFiCim2~a-rgN+viK3m!qq{GT?>(>GkvRR^1>W}a$P|3r
zah|(9VQOnUgv+Tdag%_}r@@yw5X*6n{h!PqIECi_Xz~x1xgG=J2#obnDAq>M)<w{M
zg}2Ly;a?+Yz^ea2@Zj1I@|sZMx=@IjeSlR##Ge9tfocd!F+ViVU+voo{91BbaB*A-
zghDyhyb|<{;N#JjmEMgjy&8Y?e80k@0f+|7`q2$6Bw_EolCYi^JC9sw_eku3jmH45
zL;~8G3eSm`(7o=^TMy9^S|<F{s8BeCcWY>!hbn#qlFfyOLTJxAmd^5VbUUD}4j_OH
zfD9~O5}GZ9e)qs^v1j_kpS?4MvS6481wxf-6W`jCYrZ7DS&V;fk1wA;_j2L%3rkF;
zF1~suzS<fKF|&FxwqfC7r9P%?HuU8m5t*I1x>`o_bK3h-2CkgZjy$T!jKGzr)0+zE
zA0CRyRm$Od`9zCah!e1yG}AcYNR3WF(u*jQwEEt<EEpeDjn!}|&#Blvpa^fMLOuCG
zIab9VEFHz=(AqM`VGxY)2w$DX!WT^vN+=D;P|H1H!#!-}4K|F(R-`sQJ~!4|tmA#q
z@|x7#Mubm&reM|bX_e}!_hRN-G5w{S@s>+|3p0$o!7BbxwSv_oXQB@TN=_SxR;QN_
zse}VYB}1bcQcH)qOj7szn%^+pE@$Q2ukv<W9X*g>+?B-t3)?SDY&$o(?Hq60Iqv58
zN$_S%*b151naRz_>4~jzKs3n3fKX%3r^cOQS<bOzPBEkFF(d0RBThiE$dL^vXzRo2
z>rc=(M2t8^z%%90x=<R}wZZU64y_oJbz%MM!uoy*?p+f?ToX+CC8!So`~rIY9MHSw
zco)j8W9>k))xOvzo~=TOg)D_jAQzx%h1dHZJR88SaI60dK354#@J_))-;G}i$^RO<
z0{-|l0NM9S|Itgm@Olm8^1Vj!a`e+f7=&RU$7lv0Exp5P9%$c!r<?*=NH#Cv4ooyc
zNnQ|<CqaB}!#V<fXdaAL=wa~nC^8lX8|xkjFtE}5kuoGl5Sk}FRjfZ-HXB`}20`#+
znbP1#GeL#$CS=CER7Dieq`a_Pdiy2f)x!0161L$jv9Xvt^8S;KNyC;fd!Ly_c<p4%
z7~$Da$0IqjVS0K<Zx%|GY@wJr%^Q{?G6s)FGV9rLexH=xspPcirkW%puldv$dTs+8
zG^`rqWIeaHsHQM_xFefSEfEesHBMI>`L#2`8ndY3qnZ49mi&j6GBr>#hRYixmdr}A
zb~QoIZ{^ZnYNwh^qBeH#V=42UkX|7isRAb^Wi|?i>$Kbs%_P!c<h5%#ZNia8Xu#o(
zwJNwBQf8})-DebWc=Vd7;qu^X?SAK^2a?60NVX?Mz5BB8FYHX>f+O3J$OoW7@;rF7
zY2ey#3B2uR!J$FSM6t!eFtA%4SAb2YSwOE}F(cr<kPT5I8zSi&A{pxeCr5sbpaa*O
zz>9?g#g<&yz`9T%7imo}@Qb)6goJ(!?Ozjuegym)hzEZC;)h-9j|0GAHRxvgb)YT_
z^;*p<y*~g@R(S!p8drKW{2TQ?NOF%)3Lzks6qGg)m_`n|F#rh7poSu}=$!G$yDY~D
zHXZW(@Jwa^43!~}dyT?dHIOUd7Ap)?t_vj4(G>=M?4cB{h){Y*+a7WR{>UUW{rP0_
z0`G~TrxZrRKt9(sjdv_d7MQ2?%h3cC82$1Qy;qLfJ5TGGCG*MEAH8SszNd>QUGU2{
z1{Tg7yQ?^ntqi_De>86)?ICrzu6Vc}R2e!x+U@i~oS22R$OaY+43m^>5cgS?)cIMy
z-6sC@NntTVo4Zh>9y4f}8Y$#R1PQl&MoOBMkxlTM8j4LzHcGHYX(wV+<7Mo3&}^mW
zelYTyRTH%~d8bj>Vi0_oQxc5QKD~@MucH`6ogB(@9jns9tJSjJe3G~SOWUQMsIut^
zA7_W8>?+~tEBQpVic@RV;uV})v!qSKZ`5-;XGMK>4MQ#Hw^>D6Db=oJTji5_0Y%Hf
zj}t2{Ah$r3n71QE<eEIW`zkz^3V>W-cU|J|y0pYBA?W-7zkpUiF}O_vvrstv7s@OL
zxi&$NJk0`t?*eRyX8Z{>LNfnE)aYh-z67?N82UAA@YgWPx=@6?Hl!c0CKx~h=k-f4
zVNEdMm*Ae&!65L52Xd_kDY`)Xx`1vV*P7$lHOD*G_;-Sg{3=kv^=Von*Al-#QXckV
zIPh+z$2*_IZU^vwmk7RB2*<Ax{ZsoQGU=h2)Du}CbTb4AJ_24WB%Ky@ZvwJ(^qJ@0
z6g)^ne1vu`=!Jj-*wE~WpiDOO143+s_S1-5A(S9sLK@mhgL9<NR|@3vyak;PQulPp
zkqnuCj=}Se()G5?JzMFKqjE*$?zd$g_oQx_V$ZwsqxaN)_YEHRb>3N0FXW!yB~zJG
z*vM=vXJMa`>dHpjYblK-vau#HyNTKVl0RB!l;D-zHptV5`>VKPEqqp+T1ryOnMO5#
z)+jW~Syma-$m>^5;4EU2S%}w9w<;%U41x{=zfHl0*!Ge|e9R;iNtx9OcD;JC(I{v&
z^1D9jS<rtos26st;j;q!MMtoRS{HT1FZw>a0&kWyT9gfHVU<~4qZPiLS2h~hFJ{;;
z=B6su^x|30D+#m0!2e*DVa*z%Qj9Z5@t@2TtFBuo?UIhy&B(h>r*!POF4%WdcI*;+
zf2z{usuZyIirC@41iO+%yOP9+<C|zlqVO-zwevh50B#E?27m)ZNT^((#f$g}0I+Ox
z92zIr$Ba5bh93>l5<D7fGluRQ3BHTE@#GL3Hk=q-9}c%iu+;V8gTIE8)`s@34JE7#
z?Ohi}1fbkPf_l~i94uQG&;`s|<KOYK56C<LT4C)4P;8Y?GYH6o|5|;l4wkO`>|Oiw
z(OOT~nG7vl&@_J$wj|;_ueKk%))kOS@lEOXPbK@N5`C@=_@xd8UZ(`ZH8Nu~EORU*
zlO1@IdGZeX6qFzeA#)d<%tNM6<W58vK#djcrim_4L_d%OXHWZOp>Zz)`brDbC-T*P
zIco4$UUy{fw?uyTR3SyyW4T)QI}+df2G6@Hk1Qns&c||f{sm^QY_&(B)#riaNRDpL
zbx!Gv5AxxLLBeZl-EBcz!9-gwy*-;pFK3ZUr|2({32G^4=qY#b-Q-|3pI#4EKx^QS
zcQA$<m_s#_qi9J%!hA1dHcLmFAY{o{waSS)C8v%*T)`nj&vH3upo~v{DS*UjyoNtq
zK8h;<F%hkVVwRHhLY#WKSubv}LU~<?HB0eOw=&7_7BOK~(!Zb^u^~#jSxWe*rK-6-
zW-)n2O4Upe)Eul)O#Wiw*tM+BW`RLDYSE0%C`RU#44aZ+ln?!3RYfQDZavT6on~~s
z&fSeD_g|MCNL3v`CCeoHuS)l&i1#Fm_a;ksCy94m6z)tE>`D~wgu_MQt|XLdza>oV
zIM3U04&lMg(orJgZb?9~>C6Pw$~MJwHpa1?0cW7P!A8%~bSL0cq~o0&GYqX5>rYbP
zqf_LdQxqJ?8^cH-uJ#vzTqwVSdYnRfH--Y&a3C1AHlSl|K>NA?EC{Ep@oV|TuML5(
zpM6??0)0)NhBdzL!Txfr{zT%7;PWq!pR4e_Q01F|_d3(>c@9>2ce!3@aZSP=N+j;T
z)a{yrKbk`DP9b_<AN0?F_O0O)*)WU<k2+J~pske43(21J%@~8}3g~tYzdI3@!@(3x
zV+sXPMbZ<6^5FYYzbuIlavOSQ6kfMQUYTP5JoT|Gu~)XjC)eO{2c^}~dm5nC60>~r
z^bi$+Uy=7ehL&o)o~bY7X}Wv*c*IOHG;0w`M_LP+UB!&<Vscv^rRCmae<{1Km`{Dq
zrdEi@>sgeSlf!Q&$S=ppuO;KH3U-^6*)CxsEs%0)c`a6Hmu~8Vk>6qzv}oD&n(^A+
zn)H_E=f`k`6I~^g>N_HQiGkTD>3gnY)>!ym8g9p&oHQ#XsyS`i$<BEtWmZPAD#){P
z@PJ)nMwLa@X5=^NrW@p(I<vTEMn%y}$rdfmq9o57rmR}7Q8})bj36^gu1PgvH}mI=
zT;VuQK1J1wNkm#tUU{caI@L8<y(fOo{nDt%HQvD#-u@KvzH8FGS0%fl^&>^HE19>`
zfgP8ob|y{jy2JzfTjJ!73y_v^x1Z;1OPJVtp1mc3wK<--DV_;-^VzY#;1tJLkDMCb
z5KG@21CQejrzpA;hQ2Wh4nrV+4BceT7%FJhI)M~&7||)5v>tdA(hJr(jNlwj0J|Z$
zdjqKdf>e1Bc6~5pU|s7_w5{=PT<6!k&JUK{eOT+;^s{#jV6}Jc8lU>AysMS>Gb#%T
z%JYiKA0StY3NljC9>gTp1z#KqIL|nKq0j4VJM6gix<>WBIplML8gzpem^Ks)jrO<4
z{BAK|Pi%PZbXd-`f7WR5U2br;$p1F~c-C}amLM>T4_i24;Nk={!RM-i?}Fn}2Hw|r
z-;n^lyt71}S#qzt8qX}XD<TDYf$u_&K;<D@?VY0qu7UMO7r-u_C}0)8uVoM_`${uO
zwONeTQW#|hF$OKGnNN8!(N{9kRlp%Vg%Z^WzK}<I0l|$s_?%07!5euwO@AdEdBf^2
z7PITP!<ACjTX0P>RyEYkAsCu@%{Fnza9d7)!_ASlTmdrpTu6VV;??VUAJm*$-cY5H
zPnegJ6s#5l52xXD%9%|TQLj;mx61patQMmfr{vZ%dkc8fmu4~6A}1=iovO+AO6~`P
zu>EaO9H|}TzRD(OwMHe;08kC;<s&w;P{<+T8jJc{%M2p5euDnlIK}LLuT&sCAny!1
z!>*}P*K3jkP(4ls=}w8uHOcSEqCLQ}%i>*^AXW<ZTo&(6hKMNuiUD?9<Ze&oI1+xe
zybsuNma}9xonZq|-vvQ3ZhUhL17#J4zA1*W33wI*3drP*(F4wyK_?6aamG-#MpCv!
zkT->soWn@YV8eR=PNDb>Avly=!8l;ny1)+f5QJMF*tRb4!-jyCU;Uca`F#Mp#s^r|
z41hyP?!AJnjGT;=yv!>lnVGL1<X05tl^14~<Rum4re^0nL~>rA&uWBDWViI`zzouH
z1fl!hg;r5c;8lt*>}kFYn}$I*6=p6tKDT&2SwgS7yrWqHkDEN#)NxOQ?Ulv%%;dY@
z;<;r^d1gvoGlU+uB}Wi3=*+uk%3TqO$6fhfArbfl+ya0H1K;KT*m(S=xa2Vj-&sa!
z%o}Tmeih`|aK}S>_Y-PIF?-;pPTa_)J!ey%siqo*%<3`FW?(iN<^4tl8M1vAxl%sW
zEaSC7bz*9~S;%fwva4o99SdrLn%khC{-75$LsT4S$t5=4H3^A~-eNkTNX^AA=;<Gg
zlzBZ#J>6lIljc+dMqxLfUc(`kBZlcVv#=A=`%k7}n~}OW%aD#W@~E$^O5#T|)u<uZ
z4P=XkWR&Bl>6KO!_2ca1$2q}_k*QPA7A%uiHNz~Ss;B#PJn|^<P3y}ndQ-8W?>VLV
zF{?4}WRCJsGSe+pc{ok&3N}@K@S5aMs`%hl;r<l9%jIbo1lriH^7ma8fLQFVOWd7F
z(@WTq$lH;`*>Q1V3ER%I09((qHYYGQogLi_NMLRO#L_pNq5+`K$AKZ|m_eY}Mhpej
z*^V06e3JAhB1oGe`Zk3V0nTB)P9eas?)AZ-za5O-5CYDt9S%-#4sPEN)V3k84Xjg8
z+giWcb;s-0`qi!Rt+|<WJ}Wh)Fbe^c+|R2lEh#T5EXmJ%Rru&Zc1nKM*%!GfubyO=
z6~DZh^DY*isBcXAWK8>J@d7gGK3PM)_gFr6C;c+{{yB2*J3_B~iGQvH@yML?%$hu!
z&3C`eKax4^p2>Gx0wQ*YhrwHNcl022M`RwiWnK=S<#`wNT;4ev?_6+Ps$;ntzkI{K
zJZt(R9HHvb2>vCXT25`d$s1`<@!Ay=Z7MEaG*%~)v<!lL4WpJn-X`I8O9cHQUY{0G
z4o^?wC1Q$zPta<IH5&S?g{3!fZL?gn6sr@q$=UCr=4ldPEoz)e*2y3~#W!S|v}`Cv
zLF#7Lj(pN{7f^B$j1uC!cF3+BvZ)7WWF!WzU_sq$5@YA#MRKxHFX+??utr5Ms1+)>
z?M5*{%WbvlkRhv)zA(eki}6Nz-;A1UR?}wG%#UWiQ8D~!L8%jwXB5Lwf0Il=hEHXa
z8*p!O#s{1AjEdm&QSZ!&Be&s!Ugw@FbH6G&m<GKe0{3g;gI5GDS5RW@y*j-Qr5Atq
z<*A()r~j&o?YzYQ4LsOIHUj;-ThBAMo*&zGeti3R_O^u4t!Eiv(L)^l|A)<|Xj@`O
zHe!HfRCMpeNmwEW3%g)rT;G;Rl5+%cvx8;MCx|e=yYU1bw#qq&W7mhYZV2fFZmkb)
za|&z&EyN|jisAK0Ks|hemDUe4GVZ3NWL~<IbM4xl)T^1-t`y~Dm*(d^$;&U!DSCY8
zUU5cpWm<fGQet{SSYGnUawO@={l~~-VrVAK72&yNa6E3pTJ#Yw*e#OEa=*p)$Qbju
z$vt{=%<bm*!A$XiJF-J}q^`HYP4N$9iVxqG9?pPALIix4{4gRrd|U1Y<jT?jv%Kyq
zfmYu4v`4eG-uLu=_sxEH#n;pBv71tcJFer)GtAR{(#aM+t$KQ-PR)nc=uVZAWiU+6
zn8i}bm_o|3*`WtnFwJL6<$R4!DOdBQigCGuB~-E$2A)>OR)`29E*8=u#AX_kOUOD=
zi-=WCY|d#cPf>{pYJS_imiSRO`q?;P)An1{gn2FH%N$cJ>f(&N(}=sva)O1!6=reQ
zCq3C_p(w=NbLKINnPs0H|1{5CoaagTgimJpyQ5as@Pd(L)YIh>;+K!2MXUIuRjie;
z7wsm4p8pB4X%_7&n^ibB%QI@|d}b4_>5+D#8vMU&8hd|+^w2$-cN)+8I@c{t>TyHv
zo+fs^E;@J(IK^|hI(;BjaPYcte=2`hGJn_QKd~FmXkm=K<05-U;`q+Q@m&|$yTFxQ
zV1YvRwgi-3p#Sdx$hSLA+v6F)we9gEn`4JIpQde%rEZNPZ^fY4h8ft7p*TknHl6H+
zO@&L?1e<Cja9d8|HimZs#Wse*)|eJ2So8`AYS|dv>J-$lF}MNj`hdFBi}5#8E+E&E
zt|gwio)DLs5O*u-d|rBL!QGoker8JX-K%$#Pp7BGKgzq7o^-0{cGktn;D@QPuXD~d
zmEU@ubGx9hDl`MXFKyyL+6b`hK<3o$^oc#`tOK{k58vV)x+Oi7E<BVWIg}wgoT)l=
zTXiH`>wZ_|en)lWw$Lq;cjVr*M?T*(PvDUw_R3Xy=jnZNb-sB<6iA-w_#GY*KWZF$
zK0&V5NEx5ZGS=W5@nGHLV7Z+8Rx5a?(~)g<nN-GCsx?--&20Z-n78X}X1<!QwJT>n
ztBh8GKukAVCT$iT%q9M7(Pp(w*k-8~BmIxhHlw)1s=)DvUJ~EmnW9!{_#J;(d5b2l
zRW<U(icEgCjL+-oU*;zMSl}6D{W30gx~E{G1GEDXPFLC#E^VSMT|z97_dgcl^QXIV
z*ll;@l&7lEmmEU=Bq5*Dm?q|S2{|3J+EF2^$7T`IiLctLvOh1{%<!UaS6ODna~7%1
zthF1Z+;O5@2@Qo!Elrhag?%2k%!pT}#P=5ONV>!|RqUQFhExm$(;b*TaE-VB>ePX&
zkogM^rU(HCE(`W0bN41q?oHwVb|-Q7pmyT-i>%#A<2x@fLCSc?dFZ`hECKCKM4cFf
zN6MDdgWJvw!={pLr-!yhp_JMNKroc;(Suu}2!CN~WY6XZ{FaFBtr2+VuukVN?55C;
zjloUMA<eL~8nvM<&Ovp~!FA4obxr{_xv3YCi*adZF*g#TFULkDV!~5mF-g%88A%Cu
zE}u_Lh`Ez`@ygi<|3f<>JY4+tZH)8xxDpkdeeo2jru=Ool2rHnHleMO&|W{-`kaNW
zBegX&R#m*IZYitjF0SgStRoj!k?+1BUo0ZU7E+=g(@s2O_-2iHA$<4i+C!-dH$?4v
zN9CTSISTi~hoCTz_Sg8_S9#|uymOSkIgBxeScK2xGwbzA2D7__KU}8dG$>isCPABo
zQH>Z?G`m%6w^^-ordhkfXjWKewQ&CO1t!bp#eBL+Ni|CGnyFSDw@${cpD}_)CDW`P
z(g|^P{lF&^1yU|}5MtpAxuhqP!{t^j{a?1RFSb!=srfuRI&U0M^IK=+_!$LW$f{*`
zWLi0umho~Mx7^Arl_Nv>5^|n&AWuqpIL9s5GoJ`)MRIxxK*KCm(u*a7B{~k;y`vYl
zfTyE0AtQCEI%&U3KoK+B_~ciF*Oy!FgchGU#A+%ARRHl=HSJw`a$*h)JMGId9l0ew
z0@*``$ODnM-xRv0@t1J;`ZSdD52Yf!Lsx}MK$Eh|T$f}Al6ZR(fn}3>E{^ZM$o&1{
z7+`l2u#B|>8ZQ#YcO<ZWiy!;#ED(*pEuOj^w#3C#x5m@9$I*U+?Itlp+oP%5FoP&!
z2-{<N!EV9yz*ahNS->p^y}GwW;1O8;x+T1Mb6E4HP$1U_)CRuW6jb9JSmWehof7JO
z4db7FI^<HA_vM)Iq^Qu;xah=)@JrDV*W#n&LIci(1|~&?xo>w)!h{!QrI+R)Hxr_t
z+`3F|C?|F`5^*)yrizxDm#ua6osA7GbyaN*Z`vDPwbZ_7se9SgT-~<6r4rv!gKw*W
zryDx4j@tVkkF9HMeOJ@<;X`|CV;!!zs`pX}CEy|FKqkknK<52W=U=P~c%t!ttoF~N
z{s96ajVXNgJGr2rSaW%_^9}=-!y%O@M{1;uHobIIFX!qMBC&XkC+>wN1wFL>!4#K<
zJ7-cEVU$`sVX%qJX0Ap}Q^^NxHu9{IIinsmN_%FN4MuUJlJjny^kk?rf4mp&2PFnY
z$KnF>lZ`%a8Teyy<g<lhL3CKVxyPo%jSoKUC_5$SDKIjh=vj|UjE8#01MS!Y6X&sh
z{E?cP$0r~&)6YfJ`)XFPdaRh&pKWB-eo^;pCpx~E$3JT6e0-siTwvlhTBQW#XoZ^g
zY^W{+`#8nOq0G&hY!;pU^Nd+RpJ4LtypzMyc&|HRpG-vUeoO3`30-Uw_jI90h8QIL
z-EWB8(uAnJE=B<{GgWx-is;}KuqYfJjJqe1y~HhG)t*b^fZd546c;9To*Vz|{Mh#M
z^zG+i@eX6#nW61xhJK41+7UOjD~`7P6lE)18>1<(E)^C?leV8CZHelI1yEZefnN|9
zJGVsRw@3BDMuu$>UE3mXTSMD6hqP`CX?G5&*&6h2b3pZ`fa;7>!6}&I4{s;kPKn7(
zh>r7d$9NpP78RO;IgxqcbZTtKsbl-X+;$&y`pI?kFA?4cVvf5eMh6$>+{SgZwl`IE
zw7ltPdW}VztFdiWZ7r{{?Qd|M)r5`)0=5C)S%+<}?rwjFZK>*Ltf+re@}eZCv#GKd
zTTj9_G5R_Nuq}Pfb!2=!5#NL-l51Ot1#g&1PZ(j3c;0z}@caCT91e~+teU9ei?DN6
z!D!bDC_G5%ui4Z>Egw5)m{99jas_S9hVbP|y1_7^(XwpwVxyUBwF#|r0=<E0wv5^A
z+{Hzs&8}YjVwqhKS*&uKO|4drKx-km6AiCXJXWdXRFC(AIAEog_ikR@X%ICSrfV$9
zwvTqIX1W=ksJ~dKJo59Qj)(ufz_!U7ZBs8z;{_^Orka*1r(_~>N{*89K-^!zrxaPZ
zl>&0X47YNUkRu<;GO<fFtk(<LKD&V}q*qVjvZaJ#RbR<a<+aY@Q+<`^$t`&X1)EEI
z|DiAjS9o@$rCdp`Z-0^#kw$gDul37Rc;A(QiofSAo_hutRtS0^{3FOTSO9o4fE$u7
zIFLGZD3$jouJiU?X1k<J!Y0c-$&5Y8BfFF6u*&53q~X2s)O}}RBO&eJ1^R)+5tnmA
zdlRVp5@<W)DLdlGzs2^$V&325$iJhO0@xWx*dB|8J?5J+Z5v~7zr}Rz!gTF8Mc5hH
z`CAlrE2eF0%m?RKq-9fdgLCA&4H0jhPc}M5Hm?b9`Z@GH5*v0cCMfU5`9#d|_~WiA
zCw=cFMW>uRcHU?2DX-n<!@W|^pQtLy!_~hcW9$37-?ueZVOy#@KD;L58)y{l0I>~-
zLhNcF;Xe?%fKv56opoI;RRnBZe{U1MtB#0mXn$YP+583};u@f`)7|=xgnLiusOjmd
z!#2I|Xlue_8%TsV{kYeZ=2~3aQ+!it^ZTmWrv3*nsfkbNXJasxh!2DGW|I7Z*O$+w
zl!@78TFLuQb1c1%Ww!9<ZAzV<J!hNN8pe(0Nu7bM)ic$)5rdJfR@3x4x>iLuYuO(W
zn`qvuu+Iw?tjfhX)gND!A1(BGVVh>ON=Sa%R+`XOjOi|q!IxvWoi~WDV+O0vkl$Tk
z;P0|<nS=GoZI8nn^ZefDc&eGDi~7bz?fZFE&CJwe6Dv<WoU0!#(leeISuc(3N(JMY
za<oi6R<56@ut~d2ye6x>%Pd1W?6ZRl>LGf~eKouLLt$cLPRs<Z?8~BBIZftwJ@|h-
zeG6RDcl-9%I<0juGcz+YGiN6&JFHr#wQ{YjtgOt;%sgct5b=cg6A=|rQ4tjp5fKp)
z5djfVQBhG5QSoeQW@gTgYg^m1=lMVHd%OPc`}y4a?uQEdEU&Kn`rgNhmi%TWVN^w{
zDI<KCkXKXCxGb$>{0xW#=cHLD!pzTj$bvn)gnxc19v&70IgZHW`RJ(&(a%8apT&F@
zV~Z!;Ex$(%fdKm+HFz?#{}kE)O9heR!FsThLAvh)|DOeQ91nnP;ho1Gcb<6M0SoLG
zVf9FT#2X-{hE>o2w4>fChllkJp2~kt#gPZ{!}n_rKd3$AUVFf!=Ae7+VOQl*SM>?E
zR<OgjTfV<eKYP32+I^;zb27^1=g0>){hZIc{ctP{@w`?*0{!k5{>Z7AM(9-XRH8h7
z4k9c}60t~99z|S6QHb(t1T>|HF0aTDmlsF{ocd~kxQtOFEatN_r9!&6JX=yh6O~bG
ztJw82zJ$+|35#SRwyc_?s49^NSc~wK@N1+zSt&~<=Bnz!wN}b&s_P_3eXT;#(jcvu
zl~fDpTy{1`Dp$xQG8Q6dLp4m+hXMLvbL6~%^ju4vGi1Ip<Sh)aUyqdiF{}7vuIb~P
z>d%+8|C(36eJXlCS^Z&3@@Zc2_iN>!^U6OL8vl5u{By4Pw-=I+Q<4u8qBo<(BW(%K
zw8VwMjOSX?WIOStE(dut&irMX_3^FnU+=}gEeJlo5`3ByeVP&d`Aje<$BQX<swvlh
z>7@UAR`l1~+TTB_KhE;!`zW(Llo>5~zK`0*4^+?}=*q*?MUT69s0jsOT0!dOp!+ML
z2W7Fd?c|yM(wU)(j|=KguiHL>+Upa3oN1d-GlwN<V$y>U<eYUU7yIj&dO^?ZWXC(+
z48M~0;x=*qB5C%glxIIBPD1qX3SrVIe*6+LdJ#ADQ_SEc+~~!ak)N=`=ObZ<(Er+n
z$iW}NdVfIopAFNWMQhK7^_)fP&irGigSt)ycAoslfV)ol_kQo&cidZdBCz{Af28B6
zpXP{n>mhHAgID`eh+TMTzVoX+>Z?5B4eRQg4neThOTWt-N_*4?J!L1nWIwoNopii=
z_Wae;$G-ph#8H<YjtAbkh6MUz?z_aeUG%<qI?(xC_`RQ~kq_~{SJQExYI)(fPT3@3
zvSH5_GeOKCR5KGA_?gvgaygxdhzrTm;&fSQChWjb3RpFKMm0CLijz|(VvBjX0Io7l
z8jq7E<WrS3oQB%+Mukw*B5P1oR0&uDZcc-|tWL^>Q{7P2q7;GiR8(_o#cV}2uTH{m
zuB~WNR>D_W>VyDT4l{*Ci({r?7>Q3(L#~j5FHIx8f<NcmeuEjxz5Exw+-C;f^8vx^
zxMX%pJ~LhS{+V)NTrxLY^>Ro&J5oJ6Ts1#h4Pk?K&+Fe#Dc()i|Ng4$-Lr=Oyw`ku
zsrdbuhTmTbe;Hv;YO`nbMQ_K2vjde2lgjt6nm@hK{O4o;fBx+M^r7juSMqn0mD5_L
znupaZkg(sUng8>?;=jL%Kh2l^He3D|pl`Ztu0QvAcb1Cd-zUU$a#8Ii!AknW5gAq|
zCh{phy$!TyJ!SQra42w|(-*%PDg&F=70z@P%rw(xTIsJkI5REmHZEa8POdK{sd9qH
z#OZ|`kr(tALs3b}#Kp8{7gJ`h6Q3g2h?7_GqgU`lSK<dR#`Ir}8@Uu?xER%Y5etju
z1{@<6H-Y~Y1t^1QReD%E3*b73?mUZHY}on%r8^niek!;V>~wJZnIP?PwBm4>_%K?2
zG^qY)Nb|9v*5f{^laFD?X5%qW<uT8?T>(w@zIDeQRbF_+bMa(7MEp_$9|c8t`9^!(
zjBq~n@Z=uUZD-_3Kx}}2d~gsF5D<9BCD`?Lz^xnpH=J>v*NFjl@K0_KQ7#SKw2@X`
zhm=;wNs`bJ1)Eq&kF8=PNLfi@W@05Xsgg;OaI<R4X!7#hT0yQ%kX<9pkpq>9a>1Ep
zlQ0}QxmJX5mDT0-5}ra-Qd`MY%1T=sMJh$Ptdb=c=c(%0P0C_r4O1e@Qb?IfX=#J3
zqP|9`l$AHgI5qst+VX4}FSDkUqTpvTk}#RL05awgA@H8prSGwiu7}+HkrMS_cD!z3
zO7ilVeCCB_YPNm+Y3;L7(accUSf6+pR=*mwe1lfl52sErH6))IQ;rWvXU64I!-}_a
zLmw6fet$nO|3W<pwekbJ@m}uScnuUUzZ_A`j@G_|kmrlm`N_KXvu*R!^{=L-uU{zs
zde^pCc{3p!>!mL|Et~BtS{UHG?`6Hz=8raKOtofBYw|{#)B5WYW;B_TNNf63Yua>s
z`Wpjdx-+xB6!mdh_}g<3cl_U{gwNZvMrz_-w55&I#f>ZDhb1_DMbvXu#)KlRF2{eM
ziZIww)mf3OXZqI_#-P&buOu0q(t2;EPPrt_yAq~h>M#_TILA-jz)xMpjbB8DFXDzT
zMh{=bjlm|lpP~&HB9PvnA`L%<_5BFoiqyk=mmed#0b*xR9cM!{KLl&e1Z!bY{fR)>
zIoRcZ8af;@`ki0TWmNmM$MxsE<p+K0PWVe5gJsu)MYjWaLBZ*vA*ArYsA#~=!`uE3
z++3WTem-~p-sKy9cYGoqhoHROF<x*7bOj52a5LKbA%eQ+ioWj_aQjA#=g)YrO9hb+
z1PK9EX`!-=kfNwN!epNwK3OkHZ?7P$h3PGoSt>!6keR@z<0~0N8Jn!+Wva?)jZ%6w
zKV2foXl-Dtlm!h6c5Ab^wx(PzE3Z@VVbZZ&#;cK(%OreRHD6I9Y*v8MXV*)Mnh^z8
zB`;CQISn#aU3I=vR@kiMHcHuwvI4b;RgxY{2)c*!bs_k=q@%quFusXT?&ExJq(pde
zDB;+LKXgdb)K$0+MN(fU=hu17^oac33(d!Q-5<Z|=4KjS%`|`db#URO{@;I0{{C+G
zEmR>a=>PMt@lU^v{{8o>zy6&4{Ub8^$A|tmbM3PuyqC{p|N3k2??1<$4K7x_KkMhc
z8U@M|%s-Qi>R97_?5BO47o$RmwSHP?{4k@L8&|z~p?N#swJ=`$c1HPfqWaxz-TbiR
z<yiHrr`4}UMK4Aw=0+e6mpeNudIt^N{gNpi>sd#}f+l%hL!M9)r&MHQt}}O5lR43x
zI;zSXZ_XU9&*-a3?G_W|%m@h+tFNWc^vODexjI2E$OBw<TWIln-}Gk>5=YKLP7OP-
zDCXlwe@+@+tVW6(`x(+9NS{-z;iqU=$J=%ZuRjypdkmvH5Y+J<Mt3@F^oOwV^O(^e
zQ2NW5c9$siBLuGuNT`ZT6OrRHic=DqX~Zlf3NCM?FyE}G2x6c=gMcd`6L4N`!5()o
zKAxCI?%6m@L3~*96TgfwG&$rk(cdo>gNk_I9`(Q@;?V=lLl3N<_Y+qaALlD5cUO$3
zd#L+eyvKQZlzXR;(hb9n>u5S2jPk&a)Mn{<2vJu~Xk=kV8>o|A<&d_0+AW+NQp}Dv
z478W)>e)~Zsua>x62_!KsfB)dWpQT%w?kFd*(~U6D(`IKH_F&8a(-)_ph;F*Tgg&Z
zu~o8S_#&9Hnx%s80>WyFBm%08pDh(;)`{uO(h_<S2IF;&8utW20&d0m-3oE}5$Acu
z@6u7<pB)H+t}HSd@As3sJPC?!TFSyZWyp-4$<6Rm35f5;mD3ZV*RSf{%&T6{sXxBy
zdH1RvnowsaBoONQ<IV8z?}p~)+kgLc;J<$ly`52vYgseB%)ZW|;vzi1B)KdrNRW-?
zWyTe!#^fTw3?u=?CP$P|aQR4JM#Q7sxF`9<5N<}4f}5t~rz?2m4h6tRI6KUHHzArG
zDurUhcT=+8pViIumhsX&wc^B&GpaXZ)eFPISuOj+pg_ZmnCr-!X{EmE%%9iLM{5XE
zO_Z_b-0_y|=N-(MPS)Fj(%EiymjJIVC-qe#)V5MeUu8mP1zA=Y|7KeEX}bC2bQ6qh
zt<h>}f(`<6C?KWhZd~sTY|qbOx{KlcKSuUCp(mXEdoJHEKX*PTGljt`F3V*K6A)Gu
zik28nPmD^V;G(FpQ8X+n(f@8*pc^5;H#3&NB4^|#r<G9i1^H|NgO#6{=;nAHxqbG;
z@g3$T?d^X&`dy^oqhxeIn5RozfEV7+FU~t4%-uC9Ffb`ND9YzSu$!yT^=miJo(j0*
zg7xuoJ^#b)A5Qz<bSB+9Rg&QSW?a7TtY)||yGwxU;zsmUAR1=ypp-DGB)`$JUh4(@
zQdoFHT$on=`(00SHAN#!m$1U+2#3^Cncc|GY_7;|;!|Pfr$)xqt9Y;^v#+_lx0$bP
zD(P=2*Q?4}rG@RXq6RUmsivq!QCu%&)r%npmMgEK)e3WK$}`J3sjYQfVSZA?LuW#u
zdtq_}Jt>?X7nqLmN<e#%0`CXjIztX}OG4j`^}bNYiD@W{>k=W@&Z?MBG0vbM@hP6e
zu<%Zk^XrWCSs(YQj`L<*1_h#Tei6*iO5Xj__I9BkVi}+Q9RKj9?ZtT2+o{T@9n?3^
zq{x$t944O6%@i{6G8W8_$BFY}#09Z(RvafSM8qKSsWIi*F{K$%#i?PrgdipfT}da@
zmu13<ND9ykhJul1vY{b$pfTygFy~oYUZ034%Xy+H$M;IfdR~->bWcGG&{xE3xpA$m
z=%&Jm*3wvgC2>?vnQo@{R+Gk>vnJYdpQ^Jb+HzjBP!+k4%M;z@)F%R>XJwLKZFXc?
za$vJGM^=@uY7l7Kss=m6{jGd`Giw~ta`n}WHqazOMm4`MpFz*d&Q8b2X5qpL@DW*o
z50iXuV*_pn-E~3TaSgoc6z%4O_<CX7?+4y=4|aKoa>GP;1x5P!#P|m!1P3JsV=}RL
zVmO8p8=D!Au(L9%*qkCdog9Zy2}n^|5+xdqedLjc;Ig736H&n#SR^U~8<iS?Nyebl
zu#xH5C`wE;AviF`&nG1!EDMQAxqrT%fqWR1PiZ;2W(I6sYRP@rL37s@qPohWpS9D+
zTXJ;Ogg!B0Ku#KM$$d8}>QkimDaa}=M!|`L6%^HsXpJbNr82#qm)u@OZLQ4gRWQ0F
zdC)(huAw5$a$0L0vrARlURT;&%V=wWC>Kj1W+|%JvT~NPGEc^hQ}7bCqCCXYIThu_
zNyDawJ|v?b@@a(JXz#QLPY#nnNem3R^+Q_ljYQN{)XkIH2EnTth?|Q+P(9U^y`Pkh
zw`JFJf|NXLdo@vAg>MnXwN;b*8goXGPUh5L<<z9&&%Z}LEEpzXl&-$*f8LM185Q*^
z2t%qOT<}!}BcfW6Dx$|UaN-)uW2FTsNg*OHikB4N72I^VEK7<=<+*XP;uKLnzKj~l
z%?uOLu{>&I6(bsWN!OS*)JX2EjnXR-#KWPxHW9+IBRcMYjz6J6N?+=Pb6vvz>Rfqt
zn3@wQqIgtMyqnqBkvi(IlBzDpkJM!k)MWHjrGV*Vq&@`&#)}Wv(}$I;p;|_tB)g7@
z<0S|4GqL)*;;9bdq`GoQ$!q3hauYFBLM$QlNnC($$Q{>!i%tR8Zu>a9-Z_88?W~jA
z`AhyTuE>MS*Swsr-aGH)_Ty#OAI{%CbJ6+OnM;QbpSRz4?dVaL@4vfy_SF6JjzO+&
z5s$o{xVxi#g96?Cae-(?5}Af1WJIB;SWGG=m=Y06i;v7rz*4a2WK;lHVvv7guzynU
z<D?*;6cjuxo}@5;Vz4&}<BxyhN%g<lgcK4!J#Coo<h>k|_t%nD)O&pl4?}UNmWLfu
zW_C-HI;x4VMs7es(bZCBdwB{jwpke8Tc5GGlB)?UZ@8I0*h24CWRAA7pX(}yn^?WI
zxq2n76*|4-6fI0Lsw+?nsV&mXP9<GkLvIu_ngv;{k`kaYnE)YisDWkV&<vDkZaj*N
zdJyY%ogCtUa=VDV_fuNL13ou}nTw0?xD@Mk9)16Gz?HMXSASd>YkoVc`t8rrKmHh)
z9#_my)_;Od)fwfdSE|3?s6W1}pBv_P)sWgn#7;?EOGzXXe_5L2DbMsy^4J^WY(@2Q
zAm6d`Jz+@>xQYll2@+naC>y6>;2QXNIV(cOimhegtLZpJNm3OH+bAS8R3xh^Q<Pka
zFc&YN;rLW+QAQ{)HBdl&s4qd(><Bd%)y9juY`c1}f&cq+&CHNwa!5EkCZ8LXP3r`+
zJrx60v;jGFUSB%f$?mVq98u>@>)7)Az*mTlGY8gPY*0|9)Qk~j&agZOmb~jlxmrHC
zy@b#sq_mZ1&2&m<bP7RkLVDDbXs`PLS8v_=?x!=m>`vJ1JZWoxz<l?96B~Oo>w}io
z2P`c2m~Gj$#qz-R-N$wwIke5%VcU*F+rQmqW_ieJ$G**$d(F1(HM2UjeeWJ~E8C5T
zslBDeG22}Swr;hzv^s3J|K#2SSH3^te(^l&-d&vUU7Wu=5#^s66`C1~$%+Xhhdm(%
zJt72nk<bAt=zug#Abcw=8l4oj_>d8aPLBvBql3~gs7&9Bno`oAQ>}9b`MaTNtpI6f
zK33B`hj_t#6*1Zhd|PRxh98Y|lty%x<AxfkeYNDl#*DT~M6XCOG*b=Dv_2K}X%}lo
z&zbJwPUv{rhWx(vBIqZa=w#0tc+g@4J8wFq<es`Loh(x;qiDqGU6LF*mn`Q|WTh#*
zT(l%Fdc2{uJS~O_r57O{0as5)xLrcsaSXbCCNtWXMnY2{--PjWBKW(Y?q7C2{hiy{
z0|RXmLo0u%Px@j)HKrH6o>0v637+ejqis3k?fK8Nuskz+?s?;1|6cg}@8=71ZU6o6
z)c^eV*}p!G|L4=wfB!c0?nU$O^UeBt4lgA{T8NVrM9K<qb%j__0lF+RK*Eer7RSq&
zIAs}L#zvH&KkG^pz-rh;UM8k^(Om*#6W9sv)szRR-Y2sj9V^3}XQ3{i+Pqd>Mg3)@
zW^S}{VM;VVu6PZl`s4ChgAm#o|Nd=g0cs?k%ik<?&ciOW{)*S5H81-r<_ARMZS2X;
zk`ee5Rc5pa61uC?4Dx(f653Lp&;tW}+pFjTDlzExt=s1=-Tl$|>~4pn+pG_mnb~jI
zalpcQpQ+`36RW)@J8d^u*qK@GHMiblZnJ;Oj@>2}cBb&sZuh1gJJxNnF|ydPe(SDH
z)_cuu>@9ZMTYPJ6v}LD>#df2OJ50=MO)PesS{&SFdDznG*p3~icG)>P9DQ`j@v-w|
zG;;f9*d3RU+czWJUGcsT@ZR@{fxc;BLHT$rB|L-#{1xaE@8_8m=$jHAn1l`pf9M(?
z<V}0xq!Us;j5d6jXr9&brknFL{3vDCqo*=LHwV=xCJt67jnt&HvBP^rgueRJsm}cF
znk0=l{$($FT3bBOoI9=OKtI)seuO*L$$r)+oHA6t9F;)@`>=*HtbtWs1!JAe5lwz~
zeY&nXO<PUrt1oDi&@>8Wvp8SC#5D@3au#u-kuRY}Ck5P%xOWlb>KN;FE!^#=0GBgq
zQQk#qF}&QQv<UAouS;PMoUS?Si*Ua++*t$7WxZPQ%xL2;lTE`NCCKYh$;$!WR1bT!
zqi}Yx>fLzV^sszx-tgh|;KFR*(_Y1NU(Ix%WKz$c?iWCDs;)6bL=O|uBGmk}8g^VY
zBdWeMuC_R;B;6M<)htL*a*<kAT$2FC6J~+qR}|ruoD@-RR24nCwumUsi{a7y<|dl{
z`m68XzYatEt!$>JOu>zx?XP@ksGJ)R{xU3jHCR2<2i1vH&wGUvon=$~qN!oY%&6?c
zLi^klEdG>Fbn@m5l9vX_FT?WrA=#T@$+VU~-BsQ#%hd?8HI>YEAvY&B^3nNA2aUIX
zXTIyq?)}HC?Hnw3I9OUAG`BinW_ft)jsu&w?KeX#_nB?AH?y=i-v;DmZvhV$yUi?Y
zjknqwZ?QAk3bu2-`L`S3!4l5T57ukV;K9boe8;-Y)@wKIHZ?!Eb?XUR+haC1N38*0
zdu|>%bnnbb*R!V|Ty*rkdfDgV`M|4=Nl&~z&z*2TeH7#BjCQ>q=IV@l<ch?2xf1;!
zkpeu@QQq<1u4yRmyZ|SCMb>X)>i1(U)BTdRN|Kz7=@lonu+TbQq`Ejl%Zprul_+6Y
zk*2RBkG9bImFb3h%6va})=>Jqw*;W`YDDn7k2j^~PwIuE-MpDW@w2|Fxe>|Bk&3Y{
zR(~^1t4M9DCTfw&q&7ifZ*5MCAXUjv1z3rT<Eo2^?G;pcK2ekv>2h?Z@8x6YJLj<v
zoWfi$_+39qMFMgY&;Twf5{UJ6M!Wy~v%PgTKB`+S>DN{ckG2jPRL`e6rbbnx2KnqX
z)X>b&&uX7d$evG0e_v33e5IV~q#GI{MpT%IHYCzek1|M5<BGT*e$<QR>}Q6W5=vkr
zkI+(1t}7-8bI?j~af0O5N>WP&v4M+Mu<*JX=*4Dqi8C8Y2pUm#H6uoljZv@(wOnd>
zl6T<uJ0gDGOY}Z2$_#unTsc2p4iy_8o;AD~Z+bn_`ulS=477POs$3XZ>^DMQkJr8&
zteEXDfpYuT6EIb&>D_26beD~^mW{OWht%9gQKp!kRLi5)^632BRCy8W`teiWu32ku
zw%K8;&Ef5KC->|<X}kC6c3TGv>%->T_k*KbBrc1+Cg$H7Z?fB9W^263#@KY*H|wm|
zt+z8V+q21P&n8PSI}`Jr$a*uojTScR&A_bJnS$9Enc10G>|DQj>#FsZtBh^dnb?__
z9I)8xU}*)|g!6|TmY4S0UEaUj?ewv`XHMQbeJt?WPgsxJVYjZJT$}=(FQRT;4!#8t
zbB=U(!Fzk8_*|!<+(|ypsgGS4k#~j~*zc#i=BGMd_Sfnv5K2Qqq=pj<NeB%a-BJ?W
z#*Lg*({(~(8xMKfo<FDO8tO9#8nQs!KZSnIPVQhkcV<xfVzBbnXw9@i46R+$29ZI{
z8P%3f50;Jhutz!|*__`gCU#fGD+|Nxm{HZa7%3x0&LT)z(PAbJu4w`Wo=$q~<#Y@Q
zxOx)ha_%#@0&kzi`Mb~)F~WjW62>dq>uT8D3r}vGsxC<CkTdlS1?q;9HWjz0y+Whn
zj`T{q+W4K#6)+g^)7#$papl`*%`@Yw@vf3TAvo1rKHtxuGYFsQ*f0C|Gu<Unn9wSt
z33AbDL1F`!AY)=A1;O<Qxc}+|jhNITz^iz14JGlNlFXi(Y>g<jt%B52o>tAkmQzDz
z%-Du9qBJ99LPng?pk-+R9DL|lTggZ#bGok#hDAV{;FnSHhp8Iq1c93B`QgeJgQdR=
z3ttb2KaSVEooM{D(4m&oq@^St6<eB#6eh(Lr;r5M2wBR^6y_$ii3&Ot1q>2?+e)LO
zTX*i*uwlohO<RqOE!P;?7?~Wh+;PI%?wGl?gSpkooqGUZ_M5hTXZ`Jd^KAeqJJUs=
z*%%qy8k_6^+?iT@yWZ5+$aL2RGaF-*oyHq&)|-550zY74z0TNbt<lz1Yb;l-wfx#>
z+sd_w<;qpt*R0*Se#2g~E%2W?V7cw29mu*Jj`sVUk2>5vc_i4`(e2ccM~-J6Ii7xU
z<;P&>3sJ5Y6Fe>x?p}y<y+HQ9L=C(_3Ao0>dI|{MPn&ojXY}u08fJRMJ>?`dJ6czc
zHwX}YS#*yywM`JOlcf$TGW%p{y>%I#;$$r%B~P?7bv0=nby?2`MgRGzfAv&3J1U*f
zL&>jlP{V<?_4zTy+_=o3Wj-4$18@yB!S2+!VuFh}%SWDzQWZwm<wZ3X#_Po7dJZ@n
z5-%${1>+id?-J&&BRIy;+dl^1I2&~5T$smYN=$&HIEzV&#6Gwh=zNlfL%cd`nVK4U
zT`94lhSk+t*4HKK>k{i)g?(BXM01<uc~b`HkdS<QKl9)J`7b&ANt=+`%*AR2QLV-3
z_OfuD5T~z<(F-HWsJ==zu3ea_;6mgf3OF0u_|>2@EAc9RR0B7vhKXtBCv{Y%HFEKC
zW@H05QBr_Ks_5aeLY#~lU6q6RFjUqjkM#d}Ushzmt07U3GNVz5^fzTgU(u{VFbnM;
zlade9viXsU7lzXLen7ZrN+(ouQ&}mv90Ze%^=FeI%n{E?Ln`ygGIqL>M^g#t4g5T9
z4g1d7vj?}>d~33Cuf?{V7F)J$G~Kq^csH`q9GL6aHru0SR^StlTiXG10ltpg?Ao?!
zo%!-r7GJNiSh2=z>GEygtln#8Zf|P7%Xp*RdXt@N)^A@6*fib&xZAK1sBNb);A_44
z%2gY`Tw?m=a?>xCnSQavbji}q%T`#dTn*^6H8I{}YT{sKa%Q{5RR{Z<NB4Q0MUJ|D
z@8Evs_@fIaeH_0JzIqPh`Xk=$e8Sxy7!mHwXb)D5XI_L`IVn&?e*9)o^$BKUO!dw5
zO1eeKEyXxJpD+LuJUEMUJQR%JjtauCiUtrHY@q4oaAQpWFeUwCz5$YO<2?fCe;Dd0
zg)uJk6N-grb&x!n84w{0@Or#<sH*_dD}7BgP-m?Iq@Il)SHaafi%<5c$_On_^5^0`
zg=F7Sa$s)M{RCg<D38mbt{1}HFNL}Ngud$-?*7x08>f>Zz0x9li6~F({Y#IXj%MP#
z>bRt4Aw?z1Qp=gG%3_VGq(>v@=~$eP+uq0#u;b-OISDobf1Gdq^rlP9iK#9K(h8Cx
zEZmgi-b8<>=Y@0?Kh|@f$crLWe0(DxU(3O%$`j?R@Va75Q+YI;V!FSKiRu)kHI@>9
zvRca%rTLh8xK+}z5=K-_VGKkn$|&9-I4P0m_kXi8747?eUj2Sj{JfV74g7)^{k*Xb
z=42OZO2;1WVovB-Q(Z-~eZ28D7CYISMGDW4Luk0T%qVo6_r0_TzsB-xy@K5-%dIUT
zDL9!Gxg;(bIbsRwXv_AsraLy7TbOJx`DUf@%B7ZTO%84am$>by+17&=+YejXfHSl+
zHrr*gdC@T%o7r!+MD}j7fUoW`G2gp!3!EU$4wzfn8JTWhy&eE)y#`3l6nJg7DY#J+
zfYRn=%gvXs+_GY&`SKN}OTIGsVhOyo`exluW8<AhYY&>4>@`}o*Lc;Xz1COlci#T)
zz<IlE9zUM&zIZaw=@k0L*;v;L6kq53u)8I3e%yHfA|%#Jm=-c1%b3zhKLWUBM&3Tx
zJkt~@nHU{6#=yaK7lpTR<9aI-`>T@rD~RKD)NXldrx0Jq4r>?1>ubpnYUrt>!s6zq
z9c+UtPc2IBt<M{4D}CC{9n)|}+hG4LZL}qCO2c~5&4I}=Y978<LT%$Ea+4m2Gm$_c
z*}s|+%tjuRrJ`sN?s%UoXty8G_s<94{W0L?k7##ito!AV+vmx|Kqd`I#dw6@Jc+sS
zT~4%nyEs!NO>3!1)7R%3)FnC?A+IjeYJ@`_a&0}gq5vmkL=5)||9IK_YDm)8%)jZd
zQ&*m)FDEGTd}TCm=$>yW3PLnolrZ~|q9{aF7S$$-lNV#;MJQQ8U=tr#UmB_8hRNAs
zE#*m|>gzbM&3u9&D^SHt0#(0=EEcY{GL4&s{`<G*ub=m`NTKN4C;ynyP4<WkD(2jP
z7=--7u<Vx+;p?%gSHr^JW}pW|41df>;G?L3+hO;vh9Y;b1>d=T_uT2r-|dr?(9{x^
zN|@6r=POES5>`qLn?ww_dcxM~^nQl}w$}SBwpguOZN0&GyUAudQ`7wxmix`E9Jbg1
zTz0MB1n0NwHtzUl{mwNTtXCQBHa4?aYizyR2*9y><7Rtv%iX41_HWsCz+(G;bIa{(
zj4W2H+PoB5X|ZzEXEXh389)hO^%-A)wM}0w-}uF{O-oiDG&SC5y!MpM_Oo`j2h27e
z+iG^g!u038c24&8m-g+w?r^~E*a7b!4x=s}54mv2`-Cmw`Z<!TW3uZH6feh@oxB-C
z{regHtC`{X33az5Rlz`avLiIPD1C7hGSQIxqM2@}A`MlNhNS5*_hq`fsJ|hzO+;uH
z6FVx>2Ws=XtFroJxhhVQUP^(r^gXhq&Wc!dNkmIgSQ|S`m5=TfCUus@sW}mHdbpGp
z#vweYAp2IN`O2sv!W4fF-jj)VrH8mA1YE;Byb%7-5wI2NekI)F7J@vu5#{MjA_U}R
zMJEM$_@8&c-Z-5Rbi08^t}Rb)l~du4KGa?^)Fpsjnz|0LuC2PWv9yv6%M^W@>nQJM
zAWxM?PYu3#{wOudwJPm_D$o0QQ`WGAI9P=@R3bpkawfX1BB5JKuIEM6bI|gFAlQdq
z3u04%l`#<%WSJUD;_5j#c|mwhL70+FXy6cGJGLknQ(uz6refazHt}*!_i<q~Ez;w!
z_hTOyx<9??hwhBu=6l|~=zKS){p;=EpKpf#emDA`f4z{DWI68Min@OB-VZ<CK6&EW
z(eF;%?D@&zkch!(EH6=Ta>^Lw#;Rg*ajvkCrm8MS)N=kno4i9(USC#0kH=p)uy2R4
z>5g@#-<q1+Y%;UiYz8>`Y@p}i;WO53RvX){GX{KFu3BxrVx{TQ6`Pi>+`4M5&H9ZX
zrM9g28X&dpn>C;D1p3Ni<=30OS_%gAWwCN4oZuKuzW8c0vUH`r(dyl6zd3DVa~f`t
z)>db1teg()y|{PRaf^+PyKH{iwcYi*-7$Bs5bj-xzvCEl<8<nS3uUn$B{6q+_}deW
zoVVj0Fvt_eUcaAcRx%@6xyZ0MrH>P>Wrt}i2>MDwM_If^K<uhY=@29v<g{LCCY*iJ
ztm(F*J{gjsuTC3MWcOC5>Z%eof>^DH&?$htM-t><Arsroi!mrNda6mSWzo$g*jh%Y
zA`dOe3gspF)?|ZY^b%40If>qMoJT6=ZW6{F@xKuQj?v><l;^Dw*GtjfF2u-3^dvMc
z;6{LxL&VLaSz#_Zd3JAo?v#$-*UEwV2jQSjZ0ME@=%72SOd~H;@KQ3O@A2u8^HW_4
zd750DIjSw6)|ML-nIjG9V@;{;f{2caa5WFbqj+{n65D`=73s>7s9IL2q7YTjiD)bi
zuV;rYs<g^9IUOU*MGI1WL>Z4E?gfsqGA9hM1qzH!L;r?+diM5B?}v}$<HIfQe;xem
z*O~cw!@GB*zy3PDurN3~-~0SU&#PC1^Dl>g|1js{;&jQu{`!fNR}UY&uxIc0);1@1
z>^Ql@GC4R{mQTZb-Q>|}0v1DB$!l+`*Y-3wwJG%m?bAtvO3sq7lbZN+b}IRt{kOX|
zZ?ZPqX0p!QdJSR>F3x(bG59*r<expB<=1Psul&Yx#VRv^$<k%E>rHnWZG<1QS!-gw
z)(E5+;K*z#kQL}EK-p?AtJQ13K0jNoTDkS>m1awqf_vP${41N)D-Uhibi&%|pqc40
z3$t@JR&Y9)tasdPyJzhR<goGAj&_@aolZpFI30HNX!^tR+~|7@lyh##mGK77ho|~q
zpZCta(Ed8BZebzP%z#Elh_)zds48JXNg0%-sY{|Y!j!>!=5q~arjt9`$e3th&1kp~
zXCAE00Mkpz-J&F&C`nTu-y<gV%hJXha)*`K5U<cwCutE`O0ObaS3~ZsjH_qCuPTI>
z^ss^)SV<17Nbyn^<EwHbx#WP1h`X6F593j{qaHaUer}N-H&AX@5<|SGNJwh5cc{k&
z)a_GP*JFZAw3?sTSDQ22Cmh%FMtfiir1I5-db(dZtgh^m6=q;PQ^W7FNg*FUJe`_p
z8P*{c)B1{v^pG|VZdjQ(EKkr@M(IRYeI-_$<JVk{bjzSc2VcuZDT^@;EOZ?sP(t;t
z%Jizu3vT7$>+-{DazZN8{oro_M8Xusak9b~QC_&LAexyO`u26-F94<wqaS|Nzgc)X
z`*L7nN;~^%XnMMD{^jV*YyJE?1M>Fu;QX|quAF(w*6hSiTgL<Tr+4f)v3=`-EvAQe
zSRJ+4e93;d`<Y`9If@JPBcek~=`;zSt<yF4>Xf?H+GZK2Syb2|pf_<cTSY8pGVX}A
z#XgJerYlV>SFW{MZ3MUhv9&0oj5flZ5a`Qpz1iLk=HMqS;U0*r0{Fmn@PAJL6hLgp
zVw_@=)#|lY->lmH%}P5E_G<u}Ut6zTZMAl_wb5EQEmp0xT(QLJo8^bML7Z&;E>ojp
z=9@3>w!M4^{s%0a4<9&hyJPq26;20i5Ra?Tcg|w(p3HpY$U@&{qHg8}U7Jvre3&x)
zK8F~l#vA$?^4r;QjRhDr3!^KI83N`J5wzv_c0qiPjMCpg>#j+G@{r*M%7mIW)s{Qb
zK<kAYq%2KWO#*y@byOq_Dl!NDxmoIK(ni$uiB1NXzAjBIj8k)QYEF!j5#GeYHkTwc
zv*X3o$8G$?nnD~R&5tf1_)=qilfv90ysn3Px`aJ&LAg681bZ_`SYR#&Ih2(YLh$^d
zO+b;*F~!MVV{Obnh~Rd!r+fHXISmR`@d3_=uM^JuB0cUQ9q;>YuCL!90cPt~&>?!I
z;o~}sL$sXGK{3)_8PmlH<&xc7EAU+sk{S^pGG>s98!gXANobFyxdGKQe|bK-zA#2Y
zLqP<qEXAih)lb1jK+J<zTy%^%XaPO))7ya$zYM>h8=D?z=xgB*>1Ye%6*KL5gM4fU
z#pCzi#%G^v7iJ8f=BE{fS>KtiK4xWpZny1;?c0uRvp8UGe!z0aQ9HZC)`<0C3yZ4<
z58gO)0&1WVQ2{(Esgg?Kr^hyO@&=XV9pXHVl-9r}$qEvxbBSkd&Gv8JxX0WY5CcE~
zUkAb*%+3U&4S*~Yn>EIE>rA$P4P3Nn@M8d}tzUlwCwN8p%0HB~2EMXw71-CvqC;G<
za{FrdxHa3>t+rhI4H!IZTfKDa*GmprZaTcpZ1+YZd*ijowrsk7^x*XqM?D<RKm6&!
z)x-N8?JUA?{21!=U9$JjG+!q+#+4C#oe_Ftw7vY#4=;Xy(c4r?l0X2FiV{<N8|kR#
zLR3d-WCt&*S47lTB=iZ114uQgSCV9?P8pP>_5x1{2zq%Mm{yVkiB?FJ_1040<zNH#
zX&dud2Xmw)?`aozsD(A4Vh%PI=xcM-qNHYFl8hBq!;V&R5K%Ttkm*xO@q^zNpAt;N
zd1YdK;{sgJ51fPCZ-n{X!#s4w1$fd35n1@)>?A0GNeCuBJYSO^S4H+}WCW;-gS8@D
zb4i4{9I0l6remBa5pFc>gQy2TCI>nv1>fv$;Lc2_3_UWnEVr*AtGy(&kAqfbcy^bd
z+u0%gf@lH7Q&UBR<fB@E)UiVwI8ikWjFgV5&IuM~K9<qZk{nD0B~VO5!-;T{ePj%5
zbzX#s76u^*5f#lq?g?@+e}9B|s8DR1@L{yEyC&{!U-rNBSrZl55h+bAD_)q=^fs5W
zsgX{{4xO;HI$~pWcK`m9b~Z-=T${}uw%HunYQ1OE=7Uz&SI_=%dbizaJKH$F2NaAS
z2)?qkNGTm+L3uh!p$3uVb;|M;Oj1*EW`dW?F$;6+^%g)lV0$)h+PQ8$h^OtV*M18?
z+hA(5Zmpe>vH4fv0GDlCvUJnZ<r}|R3Lf$wEwyChmtVnyB|z-!Z@_bcd;EXs1A+gw
z)$$eAE5F_j4=YxJzumD8u8YR@X2|A4TTCzPwmrPb__Wm)_u~g2oIH5<yFFfKkGMGO
zd~)Gv$i>6BTPM>z9JBqL@&d0gLY-&2CI9;E)tIift|+#p5Ub1zuE`E+F2De+{)q*}
z^@<YoVtgNLrLQ7%RY7DA_UFVlSKxb<lz|3nzcLf>)K{0$tIW{XQIKJE?o=mhy1Qh&
zJr7cf!<rIcLtvF2MUGYql%CoqO0DO{byTG)II&_nMnn%Nrv>sTfz|XVdYmsM$`9(b
zqW$ioyxnk^$M|61DBlOTK+ohTKT@o3dZZWD_2iI(-OR?R3PZrLjjJgAQj)4PrbQ56
zPW7iDab8vQ*j&V$hI^D8d|k#S$%Pry6P-$FZfgb7$qLZ3QLTVVR$yBRN>hqvC*EnV
zgrGZ7!U(Ekp#WSmMua#I4W}?WP(%x<$U^bb0{N7nf6l-fdX$)k5oUz&Q=jls0@<;y
zQ1-kqEt?q>3TfUiR7l=jQ^KSot(i}8blC0V^fMLfm4o>CI-j|8c+ZcAc71PUeZ<=A
z?5<r$thYIAHQR4)YHzXm+YLs0Oid4Nu{dT8h_i7!ci#QNX^f{cHOj9f6(h<{YUE^g
zO6WRyu2x1<@zNTLlf;zpLz}*_-e_jK-pFo)@!n0Q-x{yCF<OV%7_Hr9vf<nHMpmm=
z+OA!*<*Vfo$FkeF$!7hAt*chU3G4>`5NHcddkYJQbph+y0@E281D!1@{1q!VuUKxj
ze7Wher5l$nG5X>wfaI1H%lDcX?=@O|z|`oZmH7o*s~dZ4?jPUldHR6caeLo$N4!t&
z4ZC<0huk=s?Q=ED=W-$XCIfwSVYKb94^x_2b`u+Epod8^0@^vTU3@|(KU&9+8599$
z#rMmI!y<xSNYE-MZIYyB5urm)HmGw3RkZ#FDqJ8T?$xgV)=D34&YA2goa*L4GJCwE
zXjsi2({M)G*u4$;{VGO>n4*;;kfQ^ILsAKnlpLIp2Gx1N+)RHiDS(diq2YrFL9S6g
zw=q6$Nmvvi#3wGuixl;Qf=5&0g9}p7)X;mg8qqLp`eg+6L6lb(Kdi`TD2{5cBuWdz
zX^0Oo_(qKP<;vVRYNUsplTcAikcx8+x++js8g}3SKLY6!L^TyWX=MjD75Q@#?x=<M
zW*!b=4vnReb?hj40l)_(V}=Q-fg);%BsW5w8(x`>7G#ESNPc2QR0S1PK?yD)`V=So
zaw2c48IK{?x-ceK7^ryJ%y@X^n8k{(&K=(4d+vCFw_9aSgvYr9*N+@=ayWhRTg&4%
zR!0#l%M&}S4p^8vm~T3`W%D5`OJJV8re=^Tc7X80CUb`^=C@8Aqo4!GA#Nq9;D1wV
z+2nR{UT-~HQ%%)~Gh0gHVP=WTseOCQO>B*fcWv0XZ_{SrE<o95vtF~>YSl_OAub9&
z5ZoqsKTz@iJRtw;89{7WuQoPc2EKANd>aT31iaab<;F{w87*77cIj7ZmMmGlWXaku
zzcg98)N0i#`wbg*uUU22%;dy2GsivKZym6^>#)c5&~DE&hi=$g`JFo$dilHHpY{`7
z9T_3FS>d;{122C1Wq8aWla~-$S@B9nh$25kD~v}v1#umMgucq8fy#s-al%kd>YyU6
zuQt6~MuC;{-8HoSM&@7(dq7oaXkhj!8S2V3og%A8NrT|lgcf=x#AEH8kyiFtJ1`h$
zsHsq|$Q^8AYO2!pwU9+2*RgTUd}4JDN}L^B11>Qmlu3S)PYTS4^dvmK5sUZ(xNZ|;
zp2UZE;hwk?&|X>bsFdg+IuVl|c<1$?Y_2_jT%Pn)PU$SesY}D9+5Q?(RK@rb!lOKl
zH}=*wlD9k2`zj;;epwERo`UXF@fvvenq04bQKX)a)|W;#Wd{%QllaK}#v-JF1x^*C
z;KhmyBdQ9}RWJslijLxE1_-i(DzZYV7SR+~lH|=L`Bvp)gxM%*E~Y&7u^_=a&Eu3J
z)Bk;M^^8^kbLr=vxAwQmAvgX^FLc^#66fKJ^Y^@Tc;Cgtd(R%Q-DhEX%*NVb^VTEg
z7Dpg;XJ&qIllcMjMaKsCSOnJQEw<(sd$(F4@FLRvZb@25QKElseo{kWlD;};K*4CQ
z1eB$8i_+foNaMZloVMN$@7Zl)3ZDY-+`Z8R_zTXRM(b>i)&i-)W$&LL{i5muYFfn8
zTBFYn5I_g<Qh2sp1=q!I{s~GfGheYB{O4w5$uhGqmTvmuE3+?`8h^Qb^YWDz%a`sl
zT5Yp(*%9;g=f1UY++*o%zw_n++uMhC-#)g-{rK*HpT7%sKJM>y5Owiv@`LlGxI3H(
zmrt+9S{01y!sz-uY$Gd7&5iC5#C0utin#8|#13Afu7aW!kvpa2?z*gg;Gc#(-Qu)0
zgr=|0>2G2TwX()KIKyp4qn$j1x(G(hj(0*2bS1ErLB$wsW(~Kp2b!5Z%3Lr2RBJ^t
z+~CEzXkNO%fZ|`8?9EN`D<_2%5Fh8p`{qVIOhLI4gWUY@T#O2Ei}JsV_PT+2bb}E3
zfEemW3h^dCzBSrWJk&{r_ycWJ&+Sk^9epyF5|H%d8p+=|G2A)Y@A_eDbKpK=h)at&
zRV~jHz@qe;yyj|>DD(bsWz?`NVOW~{v<3=9V@j}h8j7&>g;+T|s;(rejvZSM{V3GP
z%3KUTD?~s=SLR^K(*ybGPb#S>9{Djd$%~gBP)2@Sj3juK;vQ5`9(O58PkZ@uLp2;4
zs!KxEWMlb6kJ?<+rR~O7_8z|V{a(09{k-4i+}<4y))vQYb{;mjJOcQ#usUqE_0VPu
z$VLPC0KNcEa9RK+pj^gmYnbb8Zd!<ng(#@lj*{daL5j9KvArCxslX3Z6X)9yR!*4P
z$*o54HUJmc;-{DxgG=0PYGP|_WM^!&ef2jRzW5Tr^$&0saRdbQPg3W91E=5{0a=!-
zzP4JuYU`@6%~wF6Yl+z+gDu~*WSQxgOE-S;mC2IDu&UWtOSZ09V)50Nd)6;MVP$k|
z%Ua~}j;)RsrnmRoUfXST>+nwR^9LU}9&kUm)8o7SBrnIJ$Q#0V&-wAL_8OK}miM%=
zP)UzyX2qyj*tSxFx}4YxE9T|doi$nQk}REq)}zePD(U*hg1+X$esvLy;-1zo=Ez?3
zLzRmZa*4A8qM2Ual(y)Ffj`|_@&YkH(Y<J_t8}o9-Pg?QsLgIHjc+W)%NXGjdRR3B
zgbi8-s*4)V0WqK8%SsE&i4P=&xf6r$M|$4E2Y4c(Uf2Nln8)`BD9<GH!>Iet9ef%T
z1HS0v%s&&)j7Z;&ONLvRHEdjGb%vaclx9Z82VKYdIN^M+<q{BYLWoNy0<7m*$Hjxg
ze%eAAsl$(p(W4@44;Nca@=AXEa}^^-oD1N>%Qy*Q7D2)yh#9fMyqL1A2mv)hT7U?s
zn6eC1MK-1+HL!r_Q<UgelJuC9;LAX}RYKKQjz>Qa`@AkA<<0>OE3q~erDjI42oJ8>
zn<E$Z?l@~}1;L=RwmVMm+Ua1i>8Q08To4bMo9{C--?woSNTuDIHhgw#KtVu0JB_~C
zX=GxxYR#z~7HNU^YBEA=(n7R+qCrfCB#D+Eqpv__K!cPe#JitAYi$DW0!V^Ov{`Ee
zzyitw?gCWV7_GKMR<1Ppa>=5e|MDvU2!IRNYU7fx-~@;P&;VSYBU=D5h&*grxzzN_
zFF>VjUb-BRW%`fihr0kMe6yur*{)x=+jxV6+1g_kYtL*qJ-uzCqs<oAWBXi=?YVbi
zkI%V-K4<raUOgOq{&14V#eDQFPAuX!-XhdV7&S~pS&Y<Vg{T-&O@(m(iif%zjX1SQ
zkl0#9*2<{eHJPBwVT0jt2M=sQUj-Ehv%}KKUg66T85CMR9~3_y5KZaJp7-&`wI%c8
zvf0t<$zA~v+OUQT@Y2Ys&HO~*uDYU_x*}|Ac``gB$`ZVSlh7{B&mjerF=80W!Rawx
z@qw-}KCZ+k-U!+&GSnk72;!>u5>ejxM>lnn{J9bF+;Hh=XMS&EzClHM+R5&erpb$<
ztMkK((?ScAf{T&^iGf%6+2J9#PUgcc0DTvV7n=Ea6&J6}@{<vr4SAk=Mu<4hoqz;7
zajBRp7M@29E6GF)a-&2{q?(1VEhC9p_)2<=n2xK=j;zXw7Gz@h6f`r*hk<{{L>^K@
zZ{-Bv)(BI_A<81ev@run{^xY6+@6LQohr7zEaLR;EyvB*AF(hyZUsKj3_@B*w`@9T
zYjbd`<vxh2o0tF;_Lw3Y4_a)oH(PX$Ae-RfFoYL?%Ql#t-?h{IkS!<j79eXH_BYBY
zhU!GU5I-Oyj8`WaDiTAk9yw#XY41P8XTKRzh$axO0yz)#1!8O4N?@BWO#xd=7O#uI
zMSv=R8e9<pTc6J@%U2-~jo-RzIRs20{s7OPQ;LvPg!lZDZ3Nm{X0Z~u4??bAS*}@a
zzj4heE8{aeOu;VfvUEDI^Qwcb+o^rt=N){{*<+lJdY-Vw-9An9bYw)ibym^)<jh(o
zt|lKNBKs?IF)c-L%^bX@3feO9>Pk`@B2MkC%j=Y+_caz6T47NHWFtzZ4H8&2GCxrV
z)6{>NP`;k3e=$@&)+2Z^BA*zPOpnTEp4Pq`ubu9zn$QWJb}!ZpcGu^rD@bZVl7bxr
zj&U&&T#>Bg5jrH<-O3_bqCbm*&P05(;{37R*YN@FvA%AxD9`8+!~+-Xf$_Wnb+*uB
zrm4*O1?B^e3VT(V(>-OQ8iuwuqmCO}l@}J~c09_{5q0OJ$N60m?q}n?E+=?hqGRr-
zK6chgO9eSebCUxLlf5I2^l@bd%o9{g@wtcx;EA6Db?{hd$0(y>N+_t(Of)Mkm`?O9
zNe`*Y!y<APUPyyvPgHp(x{&D0O7Ja;_bG^ZknVeliS=q>6Lh>7A^C1<)b;lt#((>5
z>h(hZvth}rkw({JcE`4DIlXf`oX0H9_nR0U*bH%~jr+|vgB)6PU5n)g8$S~luomzS
zr17AHVW;tii~DwkJDn!oJ1s{tQJUg7gE(neN`~lT71^VYhntd9AD*>4ZDR^pwJ}<h
zS$4+j;X^+&7l6xh<qD8V=F0&VUju6apa5Ts5c~2g;41(ZJa1kKU|O<y`I2qlfT)L`
zSq>r$?6c>DP(5&+=@Mj#$roRMyM%AsZ8AN)#l+EW>q#q<Gds+Hm@h&S+hOO;qqdKJ
zJP_dM5ahT&`sVk@-Lq+rud<Pc8WF8il%-^1A^u#I`WT2yNsofth`J&f8hx}inH^F}
zmn=)Kpz7=Mdz;xqno_9Unl?yhhH7TV>Sh38lZ^=c1F(8FD1}J*^r&*IU-EoRF$sRN
zzY1szQhx?DtE(=jLz>aZhdL>;x`L=GBLZ}l`~<Z)Q>!Q}BBP4aFnL5&M(pEg@9Pl{
zuVKAz;89+<AP?;0dl)YlwAU@H*X0foWnrx5_45W8=xu1G!=OrC0~O*w>7x7yV3mZR
zoARQ#{CKbYI6t)8MdZ;Xc7iWG*0ZxQH;e53>C?ntzYey_h<z&Z?{C`2`^6a%cdGJZ
z_}LMF9;p5UtDuFKQbJ17gUhL5{46vt1I14E=cR{K(jrR8fxML9LcA}B7?2m~LGt{W
zfx9uK&3`wIC|l}EszpVA{pY{``TPI;=fD4+99B>0>u)&hI=Xf9BC@t^fr6Don>X5<
znL>~gm<w<K%(dthL4B`V50VMMwJ6EgePg%L6u@=Z+%(|);h3Kfu`q7x0!$|-Vnm!e
zR7Gyc4brir2P?=f2Q5xm8t*oRE20SkpR#4yQot1WL@>au&6+jl%a&|e4z#t%T%T1J
z!0I!^;QR+)E8sS1wrmMVF00j$Z3H9&0GENhw_dvzo`K2$QX9Vb!eZr$jZ41Vws!5&
zt(z`<Yk6YprqkQET-?3$(mtD;-|coqPVNo3bj<(4fyd|eAa~CsdOD`~UdqF`$_ntc
z%vcpWMwI3w%M4aSroR{uw~;3JtqYSux@+ZG;1%_dIc#9`s91VvyJ#+YGo|`vq5-Cv
zO$<n%k1F5<NI^X@U~PJ!dUj9&I2+VLUZxDN)!S6q*NiZG8uPV^Y_%u_qNueTY;7^p
zButWWa0-5MV?_oHdBjc$%ZhzM!3D(n-wyM*g!R6P3vfqyI1@r1;)6XS{M{lwf08ny
z7RF@1zS1lfRri$+YZ)z2&fmd;MmHIU&?rb_rub5@cd0Sni2)utQ4i9BuTer>N;1L_
zy_);!_h%p94r&_m2D@@!PSno~=rb_4#q=1ERsfvRv|vuk6Fvn6SJy?Opvs{6A``_;
z4J;--W|REcN&bb1FDD_8h4|%1d!>cAi76oiP(>)ERp#TMuj}tmA4a-W|MRaI*i}0{
zpt|f}<6v%j$lTNcTpeP(_Pec{51MZV=5p9-0h|TMvNtmWD1cgmuqP-dFkrX6o6P}$
zuBVRU?l|T=xF*1Q3yE&ZOm7V{N=^x^B0to!qV(Lv8}{a>wr|=6NHkicKU<^4aMwPw
zP2g}ra#?--HF(9%OTiyPbpv=fWKouX2G?gV2`6~W&C8aVuLM!G++r0#Y1wD~0w`In
zUj2_hgf~Oo4bU8r;4)hi69CsK%graZS)AAkNuY0myRICxxp8Etuj66wvwH%5+>6{j
zneOkD6?}t@d)UM$3$j85ss2^zen@>Drl}yhy_5)20%j!xZFSdXchyk4WR%{zoPJdy
z)NBoDxQ15F?2vq_PcqS8J=#+V=fbn5x#vwYu+4C+c5+ZWX{Z|M5svqXruu}FJ>{U~
z^(uz0fv&I5gB~D|aSc3zgb^XiLrGXs)hsNZ7RF2p$U_nW)3Lr;h(8hKfqCE*>h2is
zeLL#Oy@YVzl&Hr9)I+S7vyzMdbxJiq1iQ$EPkRanI~ZN6+{ylmu6nw*fgxrgso}S2
zI1j9kWAp>3q`+HjqF<ulCFos!Kil!tAbb1f>0iH({rN{f`0l>uN=DqHYI;m@@)H3y
zyn>2^mym<F<Y0aVnwuV6mKh4P1uVu(3uYzyG6)X~h+eFCUwX7RH!-9n!5<<WS$@|T
zK`!co_+-yZH&579P$P0sx7i8zWo*1w!8x~Q8|ba?EX_|?TLQ$u_L-XO-DKvl&2pcq
z*#USkw*c|Jea)Jk>w#>H5%||$(=|{Rv&+QH<;39#=O2l;&r>|k@o{%rn4y!h>?)FP
zW$HsU9j!<Uyu8!+{B9dNV@O4>*}cISz-6;`E#S)*xNCzkaLzx@Y%vTE_L;cA%R##O
zAIbvIE&KneYk<z?WlOgpE0)8>5va;+8RUDQ`Udz8l-if@44-B4<(H6Wv<G~dZ9HXd
zac+m@kG9*uH~zfe>XN;c*I9e7Q@fuy9*DSlDAV7G9qop_byNW%0pbHunm^ROs2DMg
zdC{HFJt!o%SETnU^Ly**Iz@K3BD-Hn2W$<tBP9k6&(K!#tXDMAT|PA+1!N8Dgp&rz
z^U=E5;kxJj(s5no1em^hQZJs=RZMj8ASm&F*?RA=Cey8JTsnj*O{58kfQYDw=-9@=
zj)>S15djgA5(0z{4?TnsLI@#*5JCtcKnS7tA|fIpB7^9t<2W-;Ic>i4&MEKtPM!B#
z51jM<{`p<keI7#&Aak+Yd*5rXz4puL#upPpQ1y!=wGUNgQ|%=aio)UMY$c!CB~0(+
zXGrp6nweBCBbHTgkC7Quo}N&Y5M7*opH2-UGVYe;#DnUBbe@<}l|dT(^N$bz`={yO
zen0T*Z-!niw|%+V{l!xEkgB>@T#$A9Bt7(4b>=NL{YG70w7e{-3?<hv_YXgee|)X@
z>z^0?`LB0>|L51QpQ*Yzv9;M@%IXw3J3#@)y^1Dd#UV^7Dlr_GvVJ*K@={ybscn@Y
z@?)Edq8o_PdyU0$jd`&xL>wnPkQ;SDM!(sfd3}Tz7wW(DPViCR&E|(~Hl5k-8nDCp
zn7x^wqb)FntVmY%j+=dLZ4bL_+hc9B-3(;+MsH9EXf~T#x*Bctgp9_>Y^S-gm$faV
zduX$y1s#$khgU_N?I@0(5@kJaD}UHXWIt2oFSg}R*JmHKH}$b|L~cc!2bC6{=r_BY
zli+eT2IqjHT@$Dw1JqhQkINyzwOQN1PS+5<ZhJk1CMde}ZFThVL|^egXI(S+Z&??x
z1&|?pA(U-1HzT~v%=|W4?XocOcXK$o-Ql#C<D~<h7Y=N@cXnSwfNy-j?v(Sstg!t9
z%v-X88-s#W1v93PPahKHOo_ASWQ9wrip8$Vd3EK|s9=78j9p8UB8cB`UOtq3{-}9*
zx(QX+%A@Ab=M*?APug&Ru+_)7DE59wtPa4I{hQDGKd$uu_!5?q9V^q~_fK2FbuEp7
zWEMUhsCwARm{1f?D@zBPa{3!`1|>zUWl8PaOffH=$Gp$Tj;bl97f>T}GotgdVgN2?
zZbA_)ihASJ>p3a5x?<|%``4X|Q@r`1YVwZI!5V7FS5;?-SV`@CA{$;fy!^Xak^ZIe
zS9tW>tc1%W&BSlNo%q{NQ@{JN`~Uvw#sB>4<GVQ(C;DVlNsOGG*v3hcvErr7`-oAf
zu8<+yI5ZURO^jF>Gp?1LfRu>W^#xIq;)Lc>suaS-yx59+!QA*ujkL@1<ly$q`)6Do
z&+PP$4hSSJ9zJm4fM1}GkDtwEToZTOSo+#+!U4*>%*}UOqOLOAVQ%S0G4eDscL(jD
zZ{loV3Vk0WSbH~F@7!d&-O}=;=eE3%Q*Al1-6e@5yv*r_f`t}FWA@dB&iqAX;UjV0
zrw$f-Y@JbSA=r?|089h<Vhe%d+|a;AM`yFHj*F=YT0RI{YtagM4|O}}R8wdLos1yQ
zF?KXCa)caOA7CU8UPEAk|7(jO)DaNW<4yfd+FAe?Ql+!0@m?F7BaZgIHs(iNY)*RG
z2kdbUJ8>ZHivOK6zKKBxs2BX=0*S)~p+_aTH}G$?lNF_8MvU+irp2k#Xj8WrJX4h~
zsL-S-`+TzI^GV^$Dao5BiWM;NlcLuoFIu<!py9)E&+4<TFBVnEiXT=7K7KL$;myG7
zg|;uBE5BY*V>ILA>wXMS{rI{Ej_q&e<sX)m?=g5h-wN7(^?`_31Sq=M2w@}5d6;rg
zH{_{B1#PwY?R6!hvQ&0XVnuFpA^m<X{Z3A5WDz}@nRbssi@I>Y?c3$fzy6<vAKrC;
z{Zjq`K18p&S7#*?%90TUA>+ohRnfWho0YWd6|`&O;uwBbbOkk}f*L$5%liAz3m;eH
zfBt6Rhc}(e#58BDDFcdc86&Z=_`akhPRdNcQ^8JYtw_efov@i1hYAdJn4AT0QF|q<
zKmGW6W?0V6j;zlN7t?NXZ=MrI9+xErNz-rLI_QCdeZQ-_zt5iC5IWhTHpgs(6(F_C
z+T7RP2Ef{FX|}@*sIuCziLmyvg1*n(6B-v2k~K${5A-=&eA_K7-7PG)o0)l0^ka|j
zlV`>%v+s81N6$$LUaQ$X<<U#3l4orNleL+jI+~$f<Y{dMKp}e}SmDZt*LDVaIMxVR
zI@+j_&`Vsq@{xjg@*wjWQ3xl{4&;|1^`Q<!CBOc}3*gfb)EB-6m&G+QAH<jjzAx})
zL(y~8)AhD6^|iM;>}-2-hr_wO+v0-H-3>Yx;qRMp?m*IogDF9uP|x|cl_WIgMzs}Q
z>tjca@a|8GQf69HAGZ-miBCFM%S0dJ-E7_KM=dYcDE4=AZC}o{e0VB`g67?V3^(oX
zzk$ok%&$I7etbLf?VI6mUJbokXn((~0=OWb{{dVC_P~LQz@X>zj;~j`zF25|yP$ZD
zcsEi1e6)79n>F9Z!Mx3IQ(jj?o|K>3(O9e&SBfjLs)&@TA|ksuom!N6FFQG+kRHvV
z$1-X6Qm=pZ?MnY&e|q`tO84)-g>=95H(!msU4WB}{P~nnB}o+(+(`>La`%*1e%SHM
zn@4%{@Vd-9M8t8Ji~I?@2Hy4j=AH7VH!Z(=*D@;0ObGOAt4wdL0DG0LV5iAhsU20B
z?d-JX(!|#CBtphYX=l+S%qT%YWT%j56&8Pd_w@I_|8Di!)M%S%q(#_W#i~vYDTwrs
z@b|Gb(6*-Nde~VV*y`xL*=nb?`5||gJ<hg}oqJoFp{hrE1cBvgZi4z9H8=<<H**tD
zYik4vCkmMKjayADoD9KEkbRsJp6(ZkJsyD`ww$PovXonO3Bi4=m}x;;N71bbQQ~4}
z(Qr-bAzLGmu%0&72vbO0h%h*)m+TGnNC}py5%5JSP}k-x)?^O|K`5fM0TfVL_+;?$
zYp4QSPl|EYpAZRdF*bBGA}II+ysE9fuBE1iD_9ehi<>uX+hp$RVvqkIUt5!NUe0HC
zxWrxwj5zyg{Dse`K}TZG_{AUhOg^`_ttg=>H%5{Z)W?Y)tiCrcNP4KCJ#No?s$$P|
zaF+W^SEsnhgy`&ii!sDm`FAf=Zyz@-j`6-;R(`dj{@r&o1Pb^MtNm}5y1srj_`}ze
zA6^c9{e0+$rLm98qrZDU`+q)6|M|NaP^jN5tKVUz<-FqkLhGyP#^o_o^)(MvWpjO1
z6N-{id9i|@F0H0_ii_I>#iH`GDuTu)(hAZNa#A9aW3MGeUBacYASR56y8Qjyx!-;F
zc6CNEt!6zUdbq!P{qU=$f%y@sT3py!m)TX5Js>KqriU@(F7eZERwjioVlQ%NS4XAU
zfByZ0Km9QL)2d==r1;~rh6gPL#Sww+oV1p5S~Cn7IB805W@|;NydtHQO_!D>ic8}K
zIZ=bHW!R1QdU;UYS^M$(<v;!XU;p^!mw)}wFMt1^fBoZMzx+b{^Os-#{?kvtdGp1q
zI$>>m>^)58Y}VI9S8tyqm{ALFYl|J`W>B5`Y_|5YfUMmN41}wx8JWWjbWz114WR-8
zs-O=A!XRHjy$@Atl>dP%yPfM3Z}Ou82O04XYSWhFC9@Jp;V|l#JzA4`*w)a;#)iOe
z99TgyzFvHT=0tB0*$W~+90#(qgG1I@IGeP!*D5HC1K}NLx}ZT_m(Z_aOK(l?MbX0-
z;yVCWnE62rw9?W*tix*uioTcaCbZiRIH7{HI^kh|p4j6S9dsh`%Gu~s`{U30-9F+;
zJGGO3&Zp}BrF!~pRpIp!Fc8eBM|CMrWa&>8Ige!-i^|;PzOt7S+%INjUp$tqPB(q?
zT=msL+wud^%UKC>-cR35{^rBPSIbylKLobxN36p6a_r+9?0K92)%VYS`flOJZyx>X
zo2g%YiG5&%{PkQt24Znu&tMT0XK{%2xS#oGfIHh?HKnQ;ZYgRPq<4!7rEGdLH&eu<
zv9e-`l<2JFJH^yUDjcT6f>|js;JKnM`~T`!U;Lk+KK}imfBeTk|Mts2VU|1hn-5c8
z%y-PFIn`NLA%YO(-VtO+<wc&&y7?J5B?O0HQ?CrkOTPLr`Rk9<KfND$_d@kzS~T0o
zY8OyDxO7EjioAjbDx!;@(OyMYaMR_SbSVJGPU7X<c{<a*yfppe5AXi)=imL|FF*hE
z*T4Mzmw){0Um&x7`O`oD{?~v0?O(tA?Z5x}U%&nR4}baFfBoy1|NB3`{Iam{c-t07
zCkqpA$4$7yxf3Y0O^ndz!<`O-ymgr;r~&{G;Bq!1qZTQcGO@r5dn6-@;qFc5{w~(n
zeO>C~Z!j(%Zl+#V<weX2(kE(CW@QCW#90ponaAvnd~I#KY#<{w1XLke08o&*&>#d9
z><n}P1yo56`h@;g6B9SHjkrwWxz@KvK?PyWdcjUA>HmG!z(rDB`nm{)I0#*cf#x8&
zDEegRva-N`1F3R!aX8>&eP)-7|8~2GQwNi;1<)=Y%e;In?c&kGkfQ~m$9RdDguOi_
zqK?+aqv>;RMw0%ZnZBSZo$q8k?_s?j;k}*`yr1v*>RB7Y*OyOQG5Y%YN$XD-BK~^f
z58uuF{_Ck9-;Dn1?HJlXA6GF33t!0T-@Tjt5sOh)R9`N2d|Xlf__7Tf3tvpsd@(C}
zF~M6JW-kp?E)G;pbd-!J83T&q$*zjQ))F~UlOpG&$=GQ!UOK<vUP<b00<{+X4v`R^
zaOF(;txE-ox6{LeAaDBDKY#n*KY#n*fBqUv3jXW2t8gCq@?{U|zlWVH86zqq<VeE#
zeMQj$jQc@6dKmCkm3+M+@2<Gy&WGi(H&6S&T<QAhSF>L&b&Yp0o{rV1>oQx|iK<!x
zoJeM`5I5KKc7Ar7AXi#Jm$DP#X@e~Ix4-@V4}bja$k@PNu<+uyzkc)T^FRIh=fD2r
zZ-4mXfBp9#zyIS;q^I1s?;rgPSKsee{`Jql{{5f-SXo@yVq)xOX6RuK@(PzZGZ!Oc
zTmT^<c7e(hVi-h%jV5bB#TfTC!a*OnGbIzF3GRJnKAX*hyj^bixmJb;rhU4d8~SN&
zxPM35l|km+fy%^1an2)t<{20BeYRF0%Shd*v5}jZDN-GhqO*w+z-4csV-I|h;L^ht
z5*JByg>Zl^XJZmuWM!{!>_FD>hW5nTqy{+<3$3aF39j|X1$^OqA#x#p0ccLfMxGnZ
zd^TAgc6B`9V)NM!2Y)a7u+My>&m2s>^l5(Rse+rQxCs}Uaw8gZBbBV=`L@EPZpN5|
z{<yPXT$T?~{;|4Zp}%^0Lj3Z9<jZ-i(^afYi@tk7sDE4?`0iC7Myo%(P<{Qm`u+1x
z{E~29&nwUm`h2GO>m~KOImP=q#a9cmuNI^qpUW_rz4EYjbw;p^1pBb&)o9&pXZfrO
z)9Ly0>Wl{Fz3#@0fo4J_E|jpSf`S-PIjy=NrZnwNUP@GUauhQ;I_{!>;?<MMH_sC}
zcdzn`lK%mtzz_4wv+du%dHC(C@psFeYRr4}aGnnflvVLP{9F+clN){lm|`Ye;$=s0
z=r^iUt|-~@({<VNa>nvh{hxk%`t54>;)LMcA{y*nOQYf;SxKiLONOewJVDM*kua&^
zvN(BJ!lYXG^WT2^!|%WQ?uReLM1A!i|M16*``1OBe5rt`5Lef82yRg(w;+dKm?thR
zfJv;Ngb=eCiaOrIzMk7b=e;*u15@sn7ETnS9UHA&O;B7JI+LX`nXB-dMm{5d#|DPz
z%-{uCJR@OJC_79k{*IQHcR27OF65ou%@02#iYCsouYb~C6xqXw8Z3-dW`+AZnCykd
zaJ@zSA9@S;!uKTu7Qz-XuRe|*{$hkIU=|0k!U4p{V@T=+5vkDbaWNrd8V<srExrW2
zt~tUe?w|MsBu`y*AoW1@yBHbz*jj-{J?8Edu*c(^&$b&!cgF=C%esEDBs_q5C%8KP
zQbWcqX<n3)kucLhOg9k2f{gigG-TLMdU<fuTA6BoJKOPg7W9<t-Fyq^hqsT>z>$1>
z4eO5Xua|q@Jneop+x_OL^3_}$o*!R=dQg8PR(ii(?OlB$fBm%e!*b`Fg%)TtS0?x?
z6E$-^jA>=T%4GdAn9kvvnV!nAw%loT#iO2@hdtF}iVBq=TU>HqQbrRN+^@=v&5XH`
z9d|1~;YL*8{_N=Bte7iA{N;?OlV3clUmW6(D{|)tDj&jGptq>Ip4!Pzga!t)qxV?U
zYX#APB{6}e_s(P7kCS+Xoe(T%-<PxR&ZtZKnlmT5iU*pr)j}Hjo2!$J&mYTI!Na}k
zf49>6{<Zqevhw+qc(#{2rmj$l=%OOHxSalO^@)Iy(JdFh{`~dDLwngdsl}NzX+5`5
zS}mw$%cWv@Q-f68z^!Bw;yR8@#Ay()g@Ous6Th{Q<Fy$s3??qd2w`aZ;g_fHy3yFp
z!W1>Piz$9>P<NsP2Wv@!3r}0z&&<rW>TB;c)4#UUDgXT8jH8}q!G}a)C#APfkEGum
zNWV5(aI-f*@`#<Ww}azud)sw_i@YTe=H^>Tg`fd2<xHU<Q3Aboh+Jm)rl`OuE~e<|
zkogy*90*h3xz_%Avf~2~krx6AaHL~rpyO<6h^S?w`yU2^jJ1X~`XDxp+%1fK?5+H^
zSnhW)yX50~`|!@VfKQ0f6XlUaKxOm=9`&3!^LkTmcry{%S9Yhb;@)_D+G9lt%n;`L
zYM%7htV~IlCnTRwG%k$^-^|Gn#h@mA@t|&XUij`s!<)s1*YlFMn0Q@KzF$&*z1;I2
zY{ZiKyVd^Rd^z$KV>qk5@QV0mwHL0nua}kIyc<}CpWGby3_0=cX)D-_m(vZeABh)+
z>gR`>A@&(>XSWM78_VK2^jn;)NKW?s^q7!@+n3U#E>J`K^J0QA%wLjpo1Jp))lkKY
z9`;fX;}s^p)urR&lu1c)XGL@uJ3(0ySD$wm1Qe2Cb?S|h`+=;uV7SC}L#)iBE(~$O
z1;2#O7E+I4Nyd;Q3n6xCMz%aFfBRhZ66<51bi7{ZTz;Z>yMq2g&zqH=Uw?SW&5gm@
znczbQ+|4bnojLAjZ$7OQNx6iSU)a?uXqVKq2sjF1l~h>XBCHg#OWSLC9RglQy`Wnn
zlCVqeUyF3mF>*KC=x%AYg`)3dOi(~Wx?7nesyLe>1L@-u2YLXoT35f=AW%>!0lRmc
z*=Bonhf~H0U#hQj?up&iH;(Z`{5#@;`_e9s<X%&xUiG!m^|XcPYtve=B2%KHp5B(V
z+G{KFq#>|{@2PL2tGyW#EwmU7)))xfAIL)?6CxB5fE8|xxC=mPvvzcFSF{J;fHosV
zA76&XBR*%n{<qN9a9bPx*==umz}fPwx0An%MdXp4v1k1<E+1ippW@yNu8Io~q+F5`
z;j;XQ&VukhcHD$GcSgaO?_tfUnV10MVEgLQIPcBlCg}WDr=<(S{4bv<K7QWy&1%QH
z#nvCb=>73cKiWF)mpZ{}VSfdlU>&dn?z@#<kfz^%-t#4ts4x3b=YO@>_imy4#Z=1|
zbIRpu$+Ho`+gT|%uB8#-lR?f@FKbNAe%J@s=28WpUPTY9pb|IAsS(7zu()dh^jqf(
zW3Cc+FcNz)E9z2xcIX!)MJq#?UL#(Qmc1EgEp+A2wdM`iB=?lZDT|`2Qg5P|&yPHf
zz*P`=MqQUzl^fp5p-!sUpHDTtn}ZHW`Nd<!lfmlx@~D+L>C%k!&7yMUiG1OKc&eug
z>a@4>a^j0elKGyh`CiU+d%m<R^xb61f2~S>wK@=R^l-3`TVo*|KVKt*KG`Lh?UU9O
z(PWjG$~va1p4lZVRn-+W6eTs5Wh(jbSYnGfxgHiqkU)8Eb^vJv3^^H_I2anil)=H!
z(9VFeNt=|upofgWg<8lGU1Bhxdp4P$akIU$eM?F3XSx1+h?73Tu;YrD%j%?Sii8u2
z!~j{+r32Om7`gVcv0nS#qv=dRF^@~*S`yO(Y_}Luki%?odxXw!O$`C^3e9LVnYLS@
zR<m?9wLsg+$=Cn{nWLee6N-0ebhHVGP5~}sz}_6{W^}d5rlKBtMOGw_s_SLF(S0Mu
zXOqb%4&YHOLk@Y~JNF6o{DHjdpB0Cn5vGI-Q$riG!$lb(irmnFs>D%Y+9O2~W~=5f
zMm7o^GYf8%Zy$@_&9}arYke~#eGPf(i_RZNR(t^4!wDek-C_qsTpw5a@G-eskTf>~
zl-j>tQhzZk2fjXjj#VZDAD7|DA$&H>U!D-6sra~;^Q50U*T<RZszCF4tewC@5{v<&
z>%z;r#i8BeB!!m3n=9%{^yO33%l>#>aQ8~)t-zG4CwQ4*Py0*e)y0nqW$vu90Iw#R
zlSjq$A*c>(Qbrr{l$`X^`xjBqr(Qk8jJ?#w&unHVD!8fW4wlkGh`95Tg76kr3_bGG
zIs7z_WlOWoEAt9GU!p<vtaIs6Gk~^An)39$n#UctWm=s0q5IAU)x9_Utep-vaTiXN
z$46Bp6L*IdytbO`{w8KCH*ct!+b3o!1!Zb6b4?gl@<1i*6LXaO3WYHL`e*xHDEOsX
zJDQo=VU)(mWD9B=W7G8tXS256+OLlkC_rpwx~7-fW4-a1y?N+PC;DeTS;xGyKJ~1<
zeoS)flq~9m{Jy{J-U&hy7xal01&S~51K<r1o=}6YRd5J`04h{~`bfdJjM``c7NpJw
z$_R28*34v^#m4QMtZ=q&G{uMO2h}=01aU$BG@3e_AQRkxqlE$=!Y)KrAaskq=~gpS
zA1B*S2v?_1oNPXIwK?Ho8-Bts>Xcu^;T<u@yb?}%r=CAR3-DpZ1hC@*S~5dMxwMfQ
z`kcJvu@df7c?<o_`5xv%fBDO4(cAgf4+|Y{Ag_6jrAvJ%=Yb*M3#{db7hNBg)v!qd
z!hZTN{+suszj+5kneHD~dp<07{J2V}k^Md{cVHv$$^*f(;R^UmJR7PZORfPPfHv31
zo$V@n*j_XxD^PI~T1%pZV5Q=&v1vDpVy|an3(>8M;m3U#@u5Yr*J6VXNBHmR<Y&Y3
z3U}6(DcR=_;HXg8(-5b`E|ta<RUNgzF;mV;X468l!%vjl3nYqS0>@g))D2jwoG?Ek
zdN|Ph^T+2;`Y;#*hcHf`qUhO-<k5)m`C4LJn3AkKZbb`g@p0Sga^Lb&@3UvUkH$ob
z!qY4A+aJ2_^e}I@n;I6yMpRHqPyf08)`2Fby1sO-PclCsn`{>>3@OIjYe(d)X%$~B
zEKw76ObH{KR|?X4=N3dI19N*5BZLHC3bS16tP`F#Isg|bafeL<^q#gx81tfdm>3+j
zH4k*LPB^qP|BPSeF)#MTLz0L9S=1@%ozLX4C#CTh4%tw)Sy%vDKo#J%hOIRM6~(xj
znTrWwj9|1DiAYHel+FMb97^y7pcH^F9P;{SVgyX#9oz}=!d71&!3sae8q~G%lR2B2
zZ`K1y$-X+8QhS{ob~#ud@z{FW+bzHwN-ne&y)OB=-8#5E*58|Y#)r7>UmAX@_||6x
zBl5GZ!rOgiF%RoA7Uac`T5~bEKG#)>;fbd(Egj;|^jAL}5unC>IV<~e5p_Epw|a0t
z#O3gd`L=h9?H`uAKziZ%?aSUDzv%t;^R|zlw|}$T{&rsS`BW`jD&IqLHOXBbtHl1d
z7bEQFV7R)AW;%&!W$qNwo-rm(85B~xYLl9ZBkHols-TZa4J(cdDU7+99(F1E?16IX
zEgag_6Ge9~3rpgE`g#O1vR8AmS5IVUDd7eJGIpwiIn_}<Br8(a=46JSEQ&qPPPv{H
zaYD{b=N3e_3epy*nwx6lN7N<LeS+d-Xz?#T9;urdCIrim+n~akpO7p)YJKrYzA)Xg
z_(Zw5(6zGAzw&Hsx?kE`8TDS7@>~>Aa{K7^%?{1%OeXbOPSn|ls=85mb-$#dS6u#3
zRX?K^Pbh^$GR}-rFy6xL6);96oGN;BFE2kP_>?u0jj4qVm`+_icMB`P3y}bLB9I>~
zw6#q(Y%txRu~Adg65<$LLk|n<Lt7kAZ*#chx#gypQ(@52xP8v7%ZK?PC&b~WB#|d1
zQJ>XDp4e}xj|$!0$^s+-kg-Vz`ag7XaPcE+bHpxS3m>AgB9RNYXkd893}9NPM)8F%
zgqaBlhjoZqYip9UgQ<xz`O|E`PlIEop<#_{22!U9z-8*S$-)nVOJE^f9RRMNy&f0$
zxgT}40l1<*^}c_6SK{g2^uPo8*FG)2@hSK2nJHd^lDP3mNPpUt`$(2G-JA&*&cy*3
zdx)?xb9I)GznB)kTU0@Gx{ChvBRQULo_3&;{|dCjA}X*Bl9X6d0(5T{WWRZ<hX2&J
zD~eyeQo=*_{bSM62p1MNucvAkddo1{_<XQpR#i0KlGQD^KdZ`{RAlwk(|YQXWJTe^
ztea)DtEJTI1u<8%!>`aT1w@_pBM`aLZw6$9oughpURRRv^S7g4FRMSFZp5TTw}{?Y
zbVpWxPmmWXXT^?4a)rgQMRCF668Lgn%!v-18<2Kj4?}C&SXbpF>dDdCN23jM<I?9d
zit%3l+(Z-X%gHk>$2*HNilxWx&u3vECkMj5T%HI#dGrPmcqlL7cIZ*x9Z>bTc|pg>
zqJ<<}JUAqU^0j76&R5qnIt9fr0DPbpjmWt}4eUMvvrouqV`YknxK>7LS;{>#EiH3x
zinYETS}|Z7>>ye<G$w~>jEpUGbbu`kZkcIoTaY3>6i#{v9UV`&*q`@sj6F>3VqQBH
zz1y)cXn#ZGd2x7v;(l;@LZCE0=<sHWlPQAN#?5*<D7}FUWI_^C6f%AxLvAr5v1YG_
zghrC3)|!CWzu8eh45-3c#~Of!vdThpgC($OW`dD2V@(aph7E=rHV}rIS{t>sx0rz9
z((|x1+T&=u&&Bbuhtrwe9ygEqUh?zs_prZmz$0}3wuDnY38!|ap4(3k@FgxDsJ?S*
zN)W3mzWPv@FxQy8(2@PLvjF}!tLXU5w5-lF&yNU~A2gBPfKS^Or!X{6YEU7bfA@?G
zVqhIUzUupqc!j!s=+|Ekf3u|g;iVj!<Cimn&!?+bAM!z)VyN-;L)7r~$ciB5vH5;X
zmOd&?!T9N{ig?hL)h9~ou1%COB5Sil%MyYLV=fR;m-3@RQbU5G&iK)909fafub)V~
zbWF-gTY22@c&KVh%^Xvfj<yv|ca`>u2;2peL<Ql3oDg2-?K&a`6R1Q?P<=_9T3k}g
zh@R{gJm}*;9H^P<<BoT6XGg{3JvA?8+g2A;a}&}hlg)@%&mSq~XXH<3T5+Bre9d(|
zo#`7>)gN@;SV*ImrX*iGa^%J*``c^s*crErsn-XZD@S0q-_xMP1jvM<wx_AGzqw+f
zoj<FRwsZ2P<h;=)j+~X*#mR?JVBpas76t~EkPairphc{MTcU}LHVG~>U2S6xfNO)9
zmZmwW$1}Fkr8racj=R`i_HvEd>zR4>V8nLYoD<$<K?g<Qr^OMUiEkZ~!~}h2i=vHW
zI;{vz4PXjH0ccZT3Y{L%3kY5~PywRBgUDs2iNv@8+IU+n9edch>EP!e$1=8>!U1mM
z&ds(EP*`rzFx#-fOjFZbTYICH7GB^OYHMM3(b3Gr-D=}5TT5Rj+x<><$KYz?<$7kP
z8~)K<@Fm=Wyd6XQTp|v+#`<qhIlVjns7Lyloh4WIjq{?%s-tHclD<$EEq9eHsTr@w
z>)uQ^y?u;*1k&dZnx0QJLU+0}CBX}FEMva?%f&9xS|48YykG7A>eaxT&$~Z<Ir{b6
zkv9t<<Dtmme)+87%@e`OH22vE`{h&(rmqPg>*+xG!T=La5r|fU5?Uw!-n24%OrECV
z$F;HVVz{h6{YF{DY0T;8-#$Y`1;t)E5_-ZfCfGkI^mOdygDK&kbvG3u^L||JgAL}B
z;p(yWys=jLU?Y4lQxp|3?d*H?xpBPosFWN2+0lV*f}-~NLJ5yHHBdWFba5xTIS=}(
zAM^rcwU0;YXNRFHlsuYfo_iplos_LVXU3(oQ?mIP#p9{g#mA~~HGj92`Q3}BI7BLs
zk;yKgvgo&{A)hu?rcMutN80%lD#5UV^LRk?WKaxC>WTKMDJ(0JbFmhwN5WExnUd^8
zX$hU1NhH#4T;FPDY^tkcqN}&r&~THHiKV`QC52+Bt7)jYfuga&NOOa!u9mr`zPXOR
zx%LLINTEBn(hl#dzH=jXpBMf39_Gd4<>wBG!^o^Cy?5T<(r7nkdyG(kZ}_+RT_1Nk
z)bb=}hGe*=jVE=c01bhv3&?_4%SsEA)7q9u!2l5ur>VI~R~MH~TWusz3g%t`B~vXe
z6HLNx*nnd}(cNNhhW8yPhEQT-hWmh%{ZV(PPd(kv`0Nb*^uP^2uPfe;5&PZl9dwKK
z+d@0)Nj>P6ddxlNjOReb?MZ&@jF9>{(U$kL4Qp5#uP5r>%t&6%w7h)OvOLrLIqKc%
zrstF5XXB!mj}XE-Kxlot(g$+u%hf)dH_P20UJtG=b*;|9aaXYVko$g7{O)Pp>I?+;
zRWNUSHc~m=RW#ef0JdNvGo{EH5L5f=6CNlshQvuKUaXvRS6W8g;nS}bN1QB+3}8fG
zDvi6D5*8R8bS&Z8S=!CB(ZL6@;{tmc^1okde=%DB>Ou3;kN|GukCX)?QhFOZT3Qm`
z!njkN8qtswiwWg=2DMLKRi1ZySjirR`B8i2PzP&VT{WTRP4(7Jbk{r{70(Qb9zRgb
zP6AtUfQcagm~5RHlTD9ecZ_K6L9<%M*lA^Xe8)C+4!tlfuC<{;QOzo*-mNRiX%kkr
z^2)o#)iO>&pQLiERWK~$Ppc$@vTC)Us8__m=@u4C*fB~`M!T?(n@wk@&^+uM^fh%%
zQNrs{%wgQ1r;lVv0k$+Z7!q0=O!c%)G_{S9L$x-zo9dmgrd)NlP7gR#c*#G>&qWv!
z#JPFAE#vB7S(G&O8i<HpHs;>;ws!g$p(Z6)NQOv&BoC`gK|=|Oz)hO)2Gqs%57=5a
z-9qgJ7?D>&4J|xzEwq9;rG}QBE<s*nZ4D^kLaZQQ)zd>VL^?Oq)!c5k3AX@rCw*+~
z4sCUI(%1Dgr|dM<_ug#j@9i19&-aL<jjx5#x$X9sytjmSI)?3bN%Y?xcgzFe8mo?(
z;KjaZ&3!1#T<T+z+X`kyFDC^rri6==;^isX(^28VSpCwJm;lONJ&~i#BE?#3Jn6gV
z$~Oz`U$1n7k_XxP)iW`+_@deKe7q9KS{&m7T#I9z`9aoGWW|2w6IJ2E)~w+M>QG%m
zzaVx<m@rVA(9VdEA*-ccD+)isxO+A~G5{vK^ss<CfrsO-oQw!K6dQajDJ(!rlu%*y
zJJFmz3E3GeOeA!qSJ-|H2$NM+iOogPENU?GZeZrk(=fvsQF8cY5h&pMTT7peN?<`U
zqGV6?)Q<MlJ{)bt@{XBN$=sw2=9aS)via#&`1DSXN+t$H{i<rnS%=hog{W|^qotpV
zbrZXAy0b~fB66gH{HE%x(KcS6lrtdV3`u#Mj5vNyQgK3fJC7l+E>;K%u(L&2LT#<i
z6%-}ZGH5OQVqShq87)Fsm@Z-F9{2IwsI5amgwWA8*Vi@H(L%^F)F6+MriQVGmYJ5e
zy|(sIJDbqmyW>7N5WaUucEGVP&&`GBj}Z+qR~uu4Mi?=Q%m`mgT`ybf{oA%~GvByY
zY>`U%H7OQ^4J7Zr#!QiLLpg=uMQW5$+-Yi>l1B^Gl_h8_Ep1#Pto8IwH4w_ckWo+%
z+EENQBm6<qWn#A3$Y`s@#!cFqj`~_YguUgS&E|((><&2DoZsiW)zbW|pVuij+vouQ
z!%jAre79ZP;}m~*N0gsy>=C!@OZ)oRw<l`uP4Z%w<vAdZR<JT>8kG|KM7T?1HH#B<
z^J9W1L%fAi-r__p1n@5&ieEmKzF$HWulnLi3r1ZbkB18I-J<f%)8<!?2&kBONQH=2
zOXJ+tM|G&TR;Fqe$Jn#|rH{J`aT%Rxq>l)xqxFgH%up3OqK6yX&WMuahE~R1C<;Hx
zx_^NYb2%&QeEO}R*o&XVUh<C$Je+X#WK8g9;xg)@x(LJIGwr!O+`D}>F=~EvpCDe&
zifU!vEss50PlON{%gK%iYGP-$H)MjB?UR?PrNsknj8SFzL{If-uVAdFcC1G*HBdi2
z)bL<Xgfl%PUVky(D;!bR&Wwl$Ra_idZRT#fjYqxg>lqm`R&EEUpi5fPFJtyeN(aOx
zV~vb{VTp=g)ZbV+A;aQ8-cU2Aj}S2)C~Aiq+2b<a!}dD3u=Wbe1{x|Jwuz=yqS?+S
zW*XH<TgOn}#7viBp{r*~*3KJHJ0o}*XlyW8D|Ku%HM~uX{Oz4??b{u;+oL=zB+AD<
z<(M}&EI=3&pvnzvO%L<ksO@d*fblf+en6i>6k!LImOepo)HAkUn<GOFkF(xWA}@=u
z2-F~}C{qm$Tp{oR__ET|LxF`$1>VH5F+jWf-yRaU&w|t4YH8_dW8>>&=Vneh?7GR@
z+SqHOk+-?gF?VN39}hWgI&5#88Ftafl5)u2^0=D~5wXub#M?gM1n924W8A1&5p{wW
zgDJShp3;@^s)a#NTxCmx%*Bz4C!_4g<CP2J+-H+mrc(86O0e_*Q;U+f3$1U^#F>*}
z$`#{c5So5T_OKPp(|klN>@rxHu7$kj`Be4%5NocViF`QU2mZfgMgjhzIb%db8?1}(
z<=-8wi|b@Zw=yDSg|`K%Ayx60IEj~w?gXcW1i+;dkt_QAk+kq2>h;r+0S6Tv`h0uA
zNF%+Cd8?0iuZ?vJHf;k!s<Jw+nQ=#$8Olxyu1>vq+uysPIAy4V(J9Ft>L}}1lnyA$
zhuh0XySPJLHN)5dHr&M<QS;Xz)-cg0n(P-1D7k8^@laJOn@f8XESy0luem1MYm>3J
z6(#rHO&&q5&Wh%xL3kJ?CGLwe?=<J!713|;lS69hHze72YU#J?Gww8H->XT!U6UMM
zn;Kc2bc;_9<)>a3Wrd5fq7;R3ic&fit5ePOw9QQ|Ec8vxwMlRxa*^QDAn}DF2erMa
z=7#O|Hf9F8hixpww!5&xgA+dS$_+SBe)VMGc^^^CSx)$AA0y4Zn>Rx$ztt47d1D9<
z9YCTQ7&-u3dSs7sU39wMQd)nFVMRb{Bk`YFoxGy1747SY1GqMm6b5<LSvY*L(?+zf
z%>k~hrUt(DW{6turW7Ar3%HAUTbthvIB{;LBlXhh>-)U|w>tzOEAHP3F-O=D@8G@8
zQ#JReYU3U^r$6h+TkT`7^s}F<nb?5IKw-bs!<<tWzM8IH8RaYtl)ZrU));?rOt3m5
z!Flzl>E$EbBPEDm0M~2K_zSXE^9`#IZaw5LOjIpR*DOv|KON&d9by5kPu0bbI`gO7
za>ts}$E5TQZd6NoXj|p&9zjCCFh#+<E6Tc6op^<L?>yt)Wdd78({7!Q2|5~o<perF
zc!r)n(7~opaHEw)7aNIyc6KOYmVy~IP!BEE-2q`{JB!LMiY4MM=Eh!ZuFmZcm119V
zzr3=ixqP6NJ>7$KXqAI1-e@;}NX5f)NJOyycHWSZj}6MBYN4`;)!WAEYiACsIQ@i@
zGo}`c*ctBTMqZBQ(bocn1ht2m1ieLVW&|e7FjFQ>kLIO>*QSLx<ld>x2&;oBcE)W%
zN*FKUx_}lcpxxwCLj<&I7zBc9j-Pl_Knt(SPIa@kF)=bUGcmH%Hw8O^OlYE|0fd?A
zuGL;^{L&^3LNhin$llxn9Mfmpw$l6$#_n-WJmgsrbc`Q<oEa7n=C@<FIRwrwyX<Vq
z?j){rP?nmKmXoNr$hvARYC$v&k<XfN3zIwKm^BDD#4B6{5wCF8gBVGLtc5aQ%T^D!
zO(WueDPDlf-P+2}1v@y*y{%35*jl-p895spcx{5+lle(6j|)B?p+|f|4|s*{+ZN-$
zEB5%F@K4+#k9sCwI55Regu&ZXQ^rC!V@_Q@(^WRBW<JH_em{3<xO%>i2_@=_QTEe;
zvc)0J>U86)nWi_7vAtaKhIouRpBxrj4_+@HHLrn7{Okb_GZRn8InSqS=EphDrmCL|
zFoCHFaVkphDMj`pRRPXmV^UY`-7y(`NRo=30xE8TIOle4atJ5k5<BrmMra@{<P0_B
zOyadu>9;Q=Tsw8`gs&hkt{$`D1A^au{p9<1#Q5uZnUo!&;>D>2$=$VSDozSWC~kIC
zbdX;QH%BQdQArrx&Ddtk9B8c?LuhJd^mT9muKo@VVi(R(XWe8UxsPvlv=ygcS<$B~
z>sByTGDfe0UqX-aurS=Q$<)t%i>M?;PJ}lX-WO#@in5~w>EQ(aKwuK2->ORw$1MWG
z8p4bSae728EwnuP0w?YYH~y+1<w{*DiLb_tXi-XZ*wKS9yTYB&%!Fd5V`QdDg3DM-
zgN$988}v7ji4pIB!t~s1n|}F{tDcd+i)&FxP|=zF35PrxSI!C}P6}ghT=RBwCs0<K
zK)YuNW}X}ZgN+DDMS-0)0q2iU1$?cG@&Od!3sDH*`d^aae_sG!2wdwxvm$vmkgz1a
z@FjRUn3%Yjn;mlB>gQs6c&nW=MHj;X+pNrX+Y=Dxn;do98tm(J!N>jbE|(j7oNxI$
zMIG5r3p_vz+@BDz?^y?HrLSgr&6MrwAUYUzi(?J19?4&fOVFK}?kGg;dZaE~9zz$m
z9JKv>AAnW`ORWzJ?awELOH)FOMnD*~JYE0#N#pX2;Kf7UB2p;uIL;xKX9X{&c@xT<
zQCZqpQ_2HH)}%aRT9J*KslT48<VBCmGGLz6%}Z5s68UM@c?nm_p_RECoOJa>#_dbk
z4oka9>I7qg4&Od;pokV)5P$9U{LtV2^6~dSfA!smM;J*{^5S7XQ=56SvE*(!{Z>NA
zr-?U@%Xt`r%vTZO5@lmiS5ry1tPB^w7D0{@4kPWH77@{kt%{N&77-g8da5-24wsQ!
zLXT0)%EtSuhPpW_Ib%dE$fI8MMBuW4!b-O~=e~-WAT5fMl_Ydlrb!B76--)Nd5Wxr
zDkfsvD`<EjCE`>pT1#QPyePgQE3&PWNa*5Z$_wxFlP(GA(fs5ncO!i}ioT_xuBnc$
zsW!z#Th~OJL>9ORAWIjdrG|#SrnWXY4W^lY;i|KyrjM;n!Vy2#rDJjXJcx6LIAQ**
zuyX;f*50NRPk4Z@O+>G=TDa?hpGBFp7Pa(XxJ9^{S)dUFjI1X*@-~Q8qoE;ggSe%d
zYm!+Ku!7Yf!WlBM6<Uy*q&Wn>1wI*HXotaCGm~BRn|9impWMCUGf#In6C=N^_I^%w
zuEqvFn=FF&cwXA$8RY30e$YMa;I^ov9^nUFZ|-+a3iJ~b*<teHXa(b5FE>S6ct_5N
zl@>*}RU~w95_^SdJtBIKI2CKV`ox*TQh2Zzc8lp~IZr8BU(B{HkHa0c3J2Yt)hWTt
zDgM$3=fzm%!ch6MLFV&;^5=bJ3%v~N2k5O&7?RLNMaj4s4%H=+6}{m8s3>zlNaU)x
zYc^M$xJKeuWo%Gs)Y+`i6Uo<3^0E_!`LXoSQ+Ln$M;t#Gand`VdcLtDc5bR+{z22T
zY58C~LnWbgHKvSq6weLuCsnM-z$57q7mAZZ>zULpNq(D{P&DFMsBA9jkQTQ$70E=o
z3Ng`Ap9?EEob-h2#33&iKUa4jr=5G9oc6kG4m{`?jSceA*KP(J@!#pN$I8gV#=_Rr
zfLluMhDnRKsE3!)Uz^=onWE;VV|1gVBBh6yJu0o}78G>X=3vpxU=t=Wi+dY#y6ZFB
zcm)$ptiIZeiDq_o%q<H&T}u-)GYVy+o(^DyyP_$f3u846GG=Yqpttrk*3hNs7~q}o
z!@KM?H|(<B7`}UR<&|Uf!#fzkM_TD2oTzJuZOx#~hjbq3!QdA>=GVr*$O0Uh5Wxq0
z7QnUD#C#1~DC$YV9?A#U<~SRg;B3}{fsK}>HlafjT5E+DJl?Ef`K$pl?BCWmfS9AM
z_BInE*biWWd#}B-kFDiF7aLgOAKYSh!pp-+UwfCOQNV83u){kqdTmD30<1#)oI-qo
zHCMQF%Zs9=xwqv+l$Z#EtC_ecLdv+KWXBDOGU4i>u1|#(d*)zM`nVi}g=vG5jM0|7
z2TBIo&(FrH7Dg+dj<Dy4*$ZRrhdsqJy(P1KB@cRwW_pWfdy1yobEf6#BNAAs#SAwm
zO-Yl-8>x7XHY5zxMD@W-unN<E5o*%%Dpr_zqxkm8lE^dAGL+m8Vbbofl0(wNPDK-^
zKa2D~9CP--!jN!U$(ZS_d^}M3q^A-KpJw{-A#1dg2`&!iG{Pb*sLLr$4R5SSk@M+o
z;=C47P6H(JjRgap990XWQ&uXg%Wf6rH48E&HS|_F_x$nw$98%h^W5#{wq>siT4o+Q
zEFE@2BxP&sZDR+)rI!tXrAsEQHB6N-ua!lWGUD1RljY@!3T9$ED@nnmB7}8u)A|L3
zikmwqWQ~Z~BjO5Gb^btoX=8D!B>SG4No}vls7#Nyf;W+gk(Is<Sa~C@4cLIOR?cez
zSOAmW1`PwU=b~$%O`&LL1^c;rSz=#>IdR+9zAE%&w!e4r`TdpQ$5|04_nK+$wls&;
zDHMO}^R0jq$($O%GYMnX&}d=G6|z=1P@?zqZzUi}h9S{mOvBI^)^0W+x^(r-bajlh
zG*NPqe5ocmnT@YSO2oyIe4($mjW99ZV`m4J%ZXy*ZEdz^lgTlUt%scKk8E?ga9~gH
zz8#kidSmqI&N1(heXi6%Kg6v2C%nV_oRrv#Qgo+-dB3wFp`Cf31X@9)vLe2RmpW9R
zi9$$Gc^5v7s%lziHHKrLAx`cSru2$v&j-sNsR(StTj(!Y93sk=$6(S-JXDfrx{ZLj
z=z|X8VQ0ZaYr%vZn*s8M8Z-Na^j-n!#MM`qiX&&o$jf7z3hu~C?$zalRlpfHG7wp@
zBK{h{Rh}H35pgyrDkwATYUIg-F@b)hh83x~Js(p%<1Iw5FkMwe>#9zDHq?L#NJ(ub
zoWx^!d9f_KD2Qw3q&IQXr8VhtK~^(AOD4#c@Y3aVxvj!{2`{6rf+nn>)t9C0-eR$L
zyPKE0*Pg9TURxYIo$NhbY`t9^JRGguZEZd6Ox$cO?M*2BqO@sswVIcW(_5P-XTs<?
zcR-LYElL;?6b%JRSZZN@SA79`L6hymq2?-;kTKFyrQl_%E8vJ-)L+jixgTw=r(<qx
zWI@q0*VjWP1jJ0V^$<2F8#IlyP|xe=Z_w1<p#6&mv2nwOV@{6ec5ZhwqJ(0&X0LPZ
zDW6zh$4Ebi08gi#urD!(-zk~xfB-z#5+kV<1H2G;5W66b$J_@RK=_2UB8nXTf!5j?
z4)ywmn<1&u(gDw9O`#x1;@SvoAx%R5gZDAfPfj!98=1qw#J~VVEfOP4$v<&&bkfm2
z42Isr`H-vQDX(q8KJK@V9|}9X=ZK?O^r?e!0ef#9bdB-%Libw5jO$?BgJ4iz7=@=a
zFC6+oWm)V1KYb9Z1o`w%ZgNizy_cUhD1>!(c7J{PU_;s*L{xGjeMXh@s4I7_Cx2m}
z_(^ZUWLw6JDi>;pna=!Y1LRiL>GtCB=3H3T4mPA?Sx!$)Dm+BnS#c^3wUrqoEsn&H
zH$VLnvau*PrY8AT*`2eDI{^q>WeGQn;=>DKgJ>Zq5-*%f2tE~kW-n$s;CMJ9O@r&s
zLluWuoD{wJu=w@&i*H^(Xb|M~byxF>W9u1-@z*~EJ>OKB(OR3^TA$lgn=XMfjWAm-
z%$4%<8mn`}m@eX^H&mrHmC<%@G2iLp?CrK=x3jaivy+#Tqr2l~FGq*%j`mw@Oq?8z
zTsK?7?X0nqnCN6<><q(aIC2a#65MoUc}f>MeOy{T)6RR)Q;SuIqb<DYPNAx<WUQ5^
zs3xQp)WN#!VfcM<b4n8KleChtvAGejrHjCYsAZz9Z=|V1*#O&7UA!>R(AM0brHO>8
ztL^XRam>m7=6>%GU(cLN{@KTUr3qJC3X*)RO+BovoQ(-HcLU5HQk<}1g(MG1dVLLL
z|Mo~Cp#<I7nsqKvvJOMM3H0Ih`e?t^8n|$QMCoM=QJ@woE>cv8@C7`AQ#D3Y9fSP(
zI$QL$w_BQAIOrSVf7spJ_!B2PVn1A=TpiB3+g<hb3i5V6zSZXLiNn#Syzd_0nQ+E8
z;e-#OR#V=sE<`OxOfwPDQV`Xc9VW|<9H>oEapF3;2}*84XH`-+KXsr!b4Zju)Q~+S
z&K#Fz&#DU7!8F%X@Te;fLF-8mjJAtm@r*5Bi$i7ey^J|R&76?s_F_whFr~Ye)>;wQ
zQAJhr=?Zon(x8%)ATNs%WL_8LgbOlm*QA71#GEgS4j{tM=0*n7Le3S(Uj(=^L$5`h
zJREY=>*)Y*9?QsO>0{lDnTh(hZ^pj=!(V>=$De=t-M33K%9iS+{KP9oiC3sM{Og&t
zItER`CDI$YX_A`sCU{WPq&4v~rF_7xu&E|TCIHGZ6fk?fc6#Sl7cVUCb=kU;1lJZ1
zM|%%D+ikX+9V|^;?95zk%n>1KOVU~ZCT^yhpVM1MG?gZ(YO*@m=`D=pK2h=FU~`YO
ztgEpUOQ3+N$@bcDMGdqP1fp4IWvU?QqLQ0kmK<lUqitzqWMO1Lf(wmA5?s258d_@=
zmxjRxlwMjI8#J}RacXJov9$4b+T!oHi57S~!p}(*eMv^WK3!jV%5&>M56}JEwjXtM
z@wVGyqw{Z~bRAoWHvk6?i7nzk;97?g8Isnd`gj69HdyHc7ZO85fD2SA+KJZS@_{dH
zjMh@%4u&2!1wOl|#B{Yb>tTV0rr#FZQ#(C;ZLPK$>3Lh4?6x#M<LP+qz^?PVT>WfJ
zZXEK7JmD2_Y<v6}pY-5E12qJ-pGTDz+-!r#CnG|^xZRW=qUPKi5~OrjC$@89VJkV@
zm^C3Io^+M3jtQRjG9JNby9bKG>=_j>mG__{8wZ=chMQ8cHf{obqRpwG8B{g*JFDYi
zu?=jsRmP4<bEeyv(+cK9OG&o?R--8`tXNTQI8m2zvpVIPC^v#jyH*i%VGUeoQbW$r
zLINS3i3>iGe&cG`r+x{S{O9^=$YqGCvL^$aSMx1XFv5Q^_H?psqPx0BlBE(PFq5t`
zsMiuhj@6Y>Yne&nsx&b-UBsa`)ntpR=y=gsO@=H1D;e(#*(pUC^fSc4y*r(4J-0b|
zxoq`xa`JTC;_2wPW6Ks-8ygpE>#dtDoXjbHj@Hdp=wNdC>WhXNOV#|m7FG&^m!dL#
zK+IGN84o(^yTxVLSk}VHexR&V))vV)+0Z-p)H4)iG&QUeE7KYoc^0}_WZ)vVjp>`}
zXaQknx&;2Gi(Vo~R6I>K=;~<TuBd^PWIHz5e6q#%Qx}^%rw(27vK7T$=f?z#Gvcv}
z?#zKB$MzmL;^FSM)g7L0phi)@BOI*<rT-6H|G^fCB(laQ?||z`lKdPk9e{~I-otef
zbQ&TT7!X(x!ng#ou!C-HFbTIXrkH?#LwQKiv(VG=b#p%Kxz*Fg^vrIzW7}*4yj>1%
zvGg`KIJ?u?%S`vme(&g`J0lOc#~#^1^WWW46elf+RkBjXu%Vd<M;z-ckHaz^CF@=f
zk2)#=s`91?n3p!djGe0DQx)ucKniM};l_-?CK}F=G`Y7Sp}!%%PZZzZkT@Vt!upBf
zCR%?(65<uWg^;CS$09w>bXH6&S(6I1b2Gc^F+d*=NY$m^;wE3^rH9mK-KvVa%!m%a
zRgoSFY@N%yd+u)Ffs`vm@Xe!sw5!LcA)i#FTz)atIx``jpX*tkQ_MZ=cskRu@=Wz+
zLD45l!x}vnHKZW!GPfwUsw9rjOcJnC>RG9Em_Oua*K<-Dsz|KWBbKm|L|i(P$lK*;
zv)joQsPb@fakX=FwIyAYU2SY_O*Udz=C)1NF6M^BUR#THK10nf>u)F?ld<p|lHkK!
z8JphDFYIrs>XlaYHL==xdHs^|VOdpA12#rNg~K0`RQK@<I#9<l5(Ncx8;Y)tnW?3b
zp}D>Rln0g+eOr7;(I=^S98#gDtEZ`}t)YPry*8Q!c)DKM?RuB+-*^A`Cm~+Wb+j9t
zgxjZfcpmpXbad~*!=9eL&fA~~TaQ)%7Y>5b|1Y@K>-2SS;nVN}oT{akHn4?cZK<md
z`IdzifCW*G2H=HRILO1GIooAN*n8R8f$MUyuy8Pf$lt)z!sw`*-Lb7!fxBET?Dq=t
z^@PmX-^1>Ri_H~Z_Y*D_AwJGghql82NKu$5NC_8b+!1F+v=-i10B*U_ZKc!}IPv9#
zbk`;g!QWX5!WwRR_pocHho3$vD;X5!qE|d10*0vA7e|aqQ-?t{G@~R+8E#4$X-OHB
z!bUf(i${jPE<Sapy?COXF@+Y43~K~3`<t?rTv}~<7>MrL%+MNoNNsv3JN{y6R6zF4
zlgNr$k(Y9!PDP#eO}KC_;>6*U(8I6i`~LXTyFdQ^tH1pD$DjZB;oa)g+qV-xe0V%R
zDOC`4^uDGnR`N}LZcNtQ^9>w2uOzOj=)Rbf-pbFH^0Gy2I0fLDB4ASa44R-UDLv-Q
zPDg7u8w(#dR}@%oTb$hN?47MPIbrFb-4;i4OD9XqtyY%K8!4Z-*iLszdTL9hOqz<H
zi)Uv|PIq0Qx~@oGl{45<)gdNII`~*pTsa_NLzXJ7fNVbtX;D>M++ULmHx5Zbyr3l0
z-c--p(sHALF4{UKdfKM&2{AQs++=O6qidwAtEYi(G6nr?18oh8_6GRC2YEZ+KejV1
z=xA#pJ@(9@+O#<4-SETPTn>Bf`owFuFKkuqw~&n<U2Ig*CW|UEa_LcQwb$zTwZ`Cj
z$pvH~B_eVGdh7TC0LfGdaR#E3t}aS03ka>T{Z3ck3f?6U3{nj66Kv7b-EFgJ2X-e|
zTEHzjVBcOJM_X@O3m;o^EL%M3wizZQ@Td+XU=@DQC&1f1^swKReO_1hZNK2{2-mlk
z{AgKzbZgPQ)}k0?8GIum8?(Y?xp$=G&{_B}KcfpZI5SpRk<f-KWi_q8J`-C>u##j<
zT-Ybb>Jw%>P!vJ1JOZj+noOQXTCd<<KR<3lkUmrk5{TMXb$_gl$RAYX4Yw5zwH6G?
za|aY9>bi{joUq2+Th%F7fvhUp6-<GZ#s(GM3Cx1-G~`@nSYU*|Uu?js=+g&cFC2I}
zAbP(t_1zC&y?yig<>JK0rLoyb<>Tr0#X0rjoT|OKv|X5wb!O?&=UVvLlJbn|q68k3
z$|;ExR-{O(G6`{II-e2GE2Rop*+LeP5_uVM%6qGui;cazgR`51ouh@Ni?xlTg|&;#
z=FP^Yn~jYfAw=J3cF5Iftc^b)D(Yz{>J;RmX^j`nmGn^wOInfMt>oeKHM85fL|1L`
z!hmd6Ek;F;@TIOV=;Wp=m?^62qGp1iyBcYkQuIwIx&{;tUF{9}5K@_#;BPX~)ItGo
zuB)l5r%ll(If~;x-rly@lV}j&<&++LL{UOdxOlp*u;9wkQwN>49&p{h$H{q@lif~x
z2Z$Fi{J(jPQU|uk*5X=U5EU3WFBD$uVa-mDAYrv0-SBw;7chtq5%@qy;Ir{%*4nz3
zu%*;DFxSyFfkp!Re++fp%qZSA8*wmWbmgeeiJdMU78d*5oR7IVp7yZ4a=<NUw|($l
zr_1}cUf$<=`zV%aI8)E=NjSX=F{&{uQbxq6m^4MvJ)*rdPLzIAm=-F@zauNX+fo`m
zRF?&^qL)ikl*P1_$AXSf^J(pzI5j_6U7dn(hM+Ve%@}V@pHO6=l`|p%zEXyou?Len
zRGW%=uA7&r;KU5ebB0<f2AV5+8W>%|LV0y2%u1_MLMjt3vg3lvV*@#~D@-EpLP_j-
zA|jv|b7a>7u)Z?f-zVnuiI_9TQg0r8(8+ke()X)hzg}LQoqN=}G%fx5{nVRhJu^cM
zLn<x^EN=e&lv`)wuN=ef77<b+$cCD90Y6<V&J_qUtE*FZJQ|-%tL9{I+1WuS_u6eV
zv^CLpFf-h0ZDwz2yxoDY!Elbf*+zTwjpPL#i<ZnRoJ>tmc)Lw?3VQ2u+jv<mob*ls
zF@Ua8Ly>}=-qTPjsn2hdv3sO!s3Yo&61zoZN`4WtA|e<Dw-sz!Qz=zkM3)q%Bws%t
zd;MC>g>xyPS7R>)g#`sz8|ouQp`t+=G||){bP=|+NZ~rn>Cf-n8GrtK#L@k?eVhad
zVKFBU6-37zbn-mt>bBq66<N#K!o<Ve%0Z8^&D7jhTOUH1bvXkNLuwh;%$U}}wH~s7
zr~kzk-XUWhqTE_ig(Em<Rae5?Vy)+>XQ7MhqYe~jPKMg<7DhWZ!3oo7yR~_k|NfIZ
zoZKzVy|>t(@Nzwe(Tu$==XPwld1zOFr~QRp&e5N`$DQ<!J-$2kxKCyLIZ<W^HfT2G
z-onaQV68sw7M@Lc_u5Kg`#6cCHOXprTsPP*$UHgsRXhTlZ|?O7k}+XAAi(yLl;OtA
z>9+i-wk*JET#^E*!dQLMkT7mQ5ZBF)S5!pHS$8_Ha)lk;!K119=~x88%eY=ezg$JT
z#Gzhb(}FAGf~sj(>T_;mI{{)>K}0}7L~!n{;M=DUgrD-me^03Yj?|m}-Oa_*BMrpr
z(}DLZW3QG5uqkT1SMYF5KGrAdYp+yFiv<-aiu%GX8A~OvXc80-^-4wt+h(VSrYF^t
zV_h>3dZ#8j`-U1uCfbL`+Gl5b9?g!>=`q=v@w}>{q<bM=PMbdQa@*(W=I&s(#lm8X
zh1C`_D@fD>_U=&Cm!c$x$VP=_!F?jES1%csVxdBMZzE%@t$J7~M5Gkt-G_+^0v1L#
zP}0k*ayvPh;-Y&PM{2LkZ7t1854}W>icSr^LA`c0{_4fV8<#SoZ}vz<yrPV_kW+yN
zJg%HPc4FVIt?+ubx87r8bAI=ZyC?T&Ui0TChqDsHXd&l4%m`y&mn|^-g5wtc2{@UX
zZ-Q~Wl@%H~Ti_Fb#?RW+HbN8nK<HTiZ{%8!TL1gR3mec_|G8Nr{NWutq(t-{$;%<G
zk=h{ZA>_f@VRv)0UA9<IY<ByzW5o4?`#h|TJ*~|?b+HZfbUNeVc=rEs^%hWVZfm>f
zYFCxg;_mM5E+Hg9fDqg*K|%<@{lneeol@N0-JMc*_jawd*Z$A`@3{AzH|_rSIOC4-
zjLDZk81(7$%6#XX@01ttFj4~N<z^`Bp)KxZAnju!A84TtOJ3Cxj&SO_Imxp=(y1}h
zzB$UFJ<+o()o(C2s6U4|kn6YHlrT?k`v=#)!QwFN8V%_yBhR)b^p{4AR7b<Za1C|3
z5z;T}T2InyPr??`o4VGUxOgXV9B%!Bw&V0GnL<EcxAV#E*#Sf4;SGpKMYLTW*)pGE
z0|)I(!|Zd()(y$Nm2n;gG=~IFOo9tG9B1fhs_Aa3?q;S8ND8)_xLwdyozzksHQbUl
z*pdnRk6}~8!g%e<bkp)w<Md#~#8A!jXno&pq^P?+zq2`~vnjWyy?msnabl=>YNT~;
z^7iC#%h*Wc>`dq6X!G=V>&ReZZ&y`Uduc~YVQWJMMn_&%gilqRUr|(0l$TeOPk;}u
zSG~o6*HP}T&+aLW?k<YzEsY(nO`T}W>MDYZu;`uYU~BVuV{vzBW)97_uQIK#It{5#
zqqOG7G-QW&717#rsm&RoHA%sBNul8`c$$YR&CQMCMhJCv1{daPsy^OPy*_@st2Xm=
zV`y=_Wv0Krzp=PJFA1Y4rN+k`;b@xSNANLJh$I*$`4FI!oDx3=9E9e*b&H*W5%!A0
z6c3(3TfC6H-D2VgZ9)ALJk)>01y1T$h7a=j{{g-Qi5ETh`Z<+^m(WEJJ_|2l0tyK~
z^o{#<hy&Vx!QmfwJzWP4Wi3g56%ig|5kW(4PLv1_T8f{bF7Bc)MbH#>fFiF6BJX7=
z8)Bu|kwF?RjeyYCS43T_jTz4+4rTZZXZg<*hmIGJ>1P>BX%p2T5x7b`5iT}_awtT_
z;p)g~xFqpT-g;j?+=MaS7_;7&xILPAIA8war2E+kTzt@ex>^gHD>nPHp%5`t9X4DG
zH{MYoiq<8$l}Fnnl`)RF!Iq#bsLJOC<6x|eaf2wCL$*!w!p1n6hg$0gS)2G^bpr7E
zAx_4H@xFtt*^R}KZDp~|CD6hveW)X^zdfg?HGPo2g(0)AJ#*kr$xu((<Z$h9Z+UNL
z{=!t#{A6R_?ZV-nvZ3y>p7w&tp_-|_`u^79PNXWUy*wRiU41QC4MmYq$nS5>i6g@y
zE?!k>Nm+hAK~8qKqMY{z{D(2PqI5e-lLjjjhG2cCGHIkPeeq5yG+UZ(&l#vg#@n)c
zD>CcSqdJR{hwHPt%aNA+=(fVx-pbU*^dNe%wK%>dGrTr|8e(Tfb|l34`%~Qzmmmj+
zB%)6m*(-zQH_}ov(OJGYSbw_Q3{6p99E_hV_EyAs#d})cDNN}sNNCTF?JZ7jNRO6g
zhrS`#q&PTb1%<`<_yk#5>BT8H#0qVb;J`F}4Vx|?&<7+@|F`4%mC^sF$c6lRf*<{*
zJNPyL&g0Vcb%S2^hk`#;H#jf-4o7XF=^NLTOQOt7>RcQ;e4NVsY+B;{E(Y2J6-AT;
zKVDS^nmD`aN)l8B9n?jfG(|o1Whgiuxc{NA2(C(^jn^a$<puU<c=x7yjunNB<ok>x
zr2#7~(JO6no41qTcG$UkXdVu&yW-|+sQcZ>Mr+JsW7J|(<YH6AQgg)lO!-Q0_Wh09
z5BG;ow{AZ@9(}modp6&+(18qAQo-MiH$?W8le>!po716hw^J$2zC6+?k8E8)u?4_G
zU7Tlqymv9xKFJe9!fFvM5Ul{5u@6Sa4W%6Eg@sKHx2u!dD&sn<61t(kTWcot9~`+|
zFwkDy+gdo@Q#I93*HlkOL4Q~AXn$pIN9kZ!WoJ{~*g*YgU;Wf@^Tc4|<Y3d_oyz{M
z@{anP#){Og=FHmS$kvMZ4k)hXQw!t$lm(cTc{ycx_{8}*5pE_1p<68cH?D=b;49NZ
zCmPcFDnULOoyGCp70B)4q}IIn-inOcw20=M*ve!oY{{ug32x4d0@S33LaGmi)6V?p
z;z;k(XusxEGMvQBpn8`jQBy;_qP*;oU^kkZWwaL|CxVn86PzDIE>8~0iSQ_nhwai)
z-3TOWnY6atgo)<jj$#D1A7xU!5{S+a`s4+rWkh6odHGncUxigcu3I-*VWS0H+H;E@
z6-9ntO!iA$5FSA;0MO7c2lY!#Fw(^Y-if}qp1zz&U+1Q8zNarjLXk`8266)yC7~EW
z?{UM(z;@v`K}JSsi>SzcQ<0m=R89h?s(@3GL(2*~=_-30t9t6oK+89Oa}`&8DGx(g
zysBVbyjKCmt`hS1R8mv2Pj_}8)VdA_%f`y0r|T1ETa!i`A?_tXk!!prY`Hmx-n^?J
za=9^Tsv=~zF#?%uii9uA?Qx53F>v=d?DsmJuYR%L^=Py6WDfcyWk6tr`&T9#A*6<O
zmk>v)sm<vgWl;qBDq@fo%o4kD$o0wIwF#aLuvIh0Ge6Ke-QSvmH}tinYs=9<(Zy6T
z&fli7Aab}Px2-y%wLAtkI1F~?bT_8oM(R@9Yf{>3kUNc;gB=hFv%6YzL1G}T@xjW0
zuF^ZLMZ?{-{oNI#1GNL)6+NA$-R;HQZN<IqB`sAMgCorolO4nTbzQB+wfPBc)tTM|
zv<7tV<`Wj?V1|7V!f+YkjcXwexIWm+Tprhu71mxD2dPwlZ59+B+6s~Q?y|Jo#mID9
z>7CNlilmT^qL@47$xXSiizFBHRUS*MLqa-oqua70D`Wg(y=)Q#oT)ArpefjJpGb1c
zqy*8NY!ZCkW4v5qyxquNP9bh~QJxNA4wiKYtt^gMn@Vm-3-2mNx{47vWLujOf|3vw
zy>?UZCM!SN4FuM}S*~9NWwG73&T;bwA6y*_n{IwyNe0OlbXJA&KjQk2tbV-%TKgrd
zpI(a|82PT!JJEx<Kw@xC4MtEE9EgMiv+NgtgQK#>a+2CY+$!8G^rb~fVN*n2+(K0f
z#N}hG?yWE9t1s_nAQz0&rP>*V;tlIy>tviqb(BkWlyf;W)K2he%MMw+Q`}V$K3WF_
z_@c$`!r9xo6HUlib>w_w>~c%&R%g;;L&Q`?@JwR_V5*+B+L<ud9KFyQz1E$yGn~FR
zlDpoUvf7h8ULQVLk3@}D)A~!v-G!u{Lh^J&d~>Q#W2$#cDych{TAu(rH$AK4Jn9l)
z>##>*C{($ykq$-_*t$e8B-xlc7%G!&jmndP+hMu6J_V}muz~}!>aI_1E{m-#jcTn<
z>a0&|uT5>LNa$$F2Ha`OZ>&yfZ^#8<^|Y5D@TI%8c%ZBDPHS;jOHo&IVMk*gNDN$9
zTYE)wb19&%Hov_A+J&SeRDW4Mc0~bUVV0YMEH}BCnR%~Y4R*GkYAd{*7g~t~-YHAC
zU785TFWL)Zn{%V`BRmTuy}^BT6eg4>1ymvdO*u4B7>up?QI!eA9;7(FBR8@-F`z8U
zE8NX0%EvLn9iQOm>~C!x?0}2*@d<Z!j`Q-0bajnzaUnXn1UR{dd3yQd?Z`H^MbV^8
zic@hkDaj8`ayle<S>#aclRTVIvXa6~@b}%~WnluZ#RSbt85uYs4}<G2nAt>F*+p)#
z@<ShHCTK7jO%Ig+Nvi&DeQ{l+uK+={6eI@gJ@75?T(Ce1vI5XM-oPC#Q00X_0gT}O
zE(x(PK{G*ZJ`Q;nSh3*J7UI<w<isk7;I(9(w4~iM#XU782<k#E`jRvU<BJr$ekucr
zN{oz(Ao+&UpThje3_8Nf!t}2y$~x*A8vpaIit@kTRx%^S1pAW+7}NiJOXc6+(${BD
zG7qLiks^fMg_Q`=R2+#K7!_nj@(&}DggqIQoP&u`LBcA^nhZ)<QgC2Ul&}swqQWR)
z5%x4+e-eBPeiea1$uu}B5>JXig@w|>s3dBXur`CzuU{stqWbek3=J9n{bwT=uABXK
z9ewdS`odMyi`UIBu~_`hYIWfT>f$y1i%b?b1ide_+FiI}coA?Jb@8(4fAHH?li#kJ
z&_B*-b%D{EJ~CPV&Vs+j<$Q_V`8Ou}-<fSMvD)1f4PsMH=21;z7WKcx<?uTv;WD?=
zB_4poC2r@d2#?1#KJQz?BsR$~Hl=7zjYLu790kh?1=|KC`xXt?E?w^dBjTuO;DmX|
zj0JVxDtyV3wt$OR!bL3q#ENyql113GMc5RKR<t>rs3q&@1v;V@2vLg;QL9d|>rQd&
z&T$*g@hkQ*vxMk5+wd8D#1uYa+BO`SwF;fKAdh4GdrZALjojLF92?YZt5mE@6fFxB
zEb`^Cc`zziz({|PHP4koWl9<%qI!uUx(PzsaaVz!8<v+?Z7;FGKi8K2PvmmC$YFnh
z)#f6b4WqCRBfs}=*H9O(8vl0H^tY?13)jqk0`=Q9%!O+h<l=RU-xzThZ&_bt!e3w}
zT;XzI5cFk{4ZA8#yv*yxAn4Dj7$c;YBVw4(p%}v;<adqB=_;Ew(0Ga4=?b^=HE!n{
zJg$s_zPH3fxfEkW46-H7%2n}AT5erh9(S}odvty1{GopGXBoC&8NO&0xoi=>Xh~bN
z4qvuLB9^Uai`dY4^N?vX@)#y`0uwrEL7Bu-=p!y{#yV_{5V`Cav*sAP<`lPPAH9f=
zn750Vw+)}Qq0L!`&02@eSW+g<1Nu<JZWEs_L)TUvhdK>>wW@WwvQ>!!wh$nXEtJFL
z$)GdEjZ;MplEn3s#PsQ-kTw!Wml&4|kakndmr>M*LCEVGzv~4y!tdNJ48riz_bRW)
zg_{-^ZkYehXmODNbAbW#8{h`!!gb4w47lGJtuL_PFEH6&;c&Xh?tG2c^D4g|gJ{St
zsj#a;!HkmBo03#6wG?5)A|9=5E{zN}`RH4sfy|;5W)aFQkznMe6qQ{ennyi}Upq}$
zH&fQUT-&wV&}Rr0Fm6m5Gx8q+_DllCL4auTv}M?$Rm6&Q^qOVFGB9ZywF1CJEn9^H
zg|lYlanqm?RL}^TG;B^9!32z;14b;!6FBM&K77GGYQ-UX%|2=sAHIYSU$hCE!-Y;;
zB0w^A8b_V73>`xU51EqsOuV}c+&c7}nzacvYBrTBbQ;SPu*GtiTp6=Waf4(bomfFF
zK#ZVvtblghH4%R%De`p@BC}M;Ey>_3LcTY|NEbL=FY$S@%7!va23_KEyvUBf#7_8~
z#qJ`L%|!;Qi@@1Wi~Wre!Ckn4`;FE9H&#am0iT=VlnWdlR|JSG@^Lq%qi#w^-jJj*
zO3^sfGsMhm#m#F(jf%L`5LTr`F7;F{%`^^Ggj+2|KsQIiq*TVdQU+5gV_B`@++pZH
zVn&`qhs>ZurcptYKps#CbeaWCVnS!ZfI)Ls;qx}p3y5vZl1<DKJ{CBf#Zo6hgC>E)
zX2e01KON=)!)5`)81k4EW!jdu0I-W#1oo_{b3mX~=%iKX6p#l@;zDOE$dj0$F*DMT
zk>7xkXP3T9lO~~7-L?vpsAO3pi_VrbO_wl4M0Df$)T4M+BY9LKco5ZyYeIgvB!XBK
zBADc8H)W{Tgaeo*Lm9=$?8-5GS}A;5$xKp|EBwB{^Lbwr3%DsAdYRwrHx|N02K)s^
z{DoU~7nlh2m+YWECl+bybz#!){C+%oS-iR#92%)y+PQ*;#avpstZJD&x&@M$8X=QX
zKD~T?gCbu2LJ15~D`(lHVSh)-wnfIeRsr9nVB4r@*R18<V?-J?51Ye;FTjYR%%DQ1
zO-bX%{v*Z#!=}N*n6L?K=nRH32X<^5y=oh~1pW@p6&o^P7C4Ft90d)cfyJM|1dW=*
zn?Ym1lQne)1P4wJMr+y(0_F>30&vvXpPHP)lE;95BcEP9_fAcxR&{)hDy~$;s#F0}
zAZeT_s*4C}NAs$O^QwjOsn7tI`F$D1f>;!z*j3|zGd6`7Zq+0{%~T=dJP}kOzkW8S
za>7-?ARf&$KD``%y<AS6G)B45-#HyGu-IQfSRF2~IQ+)qe1VOQs{%pHvJt<F1oIjc
zaOq^TtES$Pixbo@6gDa6)XwA9$rm&(6G2sqp{r$WTGX7oO@n7Kv{fu^&78Ub&Q8tk
zwu)1mnscYNXP=(mka5ts8ITmdfQ?+j(&o{W8I!<q<G@kVpfLa{c-)MPOkgNeRuOX$
zFmO@xxQICm>J%En0eR{tCeZ=IXwr}waR|f+lme6B>_Bud0)ccV7zUUJVd80vb`eW9
z;XvdxPz^tC=+&d^-lgf#tctHyv8_?EDw9LyiRq;YXh(Cag>fiSc$KIKpGw#j0e=RO
zKxX*}X1NG%wFDl`bYX)6Y4dUsvtnL@98T>tMoAi{O0ukFy&}F{&8bJ)x|v5W`=)r{
z1vaPOIbAPuxctuHagp8QBAe$WZX&Z{><#%?KD{CdOdYRIE{k0BE$Ij@jZALsTmYYb
zp@2a#P$+HNtl>Feije2+k`8PW_HE*}FtmB2fKff)el5>#ZLdCkzd=LNs8QgUN$>>F
zXil9&11K|Q0P>V+z=Ubws7c@;U5wO8uwIMs84PV2OP#_1C}7O<7SuT_$`m$u3`H6O
zCDPquzz9%?C68N#On~xiXb40RdLXe4p9ixB0&T;=tfw%6Bfz;S*s(Xr@V16ii<*6t
zicOWGMUj+Aj*xaNhZ2=pHi%O;m{X2?RlxtcaKLr(5JoBL4XIEjm3UsmTtSlp2}~Kk
zVJ@pu9Fu4mk8T!^VSy;NM%A@f$)#J;vYtmZ>zV)&xhmjyO^|qz+v^gq?<HQZ-?`kb
zh=g)z=dq}y@#+;ySu_ZnRPgE*+?0uDkx$}KN#oSa5l2-4f#Q~RvV>L>@~mU_iEF{R
zOU|i7%DzqPx>fXw1#N+Du0T@oqycdRf`|!e3_>utKeON|AP+{<z)6#UVPjauG6@)j
zCvbdbAt1<cbjSp72-yxM6vRkRPe5zH81M#W39S6&a17oA4gvHB3jKj@!=XUlw0SW6
z<dBJPKL9ic{As(iYC5-SIkzd}>!i$!1$C0y6=<AF;k=4SD7OOTsvr?Gcug!A+}}-E
zDwA9kmwF11PA0c*CcjZ0hh{35T822fQq;Uk!n#r3zC#Az0uaO0^5|q=6$@jOiGdh#
zk<a(CK)@BDkQ?%G-1>!*<~3Ye*+Ryp5H(=r*3M&7O&8EFlEBuBplhWpo3wm}wf#pC
z)6jWb(w1xfxnIR|V%00pqDOAI=T4~yb_qL{5i6Lmc{-DU6ZBY295L`4`W24Nf`0{-
z5kq3Ho=>-dPmi%ruL;P7I7kn{!J`=RBsOHqB4i2#Xa)X`It76kO`@v`LNhvW1RXRC
zqd5{Z3gR>aXBjX8BXA4JASf2J3haUU^gX(?UE0+hn$#Q`wH%w(ZR;gX3k0<i_|#+h
zHRAZxB6wA43}V4og##|~`CJwv-UI>4L^8|Auqwu}t0i-4rf}<I@f(%O;+kb}P4a|x
zIee?Mb(0vjRuEMoX@xWin^r+=5H>1dS4(43NMu$>;Wj7|!PH8k>m<zU1Pn{q)HC_?
z3PsU1;+Q&!!V31?8lIzOp)1yj`yPc)yo#SX=bd_%JR;V-A~$^qZhjw7_0qTKv1`_u
zebSzF?3zX75{5d5B2R&B8~P6ee{_(3CN)9hh!JVXz<<Edx7WzG*Vu2sm^cXW*A$ou
zfE?y0A3<Zl2VH0(lMq+HuK_W}zI`UXJ*L39Pp`3ekFjUBq30b#uP%5Kn8U(Hg2v1P
z=s#@i(+2`nvu_0HX%HGzZEK}W3xGLZwHSWQI6*`+=BBvcb&<epLZnN4evo=Fiid#1
zx*<ioDILKi8^x*^!>)>OLKrnJmB7|XS=38gHi(&3iI`T1qAKNV+Z7#q<Op5z_IKp%
zyEQ$AmF&AkF^wW-^^%xI33P)rrcn%CC61{T!_-MxHH%>y6<zzaNz<5^9c<jTZ3=Se
zka_Bocjj05j8yX?wE0~~)7zlh*Flx9iKWjxa_%~&?Aax5flXs07D0?=WV#r^nt?+|
zY#=2xBZEy(8k2^N0{RVz{l=t0;{X8oF0j3B09}~A{SZX3LE|7V5TKEFpOII$sW%;n
zk;iR4=QdrZR&B=?uu)yN4)~0TZ{IH(E&fM|x^A7oAwbTmLc+8_Kr?|^I)qa(oKJ~*
zUBKg#P|#(e;LF0n@Nh*Wgh4!vQ8N6NbmT4R7<NU3OFfHKEuCFGli#3N(5Mt3Y+NpE
zTrFwdAde8bbbKbXyeD*hCZw!dBrThzt=p6wd!=x#V%P>rt7c{AUcI1c^N2O8_#I5-
zhPuy)vP+My->7l$ES9#4i`lVF+{dTxIpv;smp&$zzX+&$MXGo~EPYBUedbem-#zEZ
zDSelav<05gCT<-UvkEMtsk6U;p(1lw$}D&~Oeiop3e*`A`wfYGMx;JtFl)~)$U%S-
z7>#{;Kur)4=<4$Ufb?L#(F05xy3r}rA~dPv8#D=xnhs4`&Mo>Lci`tiuol5|+D&{1
zz>+ncT4XINL{0O#Ric?BgIT1=2!nvf6<*gXB9!amR0hfLtD@8^qM_F%!f!}MGD=1<
z$;7iNB(o}}uqdT)sAaIKq;Y6u{mkjgL0ocH?TQZFy8cso#A!9RAvt`fuvsmaUWvFx
zlb}(hEUs0}b678M);{AbsP1!6!zYiT$G#OWTyq}Sr=Hp*?BU`zY>~tro5Wq4#0{II
zO*>@AIqlFr`^-J(u1Eeo@BI6oxo569$Ih7t4#=);{DyVhIsg~DW)-svW^D<GSh5OV
zwu0FRZ2?OK3MY(6g9iS+27X|c-C&tuminMD_s*Xb(v=7l0x<xHCYT^(*c^Nz5bNEe
z@7Ag3(xLC#0S~~up*NjyG;s(x1ZMzt3{-2ov?+lFn-}w_MzhLLn5BYY)^=Uc<BBll
zvM~9kbnH!;I7aC>CfURrQt+H`T|DZVSOlX~46|I~FCuR#B;Qm>VpRp7Rtgj%s&2zt
z{!<3Q3p(DD3U*z>W;GI)&2ofJNo=Duw#AUVgiky3Dt<<+eCJ#C+`sZgK>a&n)jRjX
zXU;hfoU%`xb50yG4nbLv<w5>p0keaIO}nHmLh_D7%As@Gk#pLybNVruG4O|rUZ*2w
z4HvUQ=Pzp65{X{6j9v!g#)i#9Hf<IR_B~=q>Z5DWr`y=K$I$x@kYV6SA0Zt4A`pz2
z&JAf4d?I8kzoIbAQXu=rhD<^nG4&gSutE<oK@f_@;Q>V)0;j3x(Wy#kkVF^rsmC$P
zhFlXt{F$XmjN*P=S~=HbVy{U>-;j-ER!W6%2}Cg~Bs0k-T>nYnP3ah*mr*MAhD7uY
zspwm>iOh=WJlc@uwaVDsk+JDka_Et<X_c~URv>g~x({o3jez>py~ZqK_wdM}UD^pg
z_1H1%+_(G{sp_3q@eB9-CoVbn5vQ#Cgw#VI$Ba6Q3Y`H!%z&3biDl%fP0WT}(ymkb
zkyF|MA!(bCxPy=1wvJu@6<5$SNC{^lA4J3C_vcIx5*u^~%z_~b1BQ$PAR_mp{QK!)
z;#Z6Y8F}{t6DZ;Unly%nZnTymP)3-s4PT%mX3-`Z=F(Fr{{d6qeluW?ItefjoiL|N
zKxl{m5e@q$AW%><o?AJBStbPXU`8>LkZ~D+M<<^NY*i(VRU?y2H<wjCgH<^dQa1*v
zSO)2Y8`233QgPQMVy{caU6+o(CY`{ngk-R)=CY~f@#vHapzFkNZCbul+I~~U<Q0R!
zc@6I|7)?T!jYAgE)K#0LeL}{mYu*FT;-}uF&wa{XxaB{xPd~Lu-nUEGvyR!aidv(S
zm#_)u3LyhL9oQ$hJb38>Q6}TWCF95;bq|OHk%DG{W5kR)2h2l$4Vg8XGHp(o#z3x3
znF63g#sH|`5j1%O6*vqq3xd%6Q(2^8dd@-`F%KNWk|$txY!kLXh+M<RE#u=?aFL6k
zQ+?OldY;`7lgue&FtdiF5=|a6_U~7=uNN~b5YS2G)kx$(l%rUrLl}gKLPq5RhGoL0
z6+C){LM9bF`bC_2g<SNRR|UAdTZ$<RGD(2zFv=!hlS}~i7^D+#%B3(XWdb-g3q`Fv
zG<@f@{O7d68+wf^yN~Gj&zOd;=@O@nNHaR#<Ay<Vn5YfwggyJrGuQlwewDABvXOJ!
zlq2(~HB9)5MfjRU#0t;_%z(YRq#xoFH^JY57~!Q`=BZQKkweO!W7<BvbWDMuvSXLH
z3u2_(G1Oq9SFEB|fN%@i;=civsjyiP6Fsq}Oqf$AEnt2E_-V29B3H;1LeCOmItN)O
zb-^Zl1qgIV-mr^ZHT56VbZJ$wZ%}t_HT3TV^;t(iO>q%^mx^<X0-;XYyp&rrg-Jew
zMVfp|GDsQ+X<eJFO*@2839A+!!!i!tA{Mn=aC3aRCCp0cH)N8oO2l24O1Lhacnu&G
zPv;MjLzq?b*fdIb464O&og$X);?|vN?qjlqK4sSt1;+t3uL%vW2?Jn~ykbb4HSnF$
z_nSpWu47}j>{5>{<9BdL`{v<mR#6*viHF$86);Hiuz6hcnqA_yBeLzBy6>KO;*opq
zo&Ufw<<KT(6AaikeiM=!P$eM|p-T}s2i^V};eqZA0pSZ!TfjlRHEaPJI)|mgI1AG}
z+o(lc#JnYK)`B);5jKYnU4-zBCQqS)r=YfD6SHWaxMrWY4m=wW2h?3!z~4axH})UK
zQ0A>8S1=(ndfo%7&Yj9OHNuA32)jxww{j$hB2C`9UEZc$#i3ipu}9UpU(mFQOSg#E
zuw2lzS_oCeu2sOMQN*cT${?T0D3i=6n{-n#>#9sDlX5nfZn>awy|{TRzgeRYwp9qz
zB4^(xZP%mXI->0}t>iK+L+Dj@9n~Su8wD;J!$_RhCrzS4=1s|SW=QA)n!034nKz@Y
zxaL0eD17XkeN0H*vrjp+M~-pv2ezQq(pTQ)&wL8*xn&&NC2ZToZW0o=!H9vwUu>bn
z=0JeJA87EG7%iff%xUvb<pT1cY7M~AmT=)K@Q(G*iYrWwVTxxSf=r{xlQ6R}f|SN@
zz${<{cmoYOA{%z`%h<3<eeYfkhc->ec0I2?W74SU&oY|6@1VMC7dSy-!z@0X6fU)R
zPSrSht2POAJ)cp9sCm7NbsHpe+<Ks@5>fL;fC#!#4BIYY*~zV2&Z3+J7AuNw5yiG4
zLS{{(m{x9sDk1YG0Zg+rp;z-KX|ncx@{R+#{&OHhP^F~p9eL*=4X<&-fCY5ux^eJ4
zI&8%}eBA;JI&KG_cz^}p7r*14|G>HMiBsWI@8Wy@1xNnrOVNq7scDVQ@r$T12qi~u
z=_fAfN08vSWu4h2?pPx+8^0_V6bB(0#$N=&Xc0k|9#9AB1Fq;Aqzi2t%8K;z0=%Tm
znnSz^nlvGfz&zK;s~3#cEO^3-HV>-+xTr;o@HuqQxPjMzrt=*gj~*@eJK7%IP$tsy
z=+<!SQnaoWHb8RtbTS0=GDVDXL`<sr^~-=X&>ELs@lW-YaqE||Y7|RYbO@R>aO+iZ
z>Qo4$nuN??BGD>i*Q4e=t>8K$ZhJ?@p<mT|QrUe>+P+uDv0u?;7}TfYKBnX{1kXC8
zMT4LfW9pW1=&BKA1rxnvLR~WoS+<PZN9@z@dY8NmsQKWUeb**t85g^QPuNb(=&Z`k
zDN71(P6?@v_Nk^i*Cof5SM}2hXYI4@xn!NWW*kC9am_e(Nj-K+I|7FYPSYx81x8#9
zB-)!GPixR)_|pIIM<)!Pfk=qa=0Q`KfJv19s3~0kfhJC%{6<l}!zMn%roJPlzN0Xj
zk;b89YZ5R9q64{Udi3ge_G-FysW`N%I<_ehnicGtRBW5YjEbS?tB9+TKox@e#89<B
z8@pCMyLLX4YPynr7i7jdq#2`-MIFBxG4nQAT(>N~7a|4Nq^94joD(u=61r&;x*_X0
zpy)b^qHe)UMVC=QOpB_=n3m6+oc*YN;Ic>YD?-jAtK?JL<WtZQng$<PH4IrYkKD0I
zI`pf05#0FPHFMuQcF!_&G&(e@6SitrA&sd4)$yTKQK8lG<ld6#!P2OqqJ)x?+YYH4
z_Gu?hDMwBz`-pSe0pO=E1k2vAjoW|`@*LN!W5{{zV%Dv}146+$Y6YJ0(QEX|H7uBr
zXMi(PzfqtO8#sj`j-&j?=q&m{>4pAa>@%eAGob6$tL@zn%z^q~?hQo@4cFVs_$FC&
zr7X5u7E>jIm{+RWHc6w)1@&^oF%1Ag(>gxGDgl!ke$z%RpBbZ|1vA>ZP11=~+<~&o
zkgEGA5F_t6sO~dmO5Ij+8PO&#pu*_1nS^fXlh+(`o_m$PHjCOdjo8wstQv-H5HcV7
z*M6q7{lmTdl|$Bjo8&`u__}rCp+(#tJ_R`@AP06S+n(9`PMMFq)0Tp4aKTuuBu^aT
zX_@M4)sjYrO#lTU?sYMq?KyDrD5@*LD=f0qJn4Z8vhMsdnE~?b5s>XBct(8uj&1A~
zE*iW7<ly^G3EPhGTQ<?F_}F#(xJ>|1_$#IWuXfRE2)IK_m=Oli)o4zdKog<%It_&~
zRKS>l=a9B*zn0s-4HpQ6>9<MXn2txcqD_Mown`FJCSq79hpiSjDdE-1<TrsxQ7dWD
zE{*F_u<Mh>4@ueggZgv>A@A6=PCPOT-!PBb(jrcaTX&%&4$Npf8i?-{Dr_4YbBK#S
zv4}a+30k#Izvo@`*0cPrOUWzmnvY&pA6!dbyB5Fjule9v{@Nw)5ma1U^B=nxJn|`d
z=3VyEJ@2k<)T&wZ0VQ{}9SIIZNjqw(hnQ)R3=}9B&0;bk+8IN!)GzeG)xrILq4qW5
zj!CZ81j?{M#I{X5vTd6HbC;!`(%ZC++s1^inT0NyhpkvdY*<8q`j!d6YV^8I<SIUT
zg8)$<Qu62xe9XFC{1zc@3rrj$FDMI5n!pClV1wz-(a?WX$GuP8{*JOuJFF}y*|(}W
zcW8O^K-I!HU`)rmU)7~k#=1_-xEKKrVdX|hCx=Zj0el>fezl-+os9JzH5X9XfQsih
zm?^M_j@ZIPZ9C`O_b7VmoPFOh>z;ezQ_qs;u6d8#@*jKTKldznX&HBbir&I!-M2zc
zu!%=L)gOIpKKWLE^elVpTKK{?^BkY~z$)<oW^=&}Uwz7+`By&oMoOML<-zRaG_q&`
zI>6lt!o=EYlT1|e$ac{2W2h{;B^8eS6Pse)T4O!SsD#Qe*JKB5u(5Keqq{q)0shg3
z<Yg=B5{|Zxr9hzzlI}HZ_?l(phE>!iEDcydoh*FAB6Qi3x`L0|afsV@h~Ku4-L#}G
zTZL^{ha;QtNwc7N17BEMnZkyyScbu8R<V>7W8$>7$AB`SL)^R?)*ECj8>OupmF;h<
zI&{h5S|l*Fd<I4AN=e-6DFQl~%#snXbfM-lAcwyVw5fVdnuKg<z*K@bYf4>5(KaxV
zI~Fm!E;$eV%HNP1KS%ZaMZ5it-1q?rY5q*Ad+S~N0=|c$t>IJ72x<4=17_iyR`Cax
z3CHNzBb$`_wkhXU@rPE4$1eF#9dgcnDqe-Pf2Fp6CD*+TZulHr^Qbc?VJO`b+6vUB
zk@JIG8WB=Mia*>?vv9k3x;f)^c5r(-ak4(SBa2!P>=uPJ3O7?uBd8}Lq45q$yY>mY
zuIWegcpS5Zi-CoJRa6M%Ma%F2yjjuKFq8!|SZWDbw29at#Owg2s2~W+3qUM3WYO4v
zQq#3h$8*S-IAsR!lNU?_XLP-WwcUml@wbIdsyH<AxV4M8G;%oAGkCRfxzsZ`)iRhB
zldp*(p%(=MuZo6T6%4q{=dbM4ujw(SM_knKp3x6j!bEPv>=hS(h>hOHL~WTzZJ;C9
zAnOgR{XlK|9^Lc5D2<=UjUTD4-+~%G5^Ly81lE6c&3}fC*#j}!CZC{V_6?~!8vct$
z)HQVEHX-fYull2V*-O`=XW^ZHMs)s(M0Wo(WBz~FR<?J=In6hvtc;Y$`Pv4eGz!T0
z3L2p~$-O5p7#j2pRmQ>ouwtrBNvK1Hw{^O=WmkD>X>vfCoqkSAnOpu7r?g|&v_qHl
zGY_zc%zO69N49ahFr_gKm@^AnFeS|a41K4J{HL)Yt5#u~Cd65N?{O1^IAiQLWeSNs
zl;Au@^t?t5d?t*EGX{QB>dphQR-HVWP#Dg=DNmn&-H?vEDoVR18h%AM?5b$^b@9k+
z;?%366e#)q;t%pWHRn+S-+2wU2_5elsGfj^a0!R_lw+9vV`DarsSC!`Mf<c<$L#xH
zy>9u)V~7W~$dOm+V`}@CgrWZq@BP!S?xRc5YxmN(URCdLDd*_O14WMs6`u*~v{TQD
z_wFUH9CM%8=REc)d+m^Um(=vFxOJg6%3-P|ezFSMD@4QA_W(1sR>X6nCVH$sVWm5F
zqpxtdDypZDGEhYBNDIjHFb_9ZZAqm~)@LH|7N*Je21)7N{>6`6bB^#y2l%*Me8Qen
z>X`#_Y!$U-7QA8_u&C!XspCFw=re8TGh<3x#8TExNefzTqw3CsTCO9;{&OhOqPE+p
zJY*J@ZHjgST5eO?Zc`f0qte(;VdENJouV5uDL16zZb`>NLF$rF$nSyx%0)yl_#%Jc
z1zyrcZvP8hesT`|Fz13K4yIj@%|QVGMO}sXYeZhcgl}Rax6u(0Ea>7wg>RUJtr~}{
zKys(%HDyR%uunVlFMsb>``)eSnNQVw&x*Ish0k4!UfAb6u}M33$bM#-cy5(^ZlC@T
z9ll{g+p<bHu+2v9N0)E(W>N<7gH}6I;0*blJTgH;j)KwdO%EEWiOUPIzLOu;n;(+u
zrl0ABEu|3JQ~XQF_;iACmKToRQGn)@<!YAcLqMtyiM5}+3eKET?t%@YLzaOgv%qB&
z;tD!&-PnIo)p1DMZQRIb&V;yx3S316fQws1wB09E?7_|T16S}MY+NsBSR-QEC~Vpw
zih{+7MnS_m4)r2o!wPQALJqZDHsve^siaH7VZRH8!gzr{<N|N-Z@huOa}zIc`AgW`
zmayrPvh5YN=#<9y%Q+7zfpom4)P1Lvy~b62CiDX5P+?F@-bY7m8<1C}5c@$n=P~`D
zbyM1oZt%Jmam6HJ0~5dNnD@v&=OHfT)T8v3Z_Rt3s<%!B&oFU^X3@Jwp=;>yO$#XC
z$Lv}qZZu@X4rO=^l+%`4QU~Dlx|RZ5ne3>lP!?d{Qxw)+MC~o6b?5n4!x0D~t~T1a
z74c1RF^)7<FZQ)d^FYkXLhN$<@J*49rI}eF<<I;}-}n|k@yvTbh(ENB+_R)@gE^_Y
zj2ZeaYP-)U*$pe&4l39VDiKDM2_uSjL-0}-*DGMuBw>CV-iMLjppjd*f=j2IN4uOu
zy@XS<gjG40T{VwIDTh%Oxh4^JStR<3Fzu31C;$N(FY-|?@&;d`YtT=@bre!#F{^GN
z^E)C|y%K~GQTU~VVR1sQlJ~SBWeb$3<v*<*FryW;ph;R$_FB*m*aTQ4ouH!+l|1Lv
z{Z~}H=QM~bIzgMJ5l5K#yEZ8gu<@s+k-Nqb8>Z3QuDMS<@}J=nPwg|$OOTAb!2(iW
z0d2U1HeL}iT^p;fBm+$v%)|xq{VWE{pn+!0Sap00LM#t+E)8;Qf;NKDzL6HXE^0E-
zPMFS=z^X9U>PYv7Fz>cV_spVhr<}*GnI}+faLat)p7q!%^&B62W)Xg1;Jc*ZvY<p5
zm$vMe!1M^4b^`bfkyZi2Rz8CkUj63(j9fZ(tm?%qYA}%~;nFH&Q7K?kE#y=yW|Yff
zkc5~Kds!&@ib%vS4lfH)fkKesW&XfRe1Y<g6H+z<f)>5J=pG*Q9ezwNpLw^i)sT?o
zfCz3xi?pd9vT97*RwK?Rdrd01k0Q#RQ-&e?S^=B7!P|O4TL$DEldvNN_Zhw5eeHlf
z1Ims?{E0qg!z^+i6>+5GKBwflV4ZyClyOg&vLBOFJ5@-U?noc6q%OBX<FUk*ridgT
z9Lwd4aQUK#wpyUMhNF(85kEUdUP4ERTbGa7N<r9DTRzlG7w({nb;gb(xuLfcJ^M2Q
z`%?ot;@zsF0^L#}5Ffc`-SfzXip{Zm)&rN+r;bSv(ZSmawiA-rK~YqXkZ~7)Prsc@
zr<qf`iA$%EPrr>@w~1A~l0&nKOQ)7cx1Lk023~S%R^L)Cy{V9YLl!Df8P}y!uZSmI
z7EAo8!Kf?3NaQ6U>Mto?<O>0a<9j9Xy&|@Egsi%OKu$~#uVo*fRlk`16c=_-*mhXn
zbxhuEN-J<xHDFnnwyWqlqw2Y6Og%ITKSn3qN5!1!P<Hgg549+}rZMN}xO=F$Q;U>y
z%d~qg#qV)R_wkv}w1T%CQqSy*9yg>>koo4s!TRW_+Njxvgo&DnjdmLB2Zt@cGF)t`
z9IQ&rH<ei#wD~#E(!6@2++wUuN^oYB?S`%(ce<y=R57(LFR&*oXdpMFCy&~d<XcPg
zCuOYIrrfnly6c?r2p4x?9e;$O?HLBG8V0Vbd#s9E4ho{Wxeab}=(cfawX!2>O)M()
zZ0Zf{>J2cms@Je-)G(`7vZ__FYt*u-Rk5g+U6;$dE|+^<I{TVr<~7OGs}f09B$BUy
z3`L?Z2}fQQ4!<l&yCe{H5iD7NqDz{Gsjjlegq+KSC~i=|Zb-y=Qp$Z%z-~eSKfz-;
zEMz?)Xf-ZIn2_^Z)S@DL`e6r}ft#wnD=MT7UD~lW^-ztxVGwnQPJXCEJJ1N(MJ3*M
zul!=0|I#pG+r8wyXW3`Js(0~Y|DDo#-jW(P*Pgl74ej8Q=bB>YTjO@1zj3T9w4RgY
zVAtSd(-q{<;9*zi<un%JF%sm_6BN+k<CJE;rpeFN9Pi(m6^sm&P)EwbCaNOGYoeDr
zQ<fW(6C$(BU^0|=7ZZ745_+H?xTQzh)%01HA%JO3h+B<_Sq=-B_H!HDVb^M7QwPyC
zv8pw)s5Y>u!dT0!Qp2QD&7@RuOR*fr8}dchWC|GM@^8rGGDzoLmrB1Ti2#dNBoZ!*
z#r=+mMqd_*x-1xVNdTg9D1>A*W!a3pWJcXa(RPeOHkAD4g&igY@iTnZV*)ng0{C$$
zk69(+nu6bwHf2YHyrn_jP!HagbX!vN-4S<Ql=s=t2|dvbJJAU{HjKKbMBLU1+sEfU
zwJ(Gc!gHU>uU4rKyvshMjr=RF?~{KJ5?K`O)|5t^s0&|dPnv6u-Rn<l%MKP|x*^NM
zr6I(nDZnnnep3MMnZ9;in(3Az2b(Gnm*mZ>Hd?ansnBW9zau4JpnyDH9ywkSIZz(e
zUmRARkzpQjgrXi8QMa|d7nR{}vY(T|Ps-w_Wbtz%<|F(jeY{4X!7g^4c7#p46~L<5
z%%stDOSPU!rH)ytj#;^mMWqVZyQxsYC||;;P<}(M=!SG2qjUj-bmnzw<hpd~HOb_w
z;>nlA5-y5FT@;P_T{QBNAmy@PC?<Rz9kyx}w_}@n42hjZ@{t~8U4yux=&`2mw{8@^
zXB>N=;J>Koziu3TVuZx*>CkrM{g%~&wsgZzwJ3)=VJFgFYYP5*ilklR*oXQt_cf`9
z*p$aEl^-1P-`b_W^soKyQTpDu<b`j;=e+LC{fSIy!MxX>zSfnz(2=w`l(RLGr!Orc
z!@;S=&#5oSVWleNW}-`Rv`8j7rV(wSla8?vf08e*Ifc}jgFv^Eq?z`NrLO$>&h(k~
z<fX2%==f$7?F1chh@!3=25e~iY-;%KD0{BSJ1<IFPYR-X`AzzH40}2Cx;b<^*>!-w
z7FMkm7NAhAfkmwWMkdvIR?s7z%j%m7<+qe7m=uA_G6wk)2DyUkvN;U0V9)8-q>>SE
zhgZZC=^jxu{)$k<WdWK+_zJy{k+cVJ$~bk*IkV3`b18W0Ui```@vbp-S2uJ=Jz!hP
zWm(K|PMdaMk@C<We9toFp*iwGHRMp4bSUq;uRz?9^Iezl+>r4<Q6Qcv6ORldPwlf`
zIOo0bt^N|${!dcXM_3oOK~lDF*X2B3Dma@jc)DHj^0=ohn|!oT)|wlDRu%KYs=+0Y
zBURyRgJnlsZL{53l~L}M5gwU-xIsA02gmVBLk7!eQ&n)tDru-RW}zxJCz0%wypKzJ
zYM=T57jqXyJymsEQgYjnaaa_^O^9Mf1W^P0CIdVMecbxJ+y=-`4s|<$NjjO@9qig|
zz~n9UMi#Y3CYAbI%C)zYYZw))ZYov+jW-p+pbM|d<}%3UU6;weDwTd!GMzy>18f>7
zyaEnUD8eCr%OPRgJqs4Rj@+_OVY%C<<fU)fE1y!B@xSt|cx9b(--vpkN!nBL+eEaf
zyI_}2xi1`ZpL<lkb1nOTNq(#sb{Cia(x>5vdBzhJ@}3I$SUddGxAtRX_g|sy-^058
z3atO)p8ts4@SfQ5cYV+F!-edfsiM2H`6maXPwp>%c(U;R;q=MooweE8&56>1EdPgF
zLvLPh&fUqFt%p)zaBpewY<tT7Lc=O@CugW2WUD9p-fZ2&g@$`GrBPXP*6EKeqxUi4
zCt7~nYM!gAu1gB`Ytpt0!su~+(-A(C0bb()ZX-H)j0U)XMtvZ&A09Y#!KOP|wc1!T
znprfPnA97Y)L{H+*s68Rs#Uj?DsL*5Fv{m&2ma&=uE`>KSEX|pWYVuor9fP{EFODF
zEXE;W2mTA4laC2;`*zVgcJX^K6LL&Dg*7wJV&L#Ckm*<P+O6P8NYjtN+Rwg~Z=4Dq
z`&7LNY5N}4_pj)_|0dRcqqO`Nsqqi@+K*n1Up=Zn1U7yT?fBcj_G5V0-w{3kBDek^
z)_;m0`G1ha@&BFQaj-d(b2eLcIGXeB#rD^)=U={@ef@Iu;@Rxo)1mXz{_TFa6QKCz
z<LTAGyo2#lxMlTV1`f_354O7>E?3=OD7d##e|Nd+;ab(^WSwj3ecOabgp{YaxVt(*
z+X}8LGWILdge76iNkPmwzxgCDYMjS(jLUe0+jNu*F&^YJ?B&q!;RJv|>vVDG+@S-Q
z1kb41%%;%@Oah<G8ud&XwT!A&H<c?{RH}a|@rHZ>gM2=NTsosn`ZWmzC<MTA3hX<^
zhAqPe6{rOP%%P4Exq(lDHJuZ`vR9PW?~%9v5!3Z|P#yA~+VYjs@;$ieTUf_G{Odlt
zmAvq&d>h*KhhObGSjzCOeiz*K1Lkt>C2zodeXBl^TfURq|D^T&7qQ_Rsqte#+vk{u
z`#aP1C)4G7<3&sT1(R*5dvnzvUoS(K`mNENyK9XPj>o@zf4e_hyEc%qJzfb{t3TQA
zyt`iYbhjOOax$<#Uh!<J{cNHB$!6{5NIN!sTR&h&-F;2db63r0SBkJ8W-~8hH6w(b
z7Q{>om{0SfCg?C52LicGM!1cKIgN%m4f;6^df4^5*?~p<Zg^(Vxy_=}$)W=$-3k=m
zQg67W4iq*rsn_08tp*lvDiz;E6pI-ZiWubb0Cc}7oq9ti4FfwoVS^nRHUz*L3alg^
zIHjGsq~CSVy6=>7?3{7#R`AR%|EX8;OaF>@-X(9mOJ4@oehh8?;aBrMr1g7X<LBU}
zuK^8TDQ(|FJO83|{6(z)=2H09xALoh^*7tJ$GFr-o~7@|t)EFP$alwrZ#_Nz_m`@+
z=iAP9`(}D_w}wj2_6A?RSX&#-efwzr>9hS0@1OniU;jMW?R@j}{L_yY4^O5}H}34M
zRO~I3jMv9Px2pZIlGFL7vzfB_J1shat12D~3QqIV_(dt(Wog2SxXq%N&61e)l8EJ^
z5Oz)gJ0n0Ra*7{4iSV0E@}s9flU&BbTwu+{1005Z>;}DT2E9MW9y*zNx7l?&AX>9&
zwJ?KaYc<@`sJW$9&7xk(tX6hQx#Xro;SGgCMukFV#hhCTS+LGR-_k@`FefiU0TLGt
z>x4VDbTdA3$vCr1KC(_cwTRt^)eAh5d<M0BC>?kdKJ_hoO>X!?1${Ms4e$7y*7jFK
z=idR1KfJ3y1-JYW+V)=_#b5j?zxz~taLj*A$arCw{@yV9ZE)WH>F(s|?$Cqd#qEWz
znZdfr&b-sjzBez=o;+TC^XciM`x_6>=01FW`r_H~=kIU+{(t|!zyH_YUq0M_a5#Lt
zinN~2)a(rxuXJa@{jVFndAq$CCcz_;&Kt^}i}KEEvJRUvgbhjCRSBCVfQZ$cu*IB+
zC5*Fz=F`9&oj<clUeobkX3cFp`qQ{aIShw5jrutZ`q=cl*$jGE^}1R0=t(y{-_dDe
z(`jJQs$){GL4Za^)oLb{(p#WLrNUb(xi=KEOn;skpzoNa?<b+l(2TMKWpQlyrhU?>
zeezxF#AEZQ9c=WjUCLdj3@98ub<DhPmwMMV?}=;PQ&Q!}fU3_<*$-Xwo`LS13txMc
zfATK>5>WS#fQG*U8oyE6{`9T+f-icXi&PDt%r+j)w?d1l-HFPjuH5a(=G_&z7QXZ8
zy~Ri8>yMruy?X!b&D%#GzP<bL-+zDk^UaU%uRecz{_@H0hv&PG?=Cz&nYh2&c|2Qt
zywY&EI=tMOQk+$!<<Tc$za{UqF7LQ5XAcyvi`j3A*sTlMtO5kAmj$d>_$?QCvB*3x
zmJS}w9Jl!txA_FGIbDnZKGZm;(J;`+VbIS7Od9ra8r<R3Yv<5y=b(>mAVxMVaE=Wu
z>UFGYWiU|zFsqc@QYwPAKAXrDSZZ-e*|$&Jwu|3(OoBBoz?n<hJ$vNTKJ~6k)<dUE
z`u?8>b}4iXLV4LTcHb`L+%@~DZ~6Ps=07Qoe|VR^b1rz}S_lRFw_atRi8X%&H2moY
zRsG5j<U9WzS#_}3*S<4avC@;jJzTywTfaZwzCKzrKU{kLaQDUgC+Fw8uRpx}`2EwX
zFYiD9^N;WU`t#}Yhp%3rzJ9Xx_T}9dukJoX?oRG6wcOhsI@urETdLiisyUqR+nK1H
zZp+Tks8x4am2}>faa@;jSQl~F6afzHH$@${h3wV^@oNG$D+0J>{-5BrSmd<;B4@cU
zQ{3nYZZkT-OY)dbaGQ*RRdbnuZTE2*LZAT`*~zBY#-`W7ri(PQ=`^xx)w62U09e$j
zm{m#vu*nlPGr&TXb>y;j)T(Xds(r$ibIO4W7;5$dpTcM4+D{>MpQ%mXgK9q!E8lt+
zz3?b}=~?v3DdQm_<=i^)<fm2NcQ1V9R`kxJ<b6QxUrsrn2$}C}(jfnNiA#8bM&3D6
zXOMSK&wl*<=eO^lK7M}x`s3RVU*CWF{^8ZT^VgrAzxw|1!?zC~zkhi5>DBvBFJ8ZY
z`sv4qAOH3JkAMF4{m<7QzdZW#?eW)7cfWo-{rc(Qj~_4o`s2;Z*C+43JpJ(H^FRLj
zvOL=<Z#^pRbtLPyE$Ol??zAW2yeH|jE8(;&=C~tbza?z9A%x)9gl*}dYtm*}(0YZ>
zYLVA!j@NRA2MZ2ziqC8k44Mx;!h;&-HU&Kna2gGA827Lnb+YJpaOk&k>e4A>*KK0g
zg&1AOrd|Ou)bpOu^O-aWg3V#`^f6=}MS%r{Me{J&ssme}b{$fVT{F%dQ;}oW?0en?
zPrM4B2Go8EsQKt${=vKWjeGuc*YXc``R^=}Uz)`}vP7Pulb##Jzcx#LZ=UkjGV_CG
z=nGx)^P0xqld0^ziH7ab>fMRz{i!nOD84+9yD?t8HCuanyl{LpbAB?lzuvL8+WFvM
z=E;NACy!R2J==NvYWK~{&8LsokVg+!A03aKZFe4Rw>-Hw@#@L)>&I(f-#q&I<^IOP
z2q9od&U;<fb3@kSP|Ed4+Vx1r^+?ibU()G7!f~HY<4;wJ5;leG)_$o{$a;+*H_wlo
z1Mpf*^H@xCW2b;W0rVKZ*%+|MX)?rZ+Q)_JW;gEQLJZou=xF26Yvs^uX4h?G)2U|B
zsxk^(FbQ77(qIj6iw>~n<Sp14@0xWEyt!rq?zv~*cg=q2nEAjV?c6QziC57}kAi2O
zMK7TW?OE{3xB9bZ)i>L`Pqukq2t{8lGd`Fkyw#6<tsVB<F#4H#_;Z)!gXL}{eYG_U
zZm!rIE?nu)+ZZj`ovK<NEr0&(?Cr-7C#O@#hZCQ_e_7w?-&yawyEFLW+3uUq@7}z7
z`0@SOyLV>~?k(Rv7&_k{ytmu`@M!qa$@uwB|AWKPhxeBEHijN;PL`y^E4a_f`|inm
z9?5x}%DJD&x}Qk9A4|F(O1T_JI`1JMNHM1!5yx#|`%Pg2_{a?r+jSw^B|)170qc1H
zKL9t&Z#lthG0BI81ah30PU8R<s)q~J%WZmx%jh<zK_`cP8?eY_(8{h?%cfgn8U)Lt
z%dlt4guG%#*}#NtTSe^SqW3MMcW|-$_{1YZ(h)x40FNXcIc7d|$e_cw^sPt1OV>PD
z7I^^=ew82nYQ8!ZzxSyA?pFT8D&w7L@@u`QS9%d|45MCZM!!tX>e-m6djIO|(}(jn
zukOBkeg5IYi?879Uf+NB`TXt2vzIUTKD;^k^8WtwN9#|{XU|p}ADs-p|MKX=`@{FI
zmOi~(fAtKRd;N6b*~6LFPv%}fUwrj!9v+^Z&pvs&_5S_CZ(r`k#C1x#@2C>@6}(Rs
zea_{*PGvn#WV}wLJWpgij_G=IIg)TW5OLlUcH9wl*cEfw6?FjPUK1rO3*(oBY!~Si
z;^qWxXLzlr`79;{%*O?=ll+)bUi1Jrst@6zf9d5i>ESZy;L>mB)CVOtaOgMK!BRbJ
zhltvCOgMB)KX=Qx@1Fh8CF_A})&sZfhfZnt2uTo29ylQ95I*eF?z`kXg$)D%hn(jw
z^pNq+Dffdz_B-FIKfLO{<8$8I7kqcD{KGo$PqWyUDCDC?*z2;Yfgi~G#g8BMzx{ae
z<?HKz{QbwD|M>Lf+pBMXzWx0D<>!xw?_aNf`gri}&Gx5vd#@kPe1AUs{r%kck1PN9
zbnw^5qpz>GKfm7j<J;XIAGW?epZoD<{>#gm?=L3*csc#&$BpkF_W$*-^TL`rakp)?
zfFl+Edy1qp1>&)s--&|nxtz~kX*!F@iIm5Yr2CPC`=PkY0YKE{CzJLNuvY=Vp)h_~
zgwEtFzx9lO)szr+QpjRT05i&GKFDL%4>a<c^>Lf_@R{D>HSXj#?EERiHVfE!7&dDk
zyXKm->zuG<kL)?59Xq8Sxo6(>$$#jb_sF;4IRNo3df`|4idg#EyX1vu(R0}6>|goO
zx9q(yWO+qjtg}DiGQOB5y|&7F2VT!K`IUL*TfL+&#xWm^B2HH~mjC(V{OhMjpWd9l
zdA9ZX@z#s8xz8^TzI-_T{NeD^n}g4<Hom-Ac>ien`EmDy&AKPs^{>vmKD}A^@$K-(
z=Yt=g_P-(@cfWqz{NwH7x2Hqjp7wpX-}UaS{maAtFR$i5KAHLR{Y+!`nz-ktcF3`M
zz+I)la|O~}Wzs!G{|E9u=W^aa<GGCIsk8^M_!FK-QXYHaZaZQwTOv;D!j7wwP8;G5
zYod0`Likw$;Lmzm(0Yd7YD&OzOweLP0E-OsVTOQ7UNfMvn-AU1ivk*N^B8r)-Xnl{
z=o~I$)toYir7hdV@7gEBzNd58ZswGB=9Kz>>Us;fHn%O|y9N|1?ohNvN^xq`g}Oj#
zffg_BlHfeJLvV)x2@r!22oQo6_uvl2rN(K`Id|^N`}=0*Tj{+s@Asa0KiJLh$>s?u
zD{Jp1d++t1dm9aI%p$0yZQ7<SX4@haHe~GDW$!!W9NOm`*ybHN6#lR;{PSJmZ)Ta_
zpQnC#9R2MUvV+cSr(~tJRA;XCRU=D%gqhCbk%r`v#+0Gj_%2-37#*`TSU%HN%IYp&
z=r3FDEf{Z3f=b_`&1o}T1rsgl{k8Gqt@#J*ZHMb^Tl0<kt8M!Wje9e-o73d286aKP
z?JhKb*%>?78~^!zpp)^@(6L|NXZEW5lD_+juKS{%>!Oa+k~ZigG~~nlMf<r6cC+d>
zFs!FFY$w%h##F6GVbGrkvu!za?oB_tnf0l>=~jH*rC{2rVA3h~vR&ahL-8qH{wZDV
z5e?eeCk?WXYGof$K#H<=i86O;p87MN__aQPorkcyBmj=de*|9!_Kd)`##bTZZ=>hU
z6IM+kk$Lm@6_^1n6W7e*KfR1ugRyIxuwt39=}_?1F6WzL{?B(A`|t9;+n4>cD?M^A
z`<qq%H)=)E=5Wn?U*%|H#$tErau4=!duV54aBHP!e{*ngl(aobTpPu1PgNbv64wUv
z`)b1%da~9>inqs0*C%khvn0T^tqqs_w%&kjjF<1s5ZA`a*T--hth!IE+Qa#VEmqz7
zY|HLS_x{@0?kvqWy2;Svlac@WWuNuSzAFZv3wrKLI<5;ku8X=Z3p!5oI!<$%4%1p6
zW-fl1QnMXbvmR4_KdSa_O#R)Mn#IWZw}T+U^X5G&Z@N^>y3d(?RC?X1V$!DkyjdA}
z!BBeMtnjq)>|>hzlX|&F6j(BnyHA1!n-5?3e}t3CZ^HWCM~}XX9*4A+IWhr(Ff2}+
zN6%U(ty(8T?6Lede$^s=^>y6(>jc=%vSl2;{wQ+mMf|~|xZOtydk><vjbrv-q<npr
zwEsNrt6Ab^XHEWOJ9%!fb$=OQ?60;SuC?u~_wVnF9qvsY?$3VR8~d`_eYF1ZXrt}R
zY6G;@QS2rQ_jRrQ+dA#f!=XP82M$)KM=O+n*>3)GyXog%)8QKVaH-~Kh4gKq`tv;T
z=Vr&(-GQT>z8~9zKi3<hFzwnN8+XtvS5cc+{njq~tQvZ)8+xwkx-BDmu1or^%eqb=
zMo5;=YCC}pr!UyE)NP?nf<9if9#MZcsAk!J{%s$$b8oxPz3EVS+j-usUCp#j)wJ#0
zs}`jfbj4>hg=f^WPpP1T3Xcg2k7{1HQJ%Qh!(mW3n+pk;d%nHKejv`?H^{g})Pz;i
zl1<tt3nYHtB4P1;(wcS3s%0uzj_o%IJ1-OVA4P3GkKcQeaA+L6_bC40Ny5R?#Lur%
zzTZ##@*!<zy0c`ImNwmxGRDNPfa*O^Fx!Wn=`CFts#;{x)>zc->H59dhJ*RK!v)H6
zfAKIqakevOeV}xur|@9D`RiKym$jxJn;pOJARy%SuPgMQ+il<1o4>7fuz$AF@pEtd
zXqWZlVCrah^ykh%4Q=#Z$kNTggInnJTc~xTfQ_qu8<&07482zjz1U6PebK;uLDzLo
z+jUmUc?Q}=r|AohQyLDFnl_^v)*}~eM%1nPFIW$1yzf=F=vK4nR)5=}Zq|-yyy;Li
zZ9QkweEwC7%1fHcbDGjqs`673w4Atz^qAPp_=E@~#}$pUMUhO=%m=}&CvaLfZ0dEy
zsA<fUS?ru?%z{bW%FE~_Q}6^6*Iz_$JdNFY9KG=<>eIuR-3QS-599V9#~(aRIDDS=
z-7@`vNUa;GjUR3Vf)sWI0X|u0##~SSbbs-uDZ&Cc!Q++dlY~`P_5M8J^CIPFmA2ep
z2oR0guDq>D!qFQ2aIx{{M%Vr<{b087w~h9r&Cb0A%Ia|0(N^2nP3GP*jnz}Kwbc0;
zwC`a2`_9C~$C~MG%2FSl+1U6jbm2B?^Jd`Ab@awH|Fx@r$m$h8Xe)-^O9ozx`kwQ8
z9&<WwGdiv_S}s$XPLmg%SQqU^HEl=X@q%sN1)F|N>prb_J(?EXnii0tXjeC5s+loV
zU$>}1Go`7$qN%>5syw4Wiw{C2heK`N7;IKbDJD860act76&_vU8PRALKk+1T>K-zO
zJP2938@_%wdhKrb!p-odo5=c|$d$Xu#{Gz`2ay{OqBhxsICl3*{QmRAgS!bw3F$Rc
z^w^n?#j6wK^@+NT75Wk|oR>N_*N3(?Mn0_%Z*LDCe3}0Ine};<ez@BDeVYl`%F)iU
z%>~-gX3zgR8vA{}8^-X~JZ-io|4(GE^Ju5zXn$aTz3phP|L5V*-@c9=?f3n0H1+5A
z#XpbMetw?&ZI89J^l`2iKh;+JJYxP<#Norh^?N}Z_X5{%1gsdLR<5I0F8eNnGG6jo
zG4P((_nOx8n9}o@)^VNCh2}K+kEZ=$RMT!)%eGJ3s$1K-N9%p}MN6bh^IeywCG&!L
zllq%xbu+rg>qd>&4Qi$&)mOyG0IyIlH<YVmgs*oJ5}pzsn22_Y@URSbe4Q2URhWSZ
zO(NJO^t&VvS|$v=jvIZGxcD+|#W;HHUfdSgS)<?`BV_AV?9KzwzQn`lNnf7E@3m72
z8$+c#OFgTjRXelQ$k*NO-+ml^{r=^*zx}!Q?eNR*2m6P!d)os)zRVnbo&NcC^l#r-
zYvbhujmcj(+Wwy(^Z)X7?C;-3{`@w)F-MzfirXE@*&NB(94b6uRqTwG?yzth!$oW3
z_=EM1ABW>pz4(Kj**|{Y`nEeU-$PlRZL6&(n}m<tMRp&CuH6gWxPt_(-U?j4iC(%H
zuyVtH?YiIcRqy#LUUR?N^d-+p19z6b3ro)##5ktoIH=<^tm`nOYtyf50~xZ9+BO|J
z)}7k#+q5iOFIu!{zNy!IP1Q7`UWDVQrZpiBZ^B*Q`9VP~3$p+RYhODHtLG1%T-Ecm
zeiPwl+W`a(8j{~hEAMH<GpQ8~wbhMOBCVcMMIcv^DP<&jZgp37c~4-`sAcBz^R%5u
zX`i1YZ*;U!4%QkcI*VqzGqxsb4nGZk`?9&aKYRFj`p0h@KaaK#KTjQfVSNE*`Z@P)
z7ks<sjY<4;SN19k_iulU{{6?`-+%P~@ug#LxptuwgZw^U{B<;OcPMUuIB91vd3Pdf
zXFOwjDC5U+-JhR_RyxuS#wxZ(Dmn_B1_+ohJF{PAspa^NhtZp0;vORF_rq52hppWU
zS-BUyb}wlCHhT3I2-0u)nm34$b=jMB#e4FK+tg*ZDMPn0eYYV!=RtkPLBkJ&dUpN#
z_8;{S`*v-cR$Z$WX!=&Iy4DQs_e~efY3gR=^QPobd$SO?_udu&)qIMwdKv0s9_?$N
zmk?Z%9g8c*v@>cuTB)s##AbR;E4`|{sj7oPVANN%)?=AeY;SAL0F(H!i7?Pr)7e~K
zL$1rHWcufg7v?4}kCtyu;8sU5pEr<(@1I#mUnjqRojm$J_3i7#(YJ}C?_+=aedS;O
zzWukKD}VmB@a<Fm9;<AahK$ie)&`Rnx}w%6^4ErPI<ao!jZy#pt?9>l>ET5D!D#Bv
zP}b&P_U2IbA*=YyRK?G2#=&g;N>@ogK74hYvOV3%EDRW-VOBbdtiw8=Bz}Ds^9gwv
zx%xP2{UNey9KLoxWc_yF(w(5?+vr6j-`VSaQ%1h5tKMVR-A7;}%1w{q>#ifPs|Pko
zLA&G#tGeB~_Dn6iPHnqhcC+o!v8dHGtJXIuyZx@n*fQJ4?6I%;!z7dq6-v_K(i$p~
z=oLv!Qg$;jhe^q2Pzsw65|&OZq2hCDt23#@+%|f3M+>>7v5H<-&Y)K_=rxQ+BD0Ca
zY^?p*O6q4+(rU|ag$d;efHm>ho2&f3Lfo6HIb5TE*=qg1-n2JYyE|X|ZN2emqxtAl
z>+jp0Kew6=mn(KySzDuppO;8K4qE>Hz58!png6oWFiZ)VZAF6q<9q#|hjrf<N)9G-
z#_9tGaULTCpIKVi05NR2Cu?iG{Od~n{sL)lqI#nvmyzK<)s#I;i3*G(8^;~qPyF;G
zW`n(=fXqLOn0p#F`zUzYIB3c^X!?G@<Q>1UTYkegeMYW%j$H8=GxQk0=su+HF|6w{
z1S8qdap;PBFJk1{{J@U**sjRLD#qfqyOoK#i=~B^g&Eq$9A)`3!v1+S>U~>jWM_F)
zFFt`;5z|(aN{4#NB?*k0?Do0>Al!Ghlr&OuTN<jFO@x+)s<sviqmj_ogzaKfbTnf-
zns7`yuA`~4ja*oniDZO0rTW{4*qH>{zbr}cT0jPhmuG4}t+pL}YTw)J+*<3{-RL{m
z7&zGM{kA{)$B(t2N7FmY4WGAKKX3Manx;Z%v9r{?K1beJqJI6<asW1FrSaQR?fyJ*
zZ<??%QL#H!xi*x$w^+MARsC(D^7B~kc2C-7Ptrn5^lDe;Tyt^{DRH(rtA|_^p55+Q
zjO;pNww}kWK19~;gst5STD}{+cn3Xu3&pw}IQ}3M_LR*T2TZ&`_nC)w*o4)4N0PnK
zg>F8XF232Go(Z;=Za$7~alX!>j!@mrG|b*Q$l-m^hxdLq7M|vB+~1mIdcB(OE}N#O
z4q#C%0y0Za*crypb(ifgGg%#_jH(2rn^rj3Qr6#$9qA&Bb`uBMYx<dluExslrpnHy
ziVk`Ov!SqwoYme~QkonR=WCN5<QU@yAB}Ommw6sy^N|=aLJJ$DMgoa-Z?$%3g?6;t
zbM(3G$G6dc``4Yn|Le-X91ZL*RM(T@$+(32;xKY<7$Fl4MeZt+0?JbY2uKdXsLAMU
z%sE)9*_gy0t<|mc7IamIZI0k)n$u=!@e}0mS$g7H8)m69d--GT_DJbOeQZZrSbsUv
zRUF#iQZX~$Ixsd++tgKD)tQ*b49Z~oMYni*q^E>NCB-J9T%!<=pag&aXcwnA7pI(%
zfWoNos`QkiXaI3J_}U`xLfoCxgMAXbJ(7I=68(ImJ>5}uwn2{ee%9|$c2<N)r>_h2
zg~76+634Mp_l5S1X-4uyL)_*V4yfwAwNX9f#334Hkd`sYES_pD9%1ARGxLWT*j`3a
zcXJ7oQqo$R--M4UjrK`LIi?0UWS|@hlYG*m+`??{h1fkorh96>Y<KQ1H7@k#&G#0p
zj+9P!=gjux%np?-j8qL!a|VbJ)U*%jh#kOUTe0Dc%8;hg$VMotS{~DciznxW*JK4%
zW%&11g^kvQP%xI{boc$GhWWwrPXqWVTJ}IS(q9uX$IKpYOkC;8n`NX=Hl>V^6UOT@
z`|z=y2rhoQt7f1!kCGai;P%e{-Ajl2_ut*V_1fs#tIJnSjjlg8y!2R4-&kA!hU&$8
zT9@wY>b<#p-^}=l<ukJ=Z~yGbu=HTRY$PZv0uAh`6qI)w+9y58H$BKF744mZ_NFFz
z{8;MP8LjRwbDOI2nW&2%CWVhuklBumk;b@%UL<#Epy<;Wc4Hh5l$yn%s^y`w1&H{W
znPW{Eqs@6Asre06Y;Xy)C_dKB9Bui?%k)+z;+7NZ6XN*d%{ATn;*`D3zU|enFDosF
z3&icos?AB#=l$`W)sD^i#`OvELVrnTbyRJ3U`u&qOIc`bfp2Ri!l;bwBqel_l8}ay
zNJ@SvIR`~A4Cup$<0Icua>9S#Za-LVJX~h%PSt(c=sMi#-2KGdnxuT4Z`hxvYz$+k
z8F^#WoZ<Q$LVC3CTZ?B`ZX29EuO=d^DlB`BUshRAT2)+5Rb2MGsJyDEf}((oim<G@
zgu;1|vkC$d3IgKiMI`m*<u5BMn;}M5JzhQaF*ggcHji+4hd5d%csWP9*u{A|C;7QX
zx!KV%em~a-)`p1PxX|IM;GwFZX<9ss8V8I0Gi~V`BW0_jxGk7@CP|;B>eeUg*qNr`
z(uub8Axdl?IjMt`PKS?~m_f=2`tZ;o*y^#5`Q5Y-XM9$4sM9Oppxx-IFP)iaT$pAq
zu^P6PyAQYezHGI9+3eVvs@fXQ`!tffHB`9NU)Ed^2^)myrRZ)_bZ>2ZJ3eNjIe(xw
zt+gVCRvgw;5?Pn($S6TA^_3s4)O}fE{I=Th+bZ+(V)Ncy{nzEjpSx}A<J8G^+)xv?
zlbqW@%IhGN+C6-Vs0oRyiOTBBD;u0uHjq&=kW<o@lGBuwRTYK$?xGsvvg%^8sv=UV
zqSEJtBvk~(;ZcE4R7F5UOIlh-R^CWi`LVX9nbDOG#<zW6KXrM0$IJ9_pydn1+BD7e
zb-MeT-pcqt4rW*S2>lgdQzRG*p(FJP(+tdHYsTWof)!+>Vq=!Jx6*pB!q{1$?=3WM
z%u`k;D<>Igj3O`C)7O-XZYv9IERDzrwfB8{4{iC-%j{OTt63!m3AB2WhPEDVD(Gy;
zAL=1a4pHH8tf%V7&fv!4An=^#Targ9q4P~K{lw5#d}Mo7WJ@`!uQsx?I=CGlK2Vq1
zU5!MyU=dnTa8pUxd<zo(&S;2UurQFnIa#$kL;SK_yETRTGDlwS!!=?tB?*C0#F&&F
zPcKUYx?oXUkSwQwf{3WBh|oC^@vHLZFUu<H$tmf|D4rJ*S2`o2z$b7)OzNVzw5p(}
z(ix$1!lLIz#Gov(<S8zxlTZr%lsxYlL{&^eOH%BX@>z>(x|T-z4i9d4zq*T9-plbY
zEe)}$i2ShJRq@;I{MK|+KR%RI89YjeWYxtlv|z@Yl1G~o7W<25x=ZJK%4fPuR!8tF
z?0pn@OCR%RnHdA5xDISMImMZh=u#Qu6z^u@|Nfr0rE!48lTa7aoJ4<=>CJ2qVmA#l
z(452ih#wmukN4IRih@@sNqY;8@m_Dc3jI0@K8)afy0Bht_@Hhw2++TyDu_|(*HMjh
z5n>tG5C%4~1q(Hb!&YZnQqhhhEhXPpTlQzE`?Ix>fB0j!ZM>s0)X^lw?!Dc^hZ$kM
zlbwXF+JctK^so<a9$iK*-__HX6*wcyC#Wl{pe-S%0lFqAe*TQ8y08Rj*?A!`by2B{
zl5%h@cbZL7gi_5=?G!4RLP=B6W2aR3_zY!Wo1*khC7H*XsxNdeez<of=+*6r*SB(9
zOpE-?_QvTyKQDcnpmmp_Cn|#H8WN}Klg4V37CH(hn=_HArp#IR>uH!_a_n$z<On5l
zh!{RZiW;qpX)8n5rMXd3-0IWZ@NrIQ0p?+@F9NKep{-1!ysgrs+}$4Q=A$hqJB#NA
za0}zqrRlc$VLCp`zoQ;AIZ{n5LVBx_#kQo$2BZt;-$McfY#amY(@}|Puk`P!j$#xC
z)+5=Tt>sZbg(ByncK0W~eVN%=ANu{r`q9zqm#=eQ4yOP9$4;<|^<%AzPxW+lrKE!G
zY^qYCtMfBjX~dD?j)l45zNVVunBW)JuF8u_$iw(NBcgIfM44YinNLW8hac)(%ku(P
zM1)O4;$l}*hicXGJiGw^gH5uMKrfNwIH@Noc3I)<EoFsUN@uUhN#2qd^M83e*yLKF
z=SwWwbbq|<$Nn@d@H2D0$ErhTX>o(3=!urB<*xj-?t+cJk{KAy^px@X#EFLFg|?je
zuH3nvya`5XA0eDk=--rwZqD;%mPcR{T$4~%K@P8d-@i;ox#q@r$GX2ns*_xSj|E0z
zb(}EXR*FwU#k##{EKl6q8=n4%9jHMjDZx|J(Do9KUP^QiIf9AxZ!Yj?$aZco4Q|Z#
zCZ{?#m4?zwLWtQu>kFMfkCr!<yY@F*4<~B2=NNzfeRFY$c~?#GhU&R1^0IpJ@>i4;
zpX+J6y*0(AC$^Ex`Vbm!u(5cIUW88x(Uy^x=ND5xBd97O4tfVOqv{z^Hs<;lDjllq
zLLp~Rz_Z-k3Ou}ue0%^P23&z052uEh;6*9X%hD20bTr-?UAcQ+!P)pywAI}r&sW7h
zroU}Xu8h)~GCi3&-u*cA7$tm?8Z%WNJ4%Ziszah#%_%H!3R*E!Ow3Ym!P;Q)(g1e$
zV;QS8x3?~-lMn;b7A4oCHqW;*(JS89+TY<#kegkUmt$6(A127AArswE>@`szK3X3~
z$a291zfVJ%7st9z4c8BKRg6@l1`1t=@V<;9myaZ*vnq&*MFWwMmgh~)@gryWAS8@u
zLw;agwtr=e!%#!Y=0e>#HFmZ!ye7)FCOM#?JjvPg;S~kB>+0tW<YjbZWiLobT~;}N
zPg4_RWl|98)>H^v<BI$0v%AWZ-d@v|;}y^p7ds~;bWTuERY*vYht1_;%a5CV0hRid
z1%ctrFAog))7&y#T+#>^rz9uT>F3vx5W6HJ{#Z@P{)V3IO+CjOS`nt#^ITsP`M&(N
zJ>EmXF!Q|ntH5=Mny!tWYmA$wCl1ro2I*-t-G$Tb`J+wgEN0gFX!Xia<w9Tid=GXK
zh~7=v19d6w_(&+MPt5cxjdM@(vkG#t0Hj!?mt9(<Pii3YVVs)1*qqFwM)g#Mv|~f^
z!|dZ--xWoCsKp}PjMAP8pGhKm2#0FR^Jv2cGjTyJ<v|UFeziHCaO4J9&o!xT)ck<j
zOrO%Ax4mTn-`AQ}hM?xXhlk1iScliIuj^h_QM#mf_L7{OzO<CKl+*<=aa|d?3z9N+
zkM5Tz_#h1haU-<+L0aZaYi=gW{+xioMG5vzY9hh_T9M}gDFH@Z02*8Mc=*6(0M!7H
z29lf{qNg~3Lo9IYgfthI8Xvczv<Q&N%yrewFKIa4)$w{_m}2*&BIxzXB%`Z3zNaDt
z9MR#rxQY6-Q5t5vH5()}g>=FiPv!Dp^~x||b(F9%MgSQu58@X3D#qLLdnt*)qOQyF
zs>|@KO7<#>_s9se4RM5|gjKMsd5oWZvbV!bXTjDyerdR(6&FTG^~wmfaej3-2XUx|
zE%k(iq1uqyx`4&nC|aT;Ef>Y8jA*WiYJfN-2UVMkCTAePZ1kv1cBx5nt&Ff4qDIX!
za~XwUlcYG*>nr!wRG#Xo8>uN6$jj?X$>~YSYKlu}h)P_PlsbDx@Wy$ysszuT5`<No
zGDt)=Ix>l|uDTMU8e)=a!Xh9)pwz$|CwlxOh!C_72Jo*7_6#V;ds_132|&^#633vb
zKc@^Qrvf*Zo+RIG1+i!6<<0a}9qwv7+|>**y;&XcZkmbjs)}#T3xHk5eUwDl1v*5}
z9B<8=>BB9JlJ=Hbb{8NFWo*q-KTVN#7HK>44J)IB$?lSFVm#1Ax@)4l2yu++<Wh`(
zc9aX^ViD!#5b9?e>|~LH1iKu}*RQcER)#AlTC+$w-f4kW@m{Zze9aQwU(<`jCt8cg
zYeE-D!R0a5xU7IW5M6#qU2z04FPNGSFq}|QRzO+2b76>eX{a5mA)c1_wgrc*valIp
zHrM1Nt|^|qa#mVjPF7P=0z?9=F)c}HZAmFjG0}_S5<xGKYl9WY5+ie@CS<iSG1K#<
zrnr!Xn7FEtpo*Y?5<j2xsgq!Bp;$ds5{ClfZ~;spIc^xSfNeP?aRLnSX+R=Ko;oSd
z$9q{;<d%|{v4*^fp_=_2Z7*ZppjTIO{ml9)nJqvv$9VKsMD~#4`e`X+%~`Crf~lTL
zWOclD50?LzTK86%8*@#Yi>(_AEo)PC3xidYA4~gbY2BolE@EtVU2=C_R%w!N7UCZ4
z0GY72;hr`D4sVitEq7<A8<RCNJ$XZnbX=N8E@GP*{65mrBqzY4CL6u6HoP`jyERYj
zqGsV!y(qbX#7zHcj1N8y@Ogd&1mi=%_~PQ-OCuaJyiDfXbKC1O_jWe^^FRM%YrgZb
z)_FZ?34JM$mAHnun7WvVx~Pbnu&Ab(xVnh2f&5w2<Ex|yoAK(fo)R>xDm>BQk($sM
zHBm8@GyEWJ74T~~*}{Vcasv5*EJ2VmT&K?Ro|fj~l;cL&+6blC0c$D8!(*f<b5l|J
zftvD5{qqj@bUlr=V{Go__`RhUhEUVp+VW6?)o}y0DPxSB(dNwQ&f=-QN|4|7eDlgA
zZF`xyyVAZf)3C~_Utv)e1}Y~yipH3^-Q@UYY)At(n350fs~ZM!i*Pd!{9qd9Z5tEd
zge3S{?9S95Z8DZ8%IC)LlYRJ_?0|T0P{4PY0p^Wm$hW=0qi?X7-q#F_qZCh&URA0W
z$P6xOGJJ8#9>vjiWl`W^dS-gQrKfn8Ar1hR$Hsb8XNKHXmDiV%G?bOlWzT)m+Ts%G
zB4R26LTbW78loasRa6k<jd7v-^Pb{>_WXcBY+#Uyk(!X8sxaV~1wqux0%s)tQNI2c
zI2*Xd06_bthEU2L%GZNb*_;GP4$#e$vfSKy5@OforSG4Ye|S;e`lhDqy^AUK_lo>Y
z>eAidkk3bK_$V=Pv>|hXna64`oari^f&HIz{rLGI!rTaXiA7yw)o)DEK26cKr)eug
zcrYX&<l#n47cs608%oU!sZK}bBzvWXx<{j2B0`*^1Dq24-+$j~|NM!*I9f5v%xkSm
zD313?541`{Tc&wiv{%RezSsJ1e@tx5HWvoItxEI8r+R?=s?)q{(tY3p!6kVTGXhFu
z-HHNjQ>-6Vc)d)wGrp&;{P3dYO(l6lX>kMDUjh`D&=M8b0MS7#!7F(F3}7k6G(?1B
z-#@91cIz#TYA;01HzxW#y{>#lNQs|UftOd2AIvUW%g*xhf#iP8ef;1I%ARJEGT|v)
z$RXg~a04U<2m&YMc(}FUQ-Q-~8nPC*^_-tx_IP$F!r}%Y-kzLj-InjwR}(x;Nntgm
z&h>!Rz^@G87kUboMyofMnVSpEn~N<=6BJm$-kopSha4S?vc{sU4A;Q+g29ILu9{ew
zyGSK5_^c=l5)d8a9)Yrt@<8k|0v&$e9atL1ewrXmc9k{Z!;2z6MA|*X071#slvWb>
zx4pJ6i}+r0c&f)+0wxd#)Wb9sKFOyt(Gw46)6=}hd+X;Xx*Lj9N%4V2fmTlqE-H&c
zgvzHUE2#^rC&51dbwL>5XAn&Y0;oy>9O5&=7sMrv<Yf@wN7o1;4jnlG;GMB3G478p
zE1waN<2fyN8k}V=z$3_TbN>V2A#sXB<}?>fbHB(OK(l2#(ePAJ;0)kj;73Y=XVk=n
z4cUkFWF4N~bA5Kp)mT5^`K9u3=h`?+W~SRfRp1aIda5yTp|=!F?)nH}4(Th|TcSgb
zV{@))XNj>3&g*jD;d<}aPwndy)$;?8j42#vWc1T9AL~*ng&{S0;n=jm#1M}NKS#8K
zS+M<^%t+rqe(dajVjXS_ZA>@U76cbYIHUo{+T}&En+d%l>gU&i?P<agJrx`8icj_-
zXTl5^SPiV<7*__7D{FmqcztvBKmP4Mk$?a9|Fv`YX<)EBF)B)3O8kPDkOquX5h0k&
zK$jHxV5&N!$P3yf44lH-=j41IT`q8X(VXb|u{fATjP-eZ3GM`xge(`Q6ek;40%8Qs
zQsM{D6KENDfNT^KTm9ILTaJed+-Jb%NO5tV6Bg7#WF)UC%iK|wwlTiuV{+H$iDASW
zqkRAOeU%}dWvJeo$YE;o3^Q+asCsFj^3ynZbGjZ*x$Mq0!+2etsD%i5YpQXbRkJyP
zoA1e+?8sm>r-K7iTM|mgA$7&!*ks?rc+aQ+JH*%CAC^=spJFq@|K;cE*S*<|<+ibI
zq=Zo(p6K>6*6CS_w^^Ex88OXgqNR9qsd;9gVzf1nfs3OShLEz+I1H*Z&SiCR=<9EL
zD=Q1_O|^r)?E^iG-d0K<gEZ0Ky1TiCc5^<<&2>&t=-e4WMLvEQju0)Jg}93y!wSgr
z^XrK4dEV7cHocK=d#^U){a`*C@qK8ZBESzu1Jo1*{!4nC-~qzZbL<`gaFgY@`9XB>
zLBQ{l<z}lK2vFuUCyZS<_HCpjd-sC8#Z8^SH}@0lo))4ks$yK*^HAO8$N)8Cj8QcA
zv1+cTe7?7QaiC&#61<n1g(2e7C>gBC7BT~3B(1R^kwsn@t{m&gg(w7k#J>8JURrJk
zIin)gI}dS*^>aWwz4f;;M%%wEOK_QEW(`pj`YBP=91l{OM}DY%g6oSUk5^eJ^M*qI
z5qfHWV`^u0<a|HuOsJb1Ax;nAN7{;d8Z*d+NOoLk2&8*$%?eY)i*k{~qKuRROmbF2
zWI=LFZDo;{l_db?RD}hU&hRP=p7~`m*%)7TFu~7nC?VuvsD>EpXPMt7d%Wt3v39tA
zK?QOwAT0p_MP42S9(DsEo#i_%&j%DSL3th^)&V_}13G27Il&18ww?IN6Y@Mf06{^N
z1Yyb$xqDv9%IHF<`P~fX7e(kd_$Y_kSo=<F_;5qYcr#|EGiRy4a;_V@3e(;!d1oG6
zKFZEq<KAL3q${_l>Ni=`{YA#gICZ)QH`!S-)d9mdx2F-)PD!au^G^497wP)W!~AiS
z)9ZkD&#*D}(@n7xw3uN^cq>xiOHJ`8if}~ij5GW!aH(F@;;?pNN)I`?t~6+(uY7j6
zn$=seFhW=wsa_bwGt2!Ko5BL^U%5PcP?Z+WsL3Sf$JQ1l))glbav-OL!DYr?Qjk;R
z7di_eKLiha{8Aj?_HsZ@K!Th5s;sEfWsR`AI@xb-*SI{bM<LIxFR3a3Gm;PHHt>i!
z<hW16wG1bh_{me?KdXRY7KKC>KqYw<_~9OK{J^sTK-NiV0B3P<sR*6XlNB|R7q+;r
z>G9-JnAyz~r{{SAW_7V2dP>6w$kBt;xUr_R+1~PnJ{;JIgJs6XRQ>8WNU;IZf5`q4
zeS4bnX&m-W;bGbvp(l+sXN)vq`lyLrHQ}^e-@*{9bl>+;E*2i94`N--Jzw1-WTCca
zY9~92yGW7E<w0##(IwF?Ay#*@f~-mT!S&_Q9n@?}ZUCh$bgZ{xyr&Y}8&-ey^f;9@
zM(?Wd+oOK)eSO2<(gd4;Zbk4IW>r=nwTxMl-By!ED@-m=4!o^-PJ)vckY4|Yz93cw
zShVPgQ?k5#pn#Sa6@u^Sq?s6%+dUw9KDIJYmgD1t!`omCWVygc=4I<F2e8afg3UQ6
zDtul{SW%E4W<7;7d_b8NK6V_ahf)Bq=H*irMnrVwWp1b`J<(Enu7BRzNW<g4Hpnp1
z?jAkKz6XwmSA_zDaH_p@yuD<$AHO(4oExZK8X>KL(Vc|NclFydl$}|^+E@i7@aMbp
zrrR(R?B%WqK$CY?2T^l9iz2KNeBMSnT6meTIpaRB?^kCBZOu`8=|JxeM@X4Ilx)8|
z<U^vjSx&ekr8Ks!F0HpEtF1n#vmtlvBYw0SKi*qC)>}O}LhfxRqa9yII+)zm)JzGq
z%MNw;SX<mslEkRaZYSh2O4DnzBFU*C77y;8I(AGR<i~pkV7GwW=0A2!7%V9l-!(bu
zcY136w{;>O>Xq6)CLtcrtPPZ;xVhNYmz!;X*^fLh;@O_F_zAW?DuO8zICD-!2n>uU
z2Zs;`2M{UwPMnbB;Z_qnW1uK==Yq<ct6ERA6|IcaydUbKpBg4w-e}Eq7{dBb*2X|^
zxzu07>Moz^sbF<uL4NBj>gFtceU84lgtV?tl9mVa7KieuI>Ecn9%rNvHzqJ~=w_^M
zM|BV>%e6S{eXQNX=np0?uWoyoJ#c$%R9}XCVvz@$vO0+ow0!T1IJ<&S=U5N3vNSZg
zEV7f9(^;R{(^N3jUOL=`8|cChc2~h;e<yxwm}>v*j>kKT<WTQ;pZBGyK?svv&{CDr
zLC)zQ<}_ENH<YCiFd+p|zL4AFJ9bQzi(8VLSCEqfu)~5JCk0P%DxTqbe^EL3p;6FX
z-7NFFB(LWm4A0BK&^^s{7K{QHP@W*P00tB=#!f)G8HT>ZFB-Z$AHO^|ujr{$f~QWM
zIeuJ#<D?8f?>R(JNLO0oih}eboeO4{E}Ck}I$l+AzjhvVU!x`6VW7lslpH<Zoj==C
zGTB`|-cdT%UNqZ}`!rd%IZIn%)vip|Ee=EOB^MUYCOa}G+A{{}NyD`GPF!Gfp+{4J
z2RY3tFW^m_opFq#iMRPf=T~=}Ol}e~0w$Z&2Z(W9RY-7Ckq<8JLx#_r^Z>h>qVRfL
zOlN&odtF95E%#$fabH_`e+O=`tE#6B7DWqsT1#Hv*7dS{Nyp`uXGYYOrZ$yl;nE^&
zGGgf!*_6T<N?r^h52?<LtV)mZwY3oBIxWD#A;@_O<i~dsl;)%oH>bIpitoLv0k?It
ztRExHBxhSA4OKBw2z_DtW5Z2P0~hO;_8mVVb^;jBCq+)26g$Zwdh(RmDd4p6NO1!y
zo?G?|KNw;SQ2~8vC^{gnFE8^<SN-1kv(GhT9Sl@_jJ24VANq^DCmR!4t*H}DNh3_m
zFf((sEpxoHU||TiJX#IW+8Q!WTpq>G_T)`><xF;EPqbmiT2cmTqdLk^jXBPB7zc8S
zV}8Kf6xWxL4zIl58oQa^ae8s5BEh|@%)2VqtUlYZKHsY>(k9*4G}hg`zA~n<I=-nU
zsg0V+sLyR{$nT^Vb<&GlYO@;%=?#Rmw)(sm*EQ{*-3BOUd6G9V6$v23`v86spWw%C
zaelZs|C&Tpd9-I8CX|#Oc~)Hf3<r-8$0^?9$9PU0=RI}|!ZU3Nap!CL{&x(bUl^5p
zzO>Lgrz*@2+rarbdzx2<6Ra&4*bcB1kcSaGaRQpqsZ#)~K6C7t1lMW6szXy06uKZK
zj%Z5>=t>IeND3P%%b8!h`1XqCQw_OymsIU<Y4jEQkC37!n=>Zpuzs33(VQ~Vkv_pl
zo9!x@@5RpbVyAnt^8>iW5#01Z!FX5J*vIT)W?CN!>8=Td#5=9fy*}TCUhH2U>5%DV
z7VT&Xqu2laQ)knA>Aseo*igvT(2-IU3FAu1@J|b}jq-e3SC&*?k<?OyX(FUGQ?gp>
zvYN@+Olo0w6Sln}n?b{LG!#EFRKKR7h>P(k4gt=cT^`CNH{gAKkWB&FCfnm}nzKo^
zr)j49i()^U_cyQdaGVt3W;5yePaWqyd4luUv5V5uSC!5^QCAJQZy5Ouxt99=p^=n0
zB(ET71CIrUDJ&I%*Q_Ea3^J5B#VG<)-buC?1&$wwM==ggc0!+rPmYgYOHS&tqNJvn
z@OhCl+S1}ChFazZs&-dZo$hG4KhlTFR2>zOK>1@-#&p&swpAf8U-eSrKT;9~8ZhAJ
zO?BlWQ(gHpJ%y~!%#qd<R(nP-HL9t^tF7F>3m4d0;?q=wYRC_$h_+90eir=xah#VG
z+Ul9T@wFg_#{=!S&-;_Dl(@P=zxtxk;14h3{48rrqlsnFb(IMuYzz?_L#d1_NDr`m
zb>H#z3zU;-Mznikh?9|ul&XX<u=J=I0P;-rBP9D&C;Ct_g2`!6t}>9A>PyB1l2iQ3
z5KlF6Q31|V0vwz$TfqqCI(F>zu@l1FJjN<YH{`@)o?J;Zy@|1VsxKx0`2~;)_{R|H
zvEvOcUS$D6upMj|EH9q~=V=(jf*{3{Fqlt)=K`XY<K|WqMT88XJjhw8D@w9DlA<>h
zW!@N^x4xomYjn>3hAJ+~9vA6Q8D$RxjFRqIpXUb&`G!JNeZF67WjJh&A8Ae)XQmD`
z#P!rg^-*Jb$&u}qLCskIRzN8h`Oxz`Yf{{x6$HPFvwN7}W}f12i+=aS_RbZ0N$3zQ
zsSO{AG?k)z>Qh^5QZmEbvLfB^If0e=Ayq{Yr1DsNVR%JuP!R@oLtEp5jJ%qp_yuVh
z4QWXYaiNQH(uDjNsLw`951?RB<kW!1f~fj}C`JXQr973G6+zDmu1XG35EB*T;t=3C
zA;7jEC%BKF;5v4S_Y~(<1<C7YMT72XM<9=MT<=`e5afe^O@<SqT!{Dhf29c^>C6Y?
z7=jqE;&Pnaki`<_;^aGiO!)Z8U->__8>l8KqA4MvBOz?0D0^2!<%NO9yX#t3MjEch
zI*vEhNeRw`cqe?cLnUI@m>p1;1)r>UV}4L`QE*#jNDn!zpNd3`G{*GTMfOr6hiP&B
zb@8ph0WU&RGJN1xLaKX3tX*-qO}4*P;)f@3E^i{7O#`i-I~ZSQmWTI}kgmF<x!I3v
zs}ps&#MDsRXs@>wm|)=Gmgfdm<ibTnX;w&Cn*TjR%?rw^I?9R~3bJZ)(r2akFUm<)
zWrx@2g&_dh2Ih7hCgdYIhl)*LR%N$TW|DHlX&7H@On{=On80Ze;7R_IAi$G+Cr+I_
zcH;EO6W3(rUTLZN-qWk_vaq;r0K88%At5jg>;UZ-+ZtAoV2J)B1qiwZ8Yd2kKpq~L
z2Sp&YdWs8XK>iaag%OSuDgxZb+8PG35_(di&n_xIy`W@fsP6hm$LFyjIoS;=@m0s!
z*Tma5WO>o@d>}L5fsgF2j_kmPb`!(8h{0`DC?+f};)9sD0GR9mg<hZM3z_SdGK7@n
zT^4Ddi?+-|zfX307HIh}(B^4?#bf&iH;Q8&yC?}GACclIR?GBQ3!@5&aeWB_EJ*b$
z!JtdCf=aUjOEZH@Gf{=<VfQcVsw>D}P*Bv6JF6lgbyh^cP)Q2Fs{kpd=0!kerZz7c
zBuC1N1n7NjVO&E=3MtXEBEe5hRz~RbX%RqK@^JH?I>mSVIQMZ5&J)LV#KlZ>Rb6gs
zAr*dBZqFax&^EYwP8B9T&@2!axPI^mng~h<*U-rp;7JY<PEKJCP9eZKpE#i=Dk{mt
zBhJes&dsF>8MCuuw^gL>smk3`lY?Zm)fH9e8yE1AZk31|KFYZ!*0nkY)*GA|r6JU8
zUl@~+U2Q1|p(Dk9jEVq8xo=CkUo+OHx!Aup)019;{#cj7tcs;$!^$EZf$W`&wn%b$
z9%A(**!HRW^E)4muTe{5_P1s>*T-ka>66101~CDHwn;==<t2LOCU}>mp-R#Maud7?
zll|X4y`d~7rYa|=Bq^;ZE+sE2F2m0UwPKpf(kQt|cpV$cjgSjssTHZTqJ)+T3@JCd
zp(L4#39O9sSCtXxJaLTc_%R_6AP0L8^PJ=m<l%yhz2hzIXls*rXDhR7S1+jnS6)$u
zllvd?18MzQHDb#TbP&cf^h=!N6yxL)Wkaz!#5p)5xHuJfc@QlLQ7vhy%gXZF(jpJk
z&py*pGP$JoLQmDqK=s|FbEU!7xJbvEShvz(+mcW_VxlVza_5OI073_jdVNkneYSsl
zRai%LU~`ENz1X8U*PDuQug&*v!o^aHk*bV<yrB0P-X<A7W(jUDq8(nM-WuCKxaRQS
zQX4Vx@Nj7sVKHZi>qdHrbV_DQs6(9ZyYh_SlDvq@vbgf%=%T!k(t>#Nm-jUk<@MB6
zRHVd|BqU@61;tPE-qBKPDNiKjgi?#6sriwl!sxo1jA~3+eNlX4St=<f9I{^3iNPP9
zJ$P}`=;f_z`fBG@q$NbTPJ#A;-rQGLx4x#8>V&-Ze)Hz4lIlfiDHRc6c|HMIwqam5
zNOyq({$m8gnEs`Mr=>tWPxHv~@Ct)hd6H9>hf4#H&(dP1SG6^zC2pyneW@dFqOW3R
zpzM5C!`)aHO7Fq+hYPc*2zp0|cA_P_wdD8$hn|w-P099XEDS`NOF~=A(e0I}K0;VO
zIh;|3s>|^vX1Eg5y(;6JFupHSJf5ezzsNybruvvcd1BA!x8L2>cYJ=OIxm!7ozg+g
zX{Y6NG!@cG>2=j<R6+)!GP#*n&TN7`nboZ=m5k=fc1BfcVM1A9-1FN8T8gsgWo0FJ
z&)m~dtIb0wNEYmZiG`A>jpcETWobpxexw|vGCc&J8h}gkE|2jGwYNsw*m_&M33IZd
z<MZ%2NL7AZVvxrZU3FiRy9tgaZZGbr2=Xb53QO?u!vrUD1`?xSI8KB7AbkFnxBsUC
zLMJ?Bk7o`x<Q)<WuoZy=0%KKC5feQf2m@~`$r&rlni!~<T~@NZqT=*Gw<_M1nuTgi
zb*qoJZ^5`T^L#qXg4)XiJ4;a=C8&=TVO^DB-MHY9#^mKO;-~4lnXZynYzVEuw>I0O
zH1a*h=T(~Lt2D1yxhRY501MQcJI+t8TirJdae6^4io|B15JGWeU1cJrGO3Z6QBTUE
zQL<@Z2nbm;Qf>n|uaR6(Q<7Yf7gbdpNiL2=Ihv?Til38_66NB0c0~^aSeqMOn;#A1
zn35NbOARYcK;zScvB_wBDjFN-QxxtV;b<P}VjXC25oBkU7VKV~6H6_LX{$;pjd91P
zgyNCZu+#uY{j;*ll4qrag&@)sgIqIYPEYeFu~&b=8Dy^?ff_=C>tAeNkQ)bNV&q^o
z{WKTw?WMU-gYAIAUC;Hko@kx7G`jfSNcH^<b(>q7d4ccp1K&dqr7i<p637a`hN#%)
zB2*7Hun&u779d{C65sBMz)oBU9P*oK&+8#ZHx&g?b3CC{#M<WuT0&{M;&9ud5NnKw
ziT|71j?ZtH-_}h=+X87Gu;7&PxQe_mKsDEt!~zDKh)*Tq(}|TCfM%{E<knQA6DraO
zRoOL!g36MV?0B@1`gtW$VG%A4)7w|;3nCHl1FJH_ap|E2QQpMNsG=Ajc27n~QM6}8
zykAkcOW23kXj>DM%}c;^2Ux!KerslL`pW6mvv?2N+%T8SV3+)GSC1DDlmvvN1o?$|
zxdF&6%YQ~mKv<q%@GLJ|0spJPa^^pR;$IA8z#s!`8xpCI7nI}Uy{0UuFDZOYN%oP>
zx%bz#tgoor-qkwc_3Fm|g?Ic5D9i>P>+4*;bm_mL#`^z+8vm1utZVSk=l|zjhX3pZ
z^f3^L|LfjM|JQpj|L=RX&D>C)P6}#nUM^a`j?U@;K?Vdf%FW07zC8;1?_bl?(YXTO
zy1G{kF6&)^8=m_({{Q~$mA{W8`U7B>)gF7<yEr|!cX9jRp>RpdKnq~Wm$daRY3p23
zFwwoF@Y2`G`}r#cR}{+knznXOP>_}z`vve1UZCaU@1p+y`7?t3ot$}e6m+lf==}GW
z!X-mPeM1Fjh5znjBb(V@3f}*_&kz{Wf9Zoi<bU+(!>j&!pZ*mP{9j&cpaX>IzxL_>
z&-XC6^q1eKtE&Uw|L1GjeR_X+4|bp7Utengoa(>67W)4B|I>xOtAF{wK%cJO|9q{k
z!C&7O?z;pk^k07)%HQ72)5)KQ4bpz?779FU;9fuWcJ@)wWh)PWu}yt^Pzvyy;rbT=
Y+uk4b>tlj<)Hl%MId|^COJkn@7dPrOEC2ui

literal 0
HcmV?d00001

diff --git a/tests/roots/test-ext-imgconverter/index.rst b/tests/roots/test-ext-imgconverter/index.rst
index 786c92e8da9..f8ef1d6e2e0 100644
--- a/tests/roots/test-ext-imgconverter/index.rst
+++ b/tests/roots/test-ext-imgconverter/index.rst
@@ -2,3 +2,4 @@ test-ext-imgconverter
 =====================
 
 .. image:: svgimg.svg
+.. image:: img.pdf
diff --git a/tests/test_ext_imgconverter.py b/tests/test_ext_imgconverter.py
index 5f6f236cf42..b4fd46d2504 100644
--- a/tests/test_ext_imgconverter.py
+++ b/tests/test_ext_imgconverter.py
@@ -19,6 +19,11 @@ def test_ext_imgconverter(app, status, warning):
     app.builder.build_all()
 
     content = (app.outdir / 'python.tex').read_text()
+
+    # supported image (not converted)
+    assert '\\sphinxincludegraphics{{img}.pdf}' in content
+
+    # non supported image (converted)
     assert '\\sphinxincludegraphics{{svgimg}.png}' in content
     assert not (app.outdir / 'svgimg.svg').exists()
     assert (app.outdir / 'svgimg.png').exists()

From c2c2b81f9156c82df6d7795614736f99187195da Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 17 Apr 2021 23:54:44 +0900
Subject: [PATCH 277/305] Fix #8818: autodoc: Super class having ``Any``
 arguments causes nit-picky warning

On generating the base class information, unexpected nit-picky warning
for ``typing.Any`` was emitted.  This fixes it by using `~` prefix on
generating a cross-reference to make it valid.
---
 CHANGES                             |  1 +
 sphinx/util/typing.py               | 55 +++++++++++++++++---------
 tests/test_ext_autodoc.py           |  4 +-
 tests/test_ext_autodoc_autoclass.py |  3 +-
 tests/test_util_typing.py           | 60 ++++++++++++++++++-----------
 5 files changed, 78 insertions(+), 45 deletions(-)

diff --git a/CHANGES b/CHANGES
index 581be506e60..654500aafb3 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,7 @@ Deprecated
 Features added
 --------------
 
+* #8818: autodoc: Super class having ``Any`` arguments causes nit-picky warning
 * #8127: py domain: Ellipsis in info-field-list causes nit-picky warning
 * #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
 
diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py
index fcecb8bb133..957f8a33269 100644
--- a/sphinx/util/typing.py
+++ b/sphinx/util/typing.py
@@ -138,16 +138,16 @@ def _restify_py37(cls: Optional[Type]) -> str:
         if len(cls.__args__) > 1 and cls.__args__[-1] is NoneType:
             if len(cls.__args__) > 2:
                 args = ', '.join(restify(a) for a in cls.__args__[:-1])
-                return ':obj:`Optional`\\ [:obj:`Union`\\ [%s]]' % args
+                return ':obj:`~typing.Optional`\\ [:obj:`~typing.Union`\\ [%s]]' % args
             else:
-                return ':obj:`Optional`\\ [%s]' % restify(cls.__args__[0])
+                return ':obj:`~typing.Optional`\\ [%s]' % restify(cls.__args__[0])
         else:
             args = ', '.join(restify(a) for a in cls.__args__)
-            return ':obj:`Union`\\ [%s]' % args
+            return ':obj:`~typing.Union`\\ [%s]' % args
     elif inspect.isgenericalias(cls):
         if getattr(cls, '_name', None):
             if cls.__module__ == 'typing':
-                text = ':class:`%s`' % cls._name
+                text = ':class:`~%s.%s`' % (cls.__module__, cls._name)
             else:
                 text = ':class:`%s.%s`' % (cls.__module__, cls._name)
         else:
@@ -167,20 +167,23 @@ def _restify_py37(cls: Optional[Type]) -> str:
         return text
     elif hasattr(cls, '__qualname__'):
         if cls.__module__ == 'typing':
-            return ':class:`%s`' % cls.__qualname__
+            return ':class:`~%s.%s`' % (cls.__module__, cls.__qualname__)
         else:
             return ':class:`%s.%s`' % (cls.__module__, cls.__qualname__)
     elif hasattr(cls, '_name'):
         # SpecialForm
         if cls.__module__ == 'typing':
-            return ':obj:`%s`' % cls._name
+            return ':obj:`~%s.%s`' % (cls.__module__, cls._name)
         else:
             return ':obj:`%s.%s`' % (cls.__module__, cls._name)
     elif isinstance(cls, ForwardRef):
         return ':class:`%s`' % cls.__forward_arg__
     else:
         # not a class (ex. TypeVar)
-        return ':obj:`%s.%s`' % (cls.__module__, cls.__name__)
+        if cls.__module__ == 'typing':
+            return ':obj:`~%s.%s`' % (cls.__module__, cls.__name__)
+        else:
+            return ':obj:`%s.%s`' % (cls.__module__, cls.__name__)
 
 
 def _restify_py36(cls: Optional[Type]) -> str:
@@ -203,13 +206,23 @@ def _restify_py36(cls: Optional[Type]) -> str:
 
     if (isinstance(cls, typing.TupleMeta) and  # type: ignore
             not hasattr(cls, '__tuple_params__')):
+        if module == 'typing':
+            reftext = ':class:`~typing.%s`' % qualname
+        else:
+            reftext = ':class:`%s`' % qualname
+
         params = cls.__args__
         if params:
             param_str = ', '.join(restify(p) for p in params)
-            return ':class:`%s`\\ [%s]' % (qualname, param_str)
+            return reftext + '\\ [%s]' % param_str
         else:
-            return ':class:`%s`' % qualname
+            return reftext
     elif isinstance(cls, typing.GenericMeta):
+        if module == 'typing':
+            reftext = ':class:`~typing.%s`' % qualname
+        else:
+            reftext = ':class:`%s`' % qualname
+
         if cls.__args__ is None or len(cls.__args__) <= 2:  # type: ignore  # NOQA
             params = cls.__args__  # type: ignore
         elif cls.__origin__ == Generator:  # type: ignore
@@ -217,13 +230,13 @@ def _restify_py36(cls: Optional[Type]) -> str:
         else:  # typing.Callable
             args = ', '.join(restify(arg) for arg in cls.__args__[:-1])  # type: ignore
             result = restify(cls.__args__[-1])  # type: ignore
-            return ':class:`%s`\\ [[%s], %s]' % (qualname, args, result)
+            return reftext + '\\ [[%s], %s]' % (args, result)
 
         if params:
             param_str = ', '.join(restify(p) for p in params)
-            return ':class:`%s`\\ [%s]' % (qualname, param_str)
+            return reftext + '\\ [%s]' % (param_str)
         else:
-            return ':class:`%s`' % qualname
+            return reftext
     elif (hasattr(cls, '__origin__') and
           cls.__origin__ is typing.Union):
         params = cls.__args__
@@ -231,32 +244,36 @@ def _restify_py36(cls: Optional[Type]) -> str:
             if len(params) > 1 and params[-1] is NoneType:
                 if len(params) > 2:
                     param_str = ", ".join(restify(p) for p in params[:-1])
-                    return ':obj:`Optional`\\ [:obj:`Union`\\ [%s]]' % param_str
+                    return (':obj:`~typing.Optional`\\ '
+                            '[:obj:`~typing.Union`\\ [%s]]' % param_str)
                 else:
-                    return ':obj:`Optional`\\ [%s]' % restify(params[0])
+                    return ':obj:`~typing.Optional`\\ [%s]' % restify(params[0])
             else:
                 param_str = ', '.join(restify(p) for p in params)
-                return ':obj:`Union`\\ [%s]' % param_str
+                return ':obj:`~typing.Union`\\ [%s]' % param_str
         else:
             return ':obj:`Union`'
     elif hasattr(cls, '__qualname__'):
         if cls.__module__ == 'typing':
-            return ':class:`%s`' % cls.__qualname__
+            return ':class:`~%s.%s`' % (cls.__module__, cls.__qualname__)
         else:
             return ':class:`%s.%s`' % (cls.__module__, cls.__qualname__)
     elif hasattr(cls, '_name'):
         # SpecialForm
         if cls.__module__ == 'typing':
-            return ':obj:`%s`' % cls._name
+            return ':obj:`~%s.%s`' % (cls.__module__, cls._name)
         else:
             return ':obj:`%s.%s`' % (cls.__module__, cls._name)
     elif hasattr(cls, '__name__'):
         # not a class (ex. TypeVar)
-        return ':obj:`%s.%s`' % (cls.__module__, cls.__name__)
+        if cls.__module__ == 'typing':
+            return ':obj:`~%s.%s`' % (cls.__module__, cls.__name__)
+        else:
+            return ':obj:`%s.%s`' % (cls.__module__, cls.__name__)
     else:
         # others (ex. Any)
         if cls.__module__ == 'typing':
-            return ':obj:`%s`' % qualname
+            return ':obj:`~%s.%s`' % (cls.__module__, qualname)
         else:
             return ':obj:`%s.%s`' % (cls.__module__, qualname)
 
diff --git a/tests/test_ext_autodoc.py b/tests/test_ext_autodoc.py
index 8ace9781322..ccdee6bb2e8 100644
--- a/tests/test_ext_autodoc.py
+++ b/tests/test_ext_autodoc.py
@@ -1893,12 +1893,12 @@ def test_autodoc_GenericAlias(app):
             '   .. py:attribute:: Class.T',
             '      :module: target.genericalias',
             '',
-            '      alias of :class:`List`\\ [:class:`int`]',
+            '      alias of :class:`~typing.List`\\ [:class:`int`]',
             '',
             '.. py:attribute:: T',
             '   :module: target.genericalias',
             '',
-            '   alias of :class:`List`\\ [:class:`int`]',
+            '   alias of :class:`~typing.List`\\ [:class:`int`]',
         ]
     else:
         assert list(actual) == [
diff --git a/tests/test_ext_autodoc_autoclass.py b/tests/test_ext_autodoc_autoclass.py
index 9402633872e..d879f8e1491 100644
--- a/tests/test_ext_autodoc_autoclass.py
+++ b/tests/test_ext_autodoc_autoclass.py
@@ -256,7 +256,8 @@ def test_show_inheritance_for_subclass_of_generic_type(app):
         '.. py:class:: Quux(iterable=(), /)',
         '   :module: target.classes',
         '',
-        '   Bases: :class:`List`\\ [:obj:`Union`\\ [:class:`int`, :class:`float`]]',
+        '   Bases: :class:`~typing.List`\\ '
+        '[:obj:`~typing.Union`\\ [:class:`int`, :class:`float`]]',
         '',
         '   A subclass of List[Union[int, float]]',
         '',
diff --git a/tests/test_util_typing.py b/tests/test_util_typing.py
index 5a5808ac5d4..d85eb0849bd 100644
--- a/tests/test_util_typing.py
+++ b/tests/test_util_typing.py
@@ -47,42 +47,56 @@ def test_restify():
     assert restify(Integral) == ":class:`numbers.Integral`"
     assert restify(Struct) == ":class:`struct.Struct`"
     assert restify(TracebackType) == ":class:`types.TracebackType`"
-    assert restify(Any) == ":obj:`Any`"
+    assert restify(Any) == ":obj:`~typing.Any`"
 
 
 def test_restify_type_hints_containers():
-    assert restify(List) == ":class:`List`"
-    assert restify(Dict) == ":class:`Dict`"
-    assert restify(List[int]) == ":class:`List`\\ [:class:`int`]"
-    assert restify(List[str]) == ":class:`List`\\ [:class:`str`]"
-    assert restify(Dict[str, float]) == ":class:`Dict`\\ [:class:`str`, :class:`float`]"
-    assert restify(Tuple[str, str, str]) == ":class:`Tuple`\\ [:class:`str`, :class:`str`, :class:`str`]"
-    assert restify(Tuple[str, ...]) == ":class:`Tuple`\\ [:class:`str`, ...]"
-    assert restify(List[Dict[str, Tuple]]) == ":class:`List`\\ [:class:`Dict`\\ [:class:`str`, :class:`Tuple`]]"
-    assert restify(MyList[Tuple[int, int]]) == ":class:`tests.test_util_typing.MyList`\\ [:class:`Tuple`\\ [:class:`int`, :class:`int`]]"
-    assert restify(Generator[None, None, None]) == ":class:`Generator`\\ [:obj:`None`, :obj:`None`, :obj:`None`]"
+    assert restify(List) == ":class:`~typing.List`"
+    assert restify(Dict) == ":class:`~typing.Dict`"
+    assert restify(List[int]) == ":class:`~typing.List`\\ [:class:`int`]"
+    assert restify(List[str]) == ":class:`~typing.List`\\ [:class:`str`]"
+    assert restify(Dict[str, float]) == (":class:`~typing.Dict`\\ "
+                                         "[:class:`str`, :class:`float`]")
+    assert restify(Tuple[str, str, str]) == (":class:`~typing.Tuple`\\ "
+                                             "[:class:`str`, :class:`str`, :class:`str`]")
+    assert restify(Tuple[str, ...]) == ":class:`~typing.Tuple`\\ [:class:`str`, ...]"
+    assert restify(List[Dict[str, Tuple]]) == (":class:`~typing.List`\\ "
+                                               "[:class:`~typing.Dict`\\ "
+                                               "[:class:`str`, :class:`~typing.Tuple`]]")
+    assert restify(MyList[Tuple[int, int]]) == (":class:`tests.test_util_typing.MyList`\\ "
+                                                "[:class:`~typing.Tuple`\\ "
+                                                "[:class:`int`, :class:`int`]]")
+    assert restify(Generator[None, None, None]) == (":class:`~typing.Generator`\\ "
+                                                    "[:obj:`None`, :obj:`None`, :obj:`None`]")
 
 
 def test_restify_type_hints_Callable():
-    assert restify(Callable) == ":class:`Callable`"
+    assert restify(Callable) == ":class:`~typing.Callable`"
 
     if sys.version_info >= (3, 7):
-        assert restify(Callable[[str], int]) == ":class:`Callable`\\ [[:class:`str`], :class:`int`]"
-        assert restify(Callable[..., int]) == ":class:`Callable`\\ [[...], :class:`int`]"
+        assert restify(Callable[[str], int]) == (":class:`~typing.Callable`\\ "
+                                                 "[[:class:`str`], :class:`int`]")
+        assert restify(Callable[..., int]) == (":class:`~typing.Callable`\\ "
+                                               "[[...], :class:`int`]")
     else:
-        assert restify(Callable[[str], int]) == ":class:`Callable`\\ [:class:`str`, :class:`int`]"
-        assert restify(Callable[..., int]) == ":class:`Callable`\\ [..., :class:`int`]"
+        assert restify(Callable[[str], int]) == (":class:`~typing.Callable`\\ "
+                                                 "[:class:`str`, :class:`int`]")
+        assert restify(Callable[..., int]) == (":class:`~typing.Callable`\\ "
+                                               "[..., :class:`int`]")
 
 
 def test_restify_type_hints_Union():
-    assert restify(Optional[int]) == ":obj:`Optional`\\ [:class:`int`]"
-    assert restify(Union[str, None]) == ":obj:`Optional`\\ [:class:`str`]"
-    assert restify(Union[int, str]) == ":obj:`Union`\\ [:class:`int`, :class:`str`]"
+    assert restify(Optional[int]) == ":obj:`~typing.Optional`\\ [:class:`int`]"
+    assert restify(Union[str, None]) == ":obj:`~typing.Optional`\\ [:class:`str`]"
+    assert restify(Union[int, str]) == ":obj:`~typing.Union`\\ [:class:`int`, :class:`str`]"
 
     if sys.version_info >= (3, 7):
-        assert restify(Union[int, Integral]) == ":obj:`Union`\\ [:class:`int`, :class:`numbers.Integral`]"
+        assert restify(Union[int, Integral]) == (":obj:`~typing.Union`\\ "
+                                                 "[:class:`int`, :class:`numbers.Integral`]")
         assert (restify(Union[MyClass1, MyClass2]) ==
-                ":obj:`Union`\\ [:class:`tests.test_util_typing.MyClass1`, :class:`tests.test_util_typing.<MyClass2>`]")
+                (":obj:`~typing.Union`\\ "
+                 "[:class:`tests.test_util_typing.MyClass1`, "
+                 ":class:`tests.test_util_typing.<MyClass2>`]"))
     else:
         assert restify(Union[int, Integral]) == ":class:`numbers.Integral`"
         assert restify(Union[MyClass1, MyClass2]) == ":class:`tests.test_util_typing.MyClass1`"
@@ -97,7 +111,7 @@ def test_restify_type_hints_typevars():
     assert restify(T) == ":obj:`tests.test_util_typing.T`"
     assert restify(T_co) == ":obj:`tests.test_util_typing.T_co`"
     assert restify(T_contra) == ":obj:`tests.test_util_typing.T_contra`"
-    assert restify(List[T]) == ":class:`List`\\ [:obj:`tests.test_util_typing.T`]"
+    assert restify(List[T]) == ":class:`~typing.List`\\ [:obj:`tests.test_util_typing.T`]"
     assert restify(MyInt) == ":class:`MyInt`"
 
 
@@ -110,7 +124,7 @@ def test_restify_type_hints_alias():
     MyStr = str
     MyTuple = Tuple[str, str]
     assert restify(MyStr) == ":class:`str`"
-    assert restify(MyTuple) == ":class:`Tuple`\\ [:class:`str`, :class:`str`]"  # type: ignore
+    assert restify(MyTuple) == ":class:`~typing.Tuple`\\ [:class:`str`, :class:`str`]"
 
 
 @pytest.mark.skipif(sys.version_info < (3, 7), reason='python 3.7+ is required.')

From 48afcc4f1e6ead160dae44b9e9320c2b69bfc891 Mon Sep 17 00:00:00 2001
From: Arthur Volant <arthurvolant@gmail.com>
Date: Thu, 15 Apr 2021 12:09:27 +0200
Subject: [PATCH 278/305] Fix selection for safari/Internet Explorer and
 Mozilla

---
 sphinx/themes/basic/static/basic.css_t | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index 25ab688e4f3..b80868d7a2b 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -817,12 +817,16 @@ div.code-block-caption code {
     background-color: transparent;
 }
 
-table.highlighttable td.linenos,
-span.linenos,
-div.doctest > div.highlight span.gp {  /* gp: Generic.Prompt */
-    user-select: none;
+/* From https://stackoverflow.com/a/34372191 */
+span.gp {  /* gp: Generic.Prompt */ 
+  user-select: none;
+  -webkit-user-select: text; /* Safari fallback only */
+  -webkit-user-select: none; /* Chrome/Safari */
+  -moz-user-select: none; /* Firefox */
+  -ms-user-select: none; /* IE10+ */
 }
 
+
 div.code-block-caption span.caption-number {
     padding: 0.1em 0.3em;
     font-style: italic;

From 31718d78b46d99f556feb20ab3cc7e7f89680598 Mon Sep 17 00:00:00 2001
From: Harmon <Harmon758@gmail.com>
Date: Wed, 14 Apr 2021 16:41:25 -0500
Subject: [PATCH 279/305] doc: Fix grammar in documentation for
 autodoc_typehints

---
 doc/usage/extensions/autodoc.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index 1bfa8086c38..da0ff7c994c 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -563,7 +563,7 @@ There are also config values that you can set:
 
 .. confval:: autodoc_typehints
 
-   This value controls how to represents typehints.  The setting takes the
+   This value controls how to represent typehints.  The setting takes the
    following values:
 
    * ``'signature'`` -- Show typehints as its signature (default)

From 0ce7c1f57732dda24708fbd3f8f5c67f653f3850 Mon Sep 17 00:00:00 2001
From: Arthur Volant <arthurvolant@gmail.com>
Date: Thu, 15 Apr 2021 22:01:20 +0200
Subject: [PATCH 280/305] Add line numbers

---
 sphinx/themes/basic/static/basic.css_t | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index b80868d7a2b..5c1db3b842d 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -818,6 +818,8 @@ div.code-block-caption code {
 }
 
 /* From https://stackoverflow.com/a/34372191 */
+table.highlighttable td.linenos,
+span.linenos,
 span.gp {  /* gp: Generic.Prompt */ 
   user-select: none;
   -webkit-user-select: text; /* Safari fallback only */

From f12ebdfae4d9e7607244621af8f029bc529560c1 Mon Sep 17 00:00:00 2001
From: Arthur Volant <arthurvolant@gmail.com>
Date: Fri, 16 Apr 2021 21:31:52 +0200
Subject: [PATCH 281/305] Add div.highlight

---
 sphinx/themes/basic/static/basic.css_t | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index 5c1db3b842d..e5780f2d024 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -820,7 +820,7 @@ div.code-block-caption code {
 /* From https://stackoverflow.com/a/34372191 */
 table.highlighttable td.linenos,
 span.linenos,
-span.gp {  /* gp: Generic.Prompt */ 
+div.highlight span.gp {  /* gp: Generic.Prompt */
   user-select: none;
   -webkit-user-select: text; /* Safari fallback only */
   -webkit-user-select: none; /* Chrome/Safari */

From b8ac63bc951eb941ae2f50add9de89066dd03547 Mon Sep 17 00:00:00 2001
From: Arthur Volant <arthurvolant@gmail.com>
Date: Fri, 16 Apr 2021 22:31:57 +0200
Subject: [PATCH 282/305] Remove link to stackoverflow

---
 sphinx/themes/basic/static/basic.css_t | 2 --
 1 file changed, 2 deletions(-)

diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index e5780f2d024..45815bac0a7 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -817,7 +817,6 @@ div.code-block-caption code {
     background-color: transparent;
 }
 
-/* From https://stackoverflow.com/a/34372191 */
 table.highlighttable td.linenos,
 span.linenos,
 div.highlight span.gp {  /* gp: Generic.Prompt */
@@ -828,7 +827,6 @@ div.highlight span.gp {  /* gp: Generic.Prompt */
   -ms-user-select: none; /* IE10+ */
 }
 
-
 div.code-block-caption span.caption-number {
     padding: 0.1em 0.3em;
     font-style: italic;

From 025ec263f9f03c27f7ef2ade4b5b1d7a8f42fcac Mon Sep 17 00:00:00 2001
From: Jakob Lykke Andersen <Jakob@caput.dk>
Date: Sun, 18 Apr 2021 16:39:58 +0200
Subject: [PATCH 283/305] C, C++, fix KeyError due to alias directive

---
 CHANGES               | 3 +++
 sphinx/domains/c.py   | 3 ++-
 sphinx/domains/cpp.py | 3 ++-
 3 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index bb776bcc87e..929638388d6 100644
--- a/CHANGES
+++ b/CHANGES
@@ -24,6 +24,9 @@ Features added
 Bugs fixed
 ----------
 
+* C, C++, fix ``KeyError`` when an ``alias`` directive is the first C/C++
+  directive in a file with another C/C++ directive later.
+
 Testing
 --------
 
diff --git a/sphinx/domains/c.py b/sphinx/domains/c.py
index 1eeaf65cf01..b0711f68e98 100644
--- a/sphinx/domains/c.py
+++ b/sphinx/domains/c.py
@@ -3454,7 +3454,8 @@ def __init__(self, sig: str, aliasOptions: dict,
             if 'c:parent_symbol' not in env.temp_data:
                 root = env.domaindata['c']['root_symbol']
                 env.temp_data['c:parent_symbol'] = root
-            self.parentKey = env.temp_data['c:parent_symbol'].get_lookup_key()
+                env.ref_context['c:parent_key'] = root.get_lookup_key()
+            self.parentKey = env.ref_context['c:parent_key']
         else:
             assert parentKey is not None
             self.parentKey = parentKey
diff --git a/sphinx/domains/cpp.py b/sphinx/domains/cpp.py
index 4a36f6131a7..d57c6e25749 100644
--- a/sphinx/domains/cpp.py
+++ b/sphinx/domains/cpp.py
@@ -7177,7 +7177,8 @@ def __init__(self, sig: str, aliasOptions: dict,
             if 'cpp:parent_symbol' not in env.temp_data:
                 root = env.domaindata['cpp']['root_symbol']
                 env.temp_data['cpp:parent_symbol'] = root
-            self.parentKey = env.temp_data['cpp:parent_symbol'].get_lookup_key()
+                env.ref_context['cpp:parent_key'] = root.get_lookup_key()
+            self.parentKey = env.ref_context['cpp:parent_key']
         else:
             assert parentKey is not None
             self.parentKey = parentKey

From 58ec5c4089a6aaa1c638741b8ebe38f627e0c1d1 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 18 Apr 2021 14:54:54 +0900
Subject: [PATCH 284/305] Fix #9110: autodoc: metadata of GenericAlias is not
 rendered as a reference in py37+

GenericAliasMixin should use `restify()` to render the metadata of
GenericAlias as py36 does.
---
 CHANGES                                 | 2 ++
 sphinx/ext/autodoc/__init__.py          | 3 +--
 tests/test_ext_autodoc.py               | 4 ++--
 tests/test_ext_autodoc_autoattribute.py | 2 +-
 tests/test_ext_autodoc_autodata.py      | 2 +-
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/CHANGES b/CHANGES
index 929638388d6..f18c806e006 100644
--- a/CHANGES
+++ b/CHANGES
@@ -17,6 +17,8 @@ Features added
 --------------
 
 * #8818: autodoc: Super class having ``Any`` arguments causes nit-picky warning
+* #9110: autodoc: metadata of GenericAlias is not rendered as a reference in
+  py37+
 * #9103: LaTeX: imgconverter: conversion runs even if not needed
 * #8127: py domain: Ellipsis in info-field-list causes nit-picky warning
 * #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 5a0a8ca1041..c92709deb93 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -1767,8 +1767,7 @@ def should_suppress_directive_header(self) -> bool:
 
     def update_content(self, more_content: StringList) -> None:
         if inspect.isgenericalias(self.object):
-            alias = stringify_typehint(self.object)
-            more_content.append(_('alias of %s') % alias, '')
+            more_content.append(_('alias of %s') % restify(self.object), '')
             more_content.append('', '')
 
         super().update_content(more_content)
diff --git a/tests/test_ext_autodoc.py b/tests/test_ext_autodoc.py
index ccdee6bb2e8..2becf5de2ad 100644
--- a/tests/test_ext_autodoc.py
+++ b/tests/test_ext_autodoc.py
@@ -1915,7 +1915,7 @@ def test_autodoc_GenericAlias(app):
             '',
             '      A list of int',
             '',
-            '      alias of List[int]',
+            '      alias of :class:`~typing.List`\\ [:class:`int`]',
             '',
             '',
             '.. py:data:: T',
@@ -1923,7 +1923,7 @@ def test_autodoc_GenericAlias(app):
             '',
             '   A list of int',
             '',
-            '   alias of List[int]',
+            '   alias of :class:`~typing.List`\\ [:class:`int`]',
             '',
         ]
 
diff --git a/tests/test_ext_autodoc_autoattribute.py b/tests/test_ext_autodoc_autoattribute.py
index 48e897b2ed0..5e72202342b 100644
--- a/tests/test_ext_autodoc_autoattribute.py
+++ b/tests/test_ext_autodoc_autoattribute.py
@@ -156,7 +156,7 @@ def test_autoattribute_GenericAlias(app):
             '',
             '   A list of int',
             '',
-            '   alias of List[int]',
+            '   alias of :class:`~typing.List`\\ [:class:`int`]',
             '',
         ]
 
diff --git a/tests/test_ext_autodoc_autodata.py b/tests/test_ext_autodoc_autodata.py
index 907d70aa1a7..d01e45fc10a 100644
--- a/tests/test_ext_autodoc_autodata.py
+++ b/tests/test_ext_autodoc_autodata.py
@@ -96,7 +96,7 @@ def test_autodata_GenericAlias(app):
             '',
             '   A list of int',
             '',
-            '   alias of List[int]',
+            '   alias of :class:`~typing.List`\\ [:class:`int`]',
             '',
         ]
 

From da792470b66fcd88e915367100a64d6a51c1e0fd Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 18 Apr 2021 14:36:51 +0900
Subject: [PATCH 285/305] Fix #9095: autodoc: TypeError is raised on processing
 broken metaclass

The logging module is crashed when the target object is a broken
metaclass that raises a TypeError on `isinstance()`.

This adds a workaround code to avoid the error.
---
 CHANGES                        | 1 +
 sphinx/ext/autodoc/importer.py | 9 ++++++++-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 929638388d6..a13b2f3b900 100644
--- a/CHANGES
+++ b/CHANGES
@@ -17,6 +17,7 @@ Features added
 --------------
 
 * #8818: autodoc: Super class having ``Any`` arguments causes nit-picky warning
+* #9095: autodoc: TypeError is raised on processing broken metaclass
 * #9103: LaTeX: imgconverter: conversion runs even if not needed
 * #8127: py domain: Ellipsis in info-field-list causes nit-picky warning
 * #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
diff --git a/sphinx/ext/autodoc/importer.py b/sphinx/ext/autodoc/importer.py
index ebb60b38bdb..1a8ea0973c8 100644
--- a/sphinx/ext/autodoc/importer.py
+++ b/sphinx/ext/autodoc/importer.py
@@ -108,7 +108,14 @@ def import_object(modname: str, objpath: List[str], objtype: str = '',
             logger.debug('[autodoc] getattr(_, %r)', attrname)
             mangled_name = mangle(obj, attrname)
             obj = attrgetter(obj, mangled_name)
-            logger.debug('[autodoc] => %r', obj)
+
+            try:
+                logger.debug('[autodoc] => %r', obj)
+            except TypeError:
+                # fallback of failure on logging for broken object
+                # refs: https://github.com/sphinx-doc/sphinx/issues/9095
+                logger.debug('[autodoc] => %r', (obj,))
+
             object_name = attrname
         return [module, parent, object_name, obj]
     except (AttributeError, ImportError) as exc:

From 75e8862f73a09a269ef3a7ec7e06764a03ab6078 Mon Sep 17 00:00:00 2001
From: Arthur Volant <arthurvolant@gmail.com>
Date: Mon, 19 Apr 2021 11:36:53 +0200
Subject: [PATCH 286/305] Add `div.doctest` to snippet

---
 sphinx/themes/basic/static/basic.css_t | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index 45815bac0a7..db43499ade8 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -819,7 +819,7 @@ div.code-block-caption code {
 
 table.highlighttable td.linenos,
 span.linenos,
-div.highlight span.gp {  /* gp: Generic.Prompt */
+div.doctest > div.highlight span.gp {  /* gp: Generic.Prompt */
   user-select: none;
   -webkit-user-select: text; /* Safari fallback only */
   -webkit-user-select: none; /* Chrome/Safari */

From cf4d3da081a1fc4de4f88885fd07c82a87f8444b Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 20 Apr 2021 01:12:38 +0900
Subject: [PATCH 287/305] CHANGES for PR #9101

---
 CHANGES | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGES b/CHANGES
index 929638388d6..f4de853d222 100644
--- a/CHANGES
+++ b/CHANGES
@@ -17,6 +17,7 @@ Features added
 --------------
 
 * #8818: autodoc: Super class having ``Any`` arguments causes nit-picky warning
+* #9098: html: copy-range protection for doctests doesn't work in Safari
 * #9103: LaTeX: imgconverter: conversion runs even if not needed
 * #8127: py domain: Ellipsis in info-field-list causes nit-picky warning
 * #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.

From aeb00d81869287aef56f52173e25d2b792f3623c Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 20 Apr 2021 01:04:50 +0900
Subject: [PATCH 288/305] doc: Fix typo

---
 doc/usage/configuration.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
index 989ce8737ed..7b7a0a1d41d 100644
--- a/doc/usage/configuration.rst
+++ b/doc/usage/configuration.rst
@@ -186,7 +186,7 @@ General configuration
    Same as :confval:`root_doc`.
 
    .. versionchanged:: 4.0
-      Renamed ``master_doc`` to ``master_doc``.
+      Renamed ``master_doc`` to ``root_doc``.
 
 .. confval:: root_doc
 
@@ -196,7 +196,7 @@ General configuration
    .. versionchanged:: 2.0
       The default is changed to ``'index'`` from ``'contents'``.
    .. versionchanged:: 4.0
-      Renamed ``master_doc`` from ``master_doc``.
+      Renamed ``root_doc`` from ``master_doc``.
 
 .. confval:: exclude_patterns
 

From 1978c4a0cb59acc1980f8bf91abcec581b23c5e5 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 22 Apr 2021 01:38:31 +0900
Subject: [PATCH 289/305] Support docutils-0.17

---
 .github/workflows/main.yml | 2 +-
 CHANGES                    | 4 ++++
 setup.py                   | 2 +-
 3 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index f49117e1abe..f3246857609 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -21,7 +21,7 @@ jobs:
           docutils: du16
         - name: py39
           python: 3.9
-          docutils: du16
+          docutils: du17
           coverage: "--cov ./ --cov-append --cov-config setup.cfg"
         # - name: py310-dev
         #   python: 3.10-dev
diff --git a/CHANGES b/CHANGES
index 5edc80e3842..936280abb29 100644
--- a/CHANGES
+++ b/CHANGES
@@ -4,6 +4,10 @@ Release 4.0.0 beta2 (in development)
 Dependencies
 ------------
 
+* Support docutils-0.17.  Please notice it changes the output of HTML builder.
+  Some themes do not support it, and you need to update your custom CSS to
+  upgrade it.
+
 Incompatible changes
 --------------------
 
diff --git a/setup.py b/setup.py
index 1c14ff1ebea..b669afc00e3 100644
--- a/setup.py
+++ b/setup.py
@@ -23,7 +23,7 @@
     'sphinxcontrib-qthelp',
     'Jinja2>=2.3',
     'Pygments>=2.0',
-    'docutils>=0.14,<0.17',
+    'docutils>=0.14,<0.18',
     'snowballstemmer>=1.1',
     'babel>=1.3',
     'alabaster>=0.7,<0.8',

From d02a466cb50f059d938ea892f26bf4af1bd68d47 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 23 Apr 2021 01:19:18 +0900
Subject: [PATCH 290/305] Fix #9121: py domain: duplicated warning for
 canonical and alias

A duplicated warning is emitted when both canonical and its alias
objects are defined on the same document. But it should not be emitted
because they're the same object, not conflicted.
---
 CHANGES                  |  2 ++
 sphinx/domains/python.py | 26 +++++++++++++++++---------
 tests/test_domain_py.py  | 33 +++++++++++++++++++++++++++++++++
 3 files changed, 52 insertions(+), 9 deletions(-)

diff --git a/CHANGES b/CHANGES
index 5edc80e3842..71236232c80 100644
--- a/CHANGES
+++ b/CHANGES
@@ -23,6 +23,8 @@ Features added
 * #9098: html: copy-range protection for doctests doesn't work in Safari
 * #9103: LaTeX: imgconverter: conversion runs even if not needed
 * #8127: py domain: Ellipsis in info-field-list causes nit-picky warning
+* #9121: py domain: duplicated warning is emitted when both canonical and its
+  alias objects are defined on the document
 * #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
 
 Bugs fixed
diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index dbb315e6e5f..fb8a4d84f08 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -68,7 +68,7 @@ class ObjectEntry(NamedTuple):
     docname: str
     node_id: str
     objtype: str
-    canonical: bool
+    aliased: bool
 
 
 class ModuleEntry(NamedTuple):
@@ -505,7 +505,7 @@ def add_target_and_index(self, name_cls: Tuple[str, str], sig: str,
 
         canonical_name = self.options.get('canonical')
         if canonical_name:
-            domain.note_object(canonical_name, self.objtype, node_id, canonical=True,
+            domain.note_object(canonical_name, self.objtype, node_id, aliased=True,
                                location=signode)
 
         if 'noindexentry' not in self.options:
@@ -1138,17 +1138,25 @@ def objects(self) -> Dict[str, ObjectEntry]:
         return self.data.setdefault('objects', {})  # fullname -> ObjectEntry
 
     def note_object(self, name: str, objtype: str, node_id: str,
-                    canonical: bool = False, location: Any = None) -> None:
+                    aliased: bool = False, location: Any = None) -> None:
         """Note a python object for cross reference.
 
         .. versionadded:: 2.1
         """
         if name in self.objects:
             other = self.objects[name]
-            logger.warning(__('duplicate object description of %s, '
-                              'other instance in %s, use :noindex: for one of them'),
-                           name, other.docname, location=location)
-        self.objects[name] = ObjectEntry(self.env.docname, node_id, objtype, canonical)
+            if other.aliased and aliased is False:
+                # The original definition found. Override it!
+                pass
+            elif other.aliased is False and aliased:
+                # The original definition is already registered.
+                return
+            else:
+                # duplicated
+                logger.warning(__('duplicate object description of %s, '
+                                  'other instance in %s, use :noindex: for one of them'),
+                               name, other.docname, location=location)
+        self.objects[name] = ObjectEntry(self.env.docname, node_id, objtype, aliased)
 
     @property
     def modules(self) -> Dict[str, ModuleEntry]:
@@ -1326,8 +1334,8 @@ def get_objects(self) -> Iterator[Tuple[str, str, str, str, str, int]]:
             yield (modname, modname, 'module', mod.docname, mod.node_id, 0)
         for refname, obj in self.objects.items():
             if obj.objtype != 'module':  # modules are already handled
-                if obj.canonical:
-                    # canonical names are not full-text searchable.
+                if obj.aliased:
+                    # aliased names are not full-text searchable.
                     yield (refname, refname, obj.objtype, obj.docname, obj.node_id, -1)
                 else:
                     yield (refname, refname, obj.objtype, obj.docname, obj.node_id, 1)
diff --git a/tests/test_domain_py.py b/tests/test_domain_py.py
index 214cb58a078..e5616a6eb81 100644
--- a/tests/test_domain_py.py
+++ b/tests/test_domain_py.py
@@ -870,6 +870,39 @@ def test_canonical(app):
     assert domain.objects['_io.StringIO'] == ('index', 'io.StringIO', 'class', True)
 
 
+def test_canonical_definition_overrides(app, warning):
+    text = (".. py:class:: io.StringIO\n"
+            "   :canonical: _io.StringIO\n"
+            ".. py:class:: _io.StringIO\n")
+    restructuredtext.parse(app, text)
+    assert warning.getvalue() == ""
+
+    domain = app.env.get_domain('py')
+    assert domain.objects['_io.StringIO'] == ('index', 'id0', 'class', False)
+
+
+def test_canonical_definition_skip(app, warning):
+    text = (".. py:class:: _io.StringIO\n"
+            ".. py:class:: io.StringIO\n"
+            "   :canonical: _io.StringIO\n")
+
+    restructuredtext.parse(app, text)
+    assert warning.getvalue() == ""
+
+    domain = app.env.get_domain('py')
+    assert domain.objects['_io.StringIO'] == ('index', 'io.StringIO', 'class', False)
+
+
+def test_canonical_duplicated(app, warning):
+    text = (".. py:class:: mypackage.StringIO\n"
+            "   :canonical: _io.StringIO\n"
+            ".. py:class:: io.StringIO\n"
+            "   :canonical: _io.StringIO\n")
+
+    restructuredtext.parse(app, text)
+    assert warning.getvalue() != ""
+
+
 def test_info_field_list(app):
     text = (".. py:module:: example\n"
             ".. py:class:: Class\n"

From c47f8aa6d16616acce27a7708d622008d67c802d Mon Sep 17 00:00:00 2001
From: Chris Sewell <chrisj_sewell@hotmail.com>
Date: Tue, 20 Apr 2021 00:32:29 +0200
Subject: [PATCH 291/305] =?UTF-8?q?=F0=9F=90=9B=20FIX:=20`Config.=5F=5Fget?=
 =?UTF-8?q?item=5F=5F`=20typing?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 sphinx/config.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/config.py b/sphinx/config.py
index a9fdddc8a1f..418ecf4fbec 100644
--- a/sphinx/config.py
+++ b/sphinx/config.py
@@ -255,7 +255,7 @@ def __getattr__(self, name: str) -> Any:
             return default(self)
         return default
 
-    def __getitem__(self, name: str) -> str:
+    def __getitem__(self, name: str) -> Any:
         return getattr(self, name)
 
     def __setitem__(self, name: str, value: Any) -> None:

From 9019144590fe1ad056d417f8a3f814890a68ecda Mon Sep 17 00:00:00 2001
From: Chris Sewell <chrisj_sewell@hotmail.com>
Date: Tue, 20 Apr 2021 01:00:28 +0200
Subject: [PATCH 292/305] remove type: ignore

---
 sphinx/domains/python.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/domains/python.py b/sphinx/domains/python.py
index dbb315e6e5f..26cc4538714 100644
--- a/sphinx/domains/python.py
+++ b/sphinx/domains/python.py
@@ -1023,7 +1023,7 @@ def generate(self, docnames: Iterable[str] = None
                  ) -> Tuple[List[Tuple[str, List[IndexEntry]]], bool]:
         content: Dict[str, List[IndexEntry]] = {}
         # list of prefixes to ignore
-        ignores: List[str] = self.domain.env.config['modindex_common_prefix']  # type: ignore
+        ignores: List[str] = self.domain.env.config['modindex_common_prefix']
         ignores = sorted(ignores, key=len, reverse=True)
         # list of all modules, sorted by module name
         modules = sorted(self.domain.data['modules'].items(),

From 529fb1d1ce4be6979ec0d845c51902f2cbcea730 Mon Sep 17 00:00:00 2001
From: Matthias Geier <Matthias.Geier@gmail.com>
Date: Sun, 21 Mar 2021 11:58:52 +0100
Subject: [PATCH 293/305] Add mathjax3_config config option

---
 sphinx/ext/mathjax.py | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/sphinx/ext/mathjax.py b/sphinx/ext/mathjax.py
index 1cd2bd1cc16..301c0d69923 100644
--- a/sphinx/ext/mathjax.py
+++ b/sphinx/ext/mathjax.py
@@ -27,6 +27,8 @@
 # https://docs.mathjax.org/en/latest/start.html#secure-access-to-the-cdn
 MATHJAX_URL = 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js'
 
+logger = sphinx.util.logging.getLogger(__name__)
+
 
 def html_visit_math(self: HTMLTranslator, node: nodes.math) -> None:
     self.body.append(self.starttag(node, 'span', '', CLASS='math notranslate nohighlight'))
@@ -84,9 +86,16 @@ def install_mathjax(app: Sphinx, pagename: str, templatename: str, context: Dict
             options.update(app.config.mathjax_options)
         app.add_js_file(app.config.mathjax_path, **options)  # type: ignore
 
-        if app.config.mathjax_config:
-            body = "MathJax.Hub.Config(%s)" % json.dumps(app.config.mathjax_config)
-            app.add_js_file(None, type="text/x-mathjax-config", body=body)
+        if app.config.mathjax2_config:
+            if app.config.mathjax_path == MATHJAX_URL:
+                logger.warning(
+                    'mathjax_config/mathjax2_config does not work '
+                    'for the current MathJax version, use mathjax3_config instead')
+            body = 'MathJax.Hub.Config(%s)' % json.dumps(app.config.mathjax2_config)
+            app.add_js_file(None, type='text/x-mathjax-config', body=body)
+        if app.config.mathjax3_config:
+            body = 'window.MathJax = %s' % json.dumps(app.config.mathjax3_config)
+            app.add_js_file(None, body=body)
 
 
 def setup(app: Sphinx) -> Dict[str, Any]:
@@ -99,6 +108,8 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_config_value('mathjax_inline', [r'\(', r'\)'], 'html')
     app.add_config_value('mathjax_display', [r'\[', r'\]'], 'html')
     app.add_config_value('mathjax_config', None, 'html')
+    app.add_config_value('mathjax2_config', lambda c: c.mathjax_config, 'html')
+    app.add_config_value('mathjax3_config', None, 'html')
     app.connect('html-page-context', install_mathjax)
 
     return {'version': sphinx.__display_version__, 'parallel_read_safe': True}

From fde1f417c8e3cfc797538b96a58be9e080f71d99 Mon Sep 17 00:00:00 2001
From: Matthias Geier <Matthias.Geier@gmail.com>
Date: Sat, 24 Apr 2021 10:06:21 +0200
Subject: [PATCH 294/305] Add CHANGES entry

---
 CHANGES | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGES b/CHANGES
index 71236232c80..f390aade433 100644
--- a/CHANGES
+++ b/CHANGES
@@ -26,6 +26,8 @@ Features added
 * #9121: py domain: duplicated warning is emitted when both canonical and its
   alias objects are defined on the document
 * #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
+* #8195: mathjax: Rename :confval:`mathjax_config` to
+  :confval:`mathjax2_config` and add :confval:`mathjax3_config`
 
 Bugs fixed
 ----------

From 778faffecc1fbee8dda6d5af51fb0bd2209826c8 Mon Sep 17 00:00:00 2001
From: Matthias Geier <Matthias.Geier@gmail.com>
Date: Sat, 24 Apr 2021 10:39:34 +0200
Subject: [PATCH 295/305] Add documentation for mathjax2_config and
 mathjax3_config

---
 doc/usage/extensions/math.rst | 49 ++++++++++++++++++++++++++++++-----
 1 file changed, 42 insertions(+), 7 deletions(-)

diff --git a/doc/usage/extensions/math.rst b/doc/usage/extensions/math.rst
index 655364767b3..5ac369a7909 100644
--- a/doc/usage/extensions/math.rst
+++ b/doc/usage/extensions/math.rst
@@ -144,7 +144,8 @@ are built:
    Version 4.0 changes the version of MathJax used to version 3. You may need to
    override ``mathjax_path`` to
    ``https://cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-AMS-MML_HTMLorMML``
-   or update your configuration options for version 3.
+   or update your configuration options for version 3
+   (see :confval:`mathjax3_config`).
 
 .. versionadded:: 1.1
 
@@ -199,24 +200,58 @@ Sphinx but is set to automatically include it from a third-party site.
 
    .. versionadded:: 1.8
 
-.. confval:: mathjax_config
+.. confval:: mathjax3_config
+
+   The configuration options for MathJax v3 (which is used by default).
+   The given dictionary is assigned to the JavaScript variable
+   ``window.MathJax``.
+   For more information, please read `Configuring MathJax`__.
+
+   __ https://docs.mathjax.org/en/latest/web/configuration.html#configuration
+
+   The default is empty (not configured).
+
+   .. versionadded:: 4.0
+
+.. confval:: mathjax2_config
+
+   The configuration options for MathJax v2 (which can be loaded via
+   :confval:`mathjax_path`).
+   The value is used as a parameter of ``MathJax.Hub.Config()``.
+   For more information, please read `Using in-line configuration options`__.
 
-   The inline configuration options for mathjax.  The value is used as a
-   parameter of ``MathJax.Hub.Config()``.  For more information, please
-   read `Using in-line configuration options`_.
+   __ http://docs.mathjax.org/en/v2.7-latest/
+      configuration.html#using-in-line-configuration-options
 
    For example::
 
-       mathjax_config = {
+       mathjax2_config = {
            'extensions': ['tex2jax.js'],
            'jax': ['input/TeX', 'output/HTML-CSS'],
        }
 
    The default is empty (not configured).
 
+   .. versionadded:: 4.0
+
+      :confval:`mathjax_config` has been renamed to :confval:`mathjax2_config`.
+
+.. confval:: mathjax_config
+
+   Former name of :confval:`mathjax2_config`.
+
+   For help converting your old MathJax configuration to to the new
+   :confval:`mathjax3_config`, see `Converting Your v2 Configuration to v3`__.
+
+   __ https://docs.mathjax.org/en/latest/web/
+      configuration.html#converting-your-v2-configuration-to-v3
+
    .. versionadded:: 1.8
 
-.. _Using in-line configuration options: https://docs.mathjax.org/en/latest/configuration.html#using-in-line-configuration-options
+   .. versionchanged:: 4.0
+
+      This has been renamed to :confval:`mathjax2_config`.
+      :confval:`mathjax_config` is still supported for backwards compatibility.
 
 :mod:`sphinx.ext.jsmath` -- Render math via JavaScript
 ------------------------------------------------------

From cb78512835462a9cc297130ce66287c3048a59da Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 24 Apr 2021 18:37:30 +0900
Subject: [PATCH 296/305] doc: Fix minor mark-up misses up

---
 doc/latex.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/latex.rst b/doc/latex.rst
index ff1af928606..6e2a34c3b45 100644
--- a/doc/latex.rst
+++ b/doc/latex.rst
@@ -158,6 +158,7 @@ Keys that you may want to override include:
       Greek or Cyrillic in a document using ``'pdflatex'`` engine.
 
    .. versionchanged:: 4.0.0
+
       - The font substitution commands added at ``2.0`` have been moved
         to the ``'fontsubstitution'`` key, as their presence here made
         it complicated for user to customize the value of ``'fontpkg'``.
@@ -165,7 +166,6 @@ Keys that you may want to override include:
         Helvetica clones for serif and sans serif, but via better, more
         complete TeX fonts and associated LaTeX packages.  The
         monospace font has been changed to better match the Times clone.
-        
 
 ``'fncychap'``
    Inclusion of the "fncychap" package (which makes fancy chapter titles),

From 4582d5a396d378abc2de0c83a7ed6028678eeebf Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sat, 27 Feb 2021 18:45:07 +0900
Subject: [PATCH 297/305] refactor: Add testcase for mathjax3_config (refs:
 #9094)

---
 sphinx/builders/html/__init__.py |  6 +++++-
 tests/test_ext_math.py           | 16 ++++++++++++++--
 2 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index a78d54a1665..87b9c5c4580 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1166,7 +1166,11 @@ def js_tag(js: JavaScript) -> str:
         else:
             # str value (old styled)
             attrs.append('src="%s"' % pathto(js, resource=True))
-        return '<script %s>%s</script>' % (' '.join(attrs), body)
+
+        if attrs:
+            return '<script %s>%s</script>' % (' '.join(attrs), body)
+        else:
+            return '<script>%s</script>' % body
 
     context['js_tag'] = js_tag
 
diff --git a/tests/test_ext_math.py b/tests/test_ext_math.py
index bd124c8c622..ebe2c0f38ea 100644
--- a/tests/test_ext_math.py
+++ b/tests/test_ext_math.py
@@ -215,11 +215,23 @@ def test_math_compat(app, status, warning):
 
 @pytest.mark.sphinx('html', testroot='ext-math',
                     confoverrides={'extensions': ['sphinx.ext.mathjax'],
-                                   'mathjax_config': {'extensions': ['tex2jax.js']}})
-def test_mathjax_config(app, status, warning):
+                                   'mathjax3_config': {'extensions': ['tex2jax.js']}})
+def test_mathjax3_config(app, status, warning):
     app.builder.build_all()
 
     content = (app.outdir / 'index.html').read_text()
+    assert MATHJAX_URL in content
+    assert ('<script>window.MathJax = {"extensions": ["tex2jax.js"]}</script>' in content)
+
+
+@pytest.mark.sphinx('html', testroot='ext-math',
+                    confoverrides={'extensions': ['sphinx.ext.mathjax'],
+                                   'mathjax2_config': {'extensions': ['tex2jax.js']}})
+def test_mathjax2_config(app, status, warning):
+    app.builder.build_all()
+
+    content = (app.outdir / 'index.html').read_text()
+    assert MATHJAX_URL in content
     assert ('<script type="text/x-mathjax-config">'
             'MathJax.Hub.Config({"extensions": ["tex2jax.js"]})'
             '</script>' in content)

From 07e84752c74c15297464c4db744137594894609f Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 29 Apr 2021 15:03:44 +0900
Subject: [PATCH 298/305] Bump to 4.0.0 beta2

---
 CHANGES            | 28 ++--------------------------
 sphinx/__init__.py |  4 ++--
 2 files changed, 4 insertions(+), 28 deletions(-)

diff --git a/CHANGES b/CHANGES
index 16fda6295f4..9ab35379692 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,5 +1,5 @@
-Release 4.0.0 beta2 (in development)
-====================================
+Release 4.0.0 beta2 (released Apr 29, 2021)
+===========================================
 
 Dependencies
 ------------
@@ -14,9 +14,6 @@ Incompatible changes
 * #9023: Change the CSS classes on :rst:role:`cpp:expr` and
   :rst:role:`cpp:texpr`.
 
-Deprecated
-----------
-
 Features added
 --------------
 
@@ -39,9 +36,6 @@ Bugs fixed
 * C, C++, fix ``KeyError`` when an ``alias`` directive is the first C/C++
   directive in a file with another C/C++ directive later.
 
-Testing
---------
-
 Release 4.0.0 beta1 (released Apr 12, 2021)
 ===========================================
 
@@ -180,24 +174,6 @@ Bugs fixed
 Release 3.5.5 (in development)
 ==============================
 
-Dependencies
-------------
-
-Incompatible changes
---------------------
-
-Deprecated
-----------
-
-Features added
---------------
-
-Bugs fixed
-----------
-
-Testing
---------
-
 Release 3.5.4 (released Apr 11, 2021)
 =====================================
 
diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index 8f1bd963cce..4785792263f 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -27,8 +27,8 @@
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
 
-__version__ = '4.0.0+'
-__released__ = '4.0.0'  # used when Sphinx builds its own docs
+__version__ = '4.0.0b2'
+__released__ = '4.0.0b2'  # used when Sphinx builds its own docs
 
 #: Version info for better programmatic use.
 #:

From 742a2e0c0a39f42d1264975d1ac33d2cce5eedf5 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Thu, 29 Apr 2021 15:04:53 +0900
Subject: [PATCH 299/305] Bump version

---
 CHANGES            | 21 +++++++++++++++++++++
 sphinx/__init__.py |  6 +++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 9ab35379692..e710d1da2a9 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,24 @@
+Release 4.0.0 beta3 (in development)
+====================================
+
+Dependencies
+------------
+
+Incompatible changes
+--------------------
+
+Deprecated
+----------
+
+Features added
+--------------
+
+Bugs fixed
+----------
+
+Testing
+--------
+
 Release 4.0.0 beta2 (released Apr 29, 2021)
 ===========================================
 
diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index 4785792263f..4e679bd21f5 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -27,8 +27,8 @@
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
 
-__version__ = '4.0.0b2'
-__released__ = '4.0.0b2'  # used when Sphinx builds its own docs
+__version__ = '4.0.0+'
+__released__ = '4.0.0'  # used when Sphinx builds its own docs
 
 #: Version info for better programmatic use.
 #:
@@ -38,7 +38,7 @@
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (4, 0, 0, 'beta', 2)
+version_info = (4, 0, 0, 'beta', 3)
 
 package_dir = path.abspath(path.dirname(__file__))
 

From 8d54010675b122444ce7c3dd7b406154d5816aa5 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 3 May 2021 18:52:19 +0900
Subject: [PATCH 300/305] Fix test: deprecation warning for extlinks

---
 tests/roots/test-root/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/roots/test-root/conf.py b/tests/roots/test-root/conf.py
index 34cafa7671e..687445a702b 100644
--- a/tests/roots/test-root/conf.py
+++ b/tests/roots/test-root/conf.py
@@ -42,7 +42,7 @@
 coverage_c_path = ['special/*.h']
 coverage_c_regexes = {'function': r'^PyAPI_FUNC\(.*\)\s+([^_][\w_]+)'}
 
-extlinks = {'issue': ('http://bugs.python.org/issue%s', 'issue '),
+extlinks = {'issue': ('http://bugs.python.org/issue%s', 'issue %s'),
             'pyurl': ('http://python.org/%s', None)}
 
 # modify tags from conf.py

From cfb9183715b70c5c283d35b8db98f17c73450f3f Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Mon, 3 May 2021 13:56:18 +0900
Subject: [PATCH 301/305] Update dependency: jinja2 < 3.0 and MarkupSafe < 2.0

Jinja2 and MarkupSafe have a plan to major release in the near future.
And it will introduce some changes for its APIs.  To lessen the noise
of the DeprecationWarnings, this pins the versions to current stable
release.
---
 setup.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index b669afc00e3..7ce37f9eaf8 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,8 @@
     'sphinxcontrib-htmlhelp',
     'sphinxcontrib-serializinghtml',
     'sphinxcontrib-qthelp',
-    'Jinja2>=2.3',
+    'Jinja2>=2.3,<3.0',
+    'MarkupSafe<2.0',
     'Pygments>=2.0',
     'docutils>=0.14,<0.18',
     'snowballstemmer>=1.1',

From a7c5a3a88be040ebc6a921b96247c5528886c34b Mon Sep 17 00:00:00 2001
From: Malte Bonart <malte@spiced-academy.com>
Date: Mon, 3 May 2021 23:54:26 +0200
Subject: [PATCH 302/305] fix missing underscore

fix missing reverting when adding css files via app.add_css_file in a html-page-context event
---
 sphinx/builders/html/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py
index 87b9c5c4580..348914b4d34 100644
--- a/sphinx/builders/html/__init__.py
+++ b/sphinx/builders/html/__init__.py
@@ -1026,7 +1026,7 @@ def hasdoc(name: str) -> bool:
 
         # revert script_files and css_files
         self.script_files[:] = self._script_files
-        self.css_files[:] = self.css_files
+        self.css_files[:] = self._css_files
 
         self.update_page_context(pagename, templatename, ctx, event_arg)
         newtmpl = self.app.emit_firstresult('html-page-context', pagename,

From 50d027a036592d272e61391c7152fd04a6becada Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Tue, 4 May 2021 20:24:30 +0900
Subject: [PATCH 303/305] Update CHANGES for PR #9167

---
 CHANGES | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGES b/CHANGES
index e710d1da2a9..7f5f43221e0 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,8 @@ Features added
 Bugs fixed
 ----------
 
+* #9167: html: Failed to add CSS files to the specific page
+
 Testing
 --------
 

From 09bb98689c8f781a4b68a58b7dd79f622fe03233 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 9 May 2021 12:17:17 +0900
Subject: [PATCH 304/305] Update message catalogs

---
 sphinx/locale/ar/LC_MESSAGES/sphinx.po       | 1943 +++++------
 sphinx/locale/bg/LC_MESSAGES/sphinx.po       | 1780 +++++-----
 sphinx/locale/bn/LC_MESSAGES/sphinx.po       | 1804 ++++++-----
 sphinx/locale/ca/LC_MESSAGES/sphinx.po       | 1808 ++++++-----
 sphinx/locale/cak/LC_MESSAGES/sphinx.po      | 1782 +++++-----
 sphinx/locale/cs/LC_MESSAGES/sphinx.po       | 1808 ++++++-----
 sphinx/locale/cy/LC_MESSAGES/sphinx.po       | 1790 ++++++-----
 sphinx/locale/da/LC_MESSAGES/sphinx.po       | 1811 ++++++-----
 sphinx/locale/de/LC_MESSAGES/sphinx.po       | 1808 ++++++-----
 sphinx/locale/el/LC_MESSAGES/sphinx.po       | 1845 ++++++-----
 sphinx/locale/eo/LC_MESSAGES/sphinx.po       | 1792 ++++++-----
 sphinx/locale/es/LC_MESSAGES/sphinx.po       | 1858 ++++++-----
 sphinx/locale/et/LC_MESSAGES/sphinx.po       | 1906 ++++++-----
 sphinx/locale/eu/LC_MESSAGES/sphinx.po       | 1806 ++++++-----
 sphinx/locale/fa/LC_MESSAGES/sphinx.po       | 3038 +++++++++---------
 sphinx/locale/fi/LC_MESSAGES/sphinx.po       | 1780 +++++-----
 sphinx/locale/fr/LC_MESSAGES/sphinx.po       | 2075 ++++++------
 sphinx/locale/he/LC_MESSAGES/sphinx.po       | 1790 ++++++-----
 sphinx/locale/hi/LC_MESSAGES/sphinx.po       | 1848 ++++++-----
 sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po    | 1780 +++++-----
 sphinx/locale/hr/LC_MESSAGES/sphinx.po       | 1818 ++++++-----
 sphinx/locale/hu/LC_MESSAGES/sphinx.po       | 1847 ++++++-----
 sphinx/locale/id/LC_MESSAGES/sphinx.po       | 1842 ++++++-----
 sphinx/locale/it/LC_MESSAGES/sphinx.po       | 1810 ++++++-----
 sphinx/locale/ja/LC_MESSAGES/sphinx.po       | 1858 ++++++-----
 sphinx/locale/ko/LC_MESSAGES/sphinx.po       | 2728 ++++++++--------
 sphinx/locale/lt/LC_MESSAGES/sphinx.po       | 1808 ++++++-----
 sphinx/locale/lv/LC_MESSAGES/sphinx.po       | 1808 ++++++-----
 sphinx/locale/mk/LC_MESSAGES/sphinx.po       | 1796 ++++++-----
 sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po    | 1808 ++++++-----
 sphinx/locale/ne/LC_MESSAGES/sphinx.po       | 1808 ++++++-----
 sphinx/locale/nl/LC_MESSAGES/sphinx.po       | 1816 ++++++-----
 sphinx/locale/pl/LC_MESSAGES/sphinx.po       | 1826 ++++++-----
 sphinx/locale/pt/LC_MESSAGES/sphinx.po       | 1780 +++++-----
 sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po    | 1864 ++++++-----
 sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po    | 1810 ++++++-----
 sphinx/locale/ro/LC_MESSAGES/sphinx.po       | 1810 ++++++-----
 sphinx/locale/ru/LC_MESSAGES/sphinx.po       | 1810 ++++++-----
 sphinx/locale/si/LC_MESSAGES/sphinx.po       | 1794 ++++++-----
 sphinx/locale/sk/LC_MESSAGES/sphinx.po       | 2328 +++++++-------
 sphinx/locale/sl/LC_MESSAGES/sphinx.po       | 1808 ++++++-----
 sphinx/locale/sq/LC_MESSAGES/sphinx.po       | 2006 ++++++------
 sphinx/locale/sr/LC_MESSAGES/sphinx.po       | 2045 ++++++------
 sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po | 1780 +++++-----
 sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po    | 1780 +++++-----
 sphinx/locale/sv/LC_MESSAGES/sphinx.po       | 1808 ++++++-----
 sphinx/locale/ta/LC_MESSAGES/sphinx.po       | 1780 +++++-----
 sphinx/locale/te/LC_MESSAGES/sphinx.po       | 1780 +++++-----
 sphinx/locale/tr/LC_MESSAGES/sphinx.po       | 1931 +++++------
 sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po    | 1808 ++++++-----
 sphinx/locale/ur/LC_MESSAGES/sphinx.po       | 1780 +++++-----
 sphinx/locale/vi/LC_MESSAGES/sphinx.po       | 1806 ++++++-----
 sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po    | 1953 +++++------
 sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po    | 1810 ++++++-----
 54 files changed, 54482 insertions(+), 47014 deletions(-)

diff --git a/sphinx/locale/ar/LC_MESSAGES/sphinx.po b/sphinx/locale/ar/LC_MESSAGES/sphinx.po
index 371395b7b1e..7d386254c55 100644
--- a/sphinx/locale/ar/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ar/LC_MESSAGES/sphinx.po
@@ -1,148 +1,154 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
+# Abdullah ahmed <Alhadab@hotmail.co.uk>, 2020
 # Mohammed Shannaq <sam@ms.per.jo>, 2018
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Arabic (http://www.transifex.com/sphinx-doc/sphinx-1/language/ar/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: ar\n"
 "Plural-Forms: nplurals=6; plural=n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "مجلد الاعدادات لا يحتوي على ملف conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "لا يمكن العثور على المجلد المصدر (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "لا يمكن ان يكون المجلد المصدر والمجلد الهدف متطابقين"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "تشغيل Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "يحتاج هذا المشروع على الاقل الى الاصدار %s من Sphinx وبالتالي لا يمكن بناءه باستخدام الاصدار الحالي"
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "تحميل الترجمات [ %s ]"
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "تم"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "غير متوفرة للرسائل الافتراضية المدمجة"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "فشل: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "لم يتم اختيار نوع البناء، تم استخدام نوع البناء الافتراضي: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "نجح"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "انتهى مع وجود مشاكل"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "بناء %s، %sتحذير."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "بناء %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +156,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +169,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +229,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
-msgstr ""
+msgstr "قسم %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
-msgstr ""
+msgstr "جدول %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +281,430 @@ msgstr "primary_domain %r لتم يتم العثور عليه، لهذا تم ت
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "حدث غير معروف: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
-msgid "document not readable. Ignored."
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/project.py:59
+msgid "document not readable. Ignored."
+msgstr "المستند غير قابل للقراءة. تجاهل."
+
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
-msgstr ""
+msgstr "التصميم %r "
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "بناء [mo]:"
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
-msgstr ""
+msgstr "جميع ملفات المصدر"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "بناء [%s]"
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
-msgstr ""
+msgstr "التحقق من التوافق"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
-msgstr ""
+msgstr "تحديث البيئة:"
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
-msgstr ""
+msgstr "تجهيز المستندات"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
-msgstr ""
+msgstr "نسخ الصور..."
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
-msgstr ""
+msgstr "لا تستطيع نسخة ملف صورة %s:"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +713,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
-msgstr ""
+msgstr "قراءة القوالب"
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
-msgstr ""
+msgstr "صفحة الHTML موجودة في  %(outdir)s"
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
-msgstr ""
+msgstr "كتابة ملفات إضافية"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
-msgstr ""
+msgstr "معالجة %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +880,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
-msgstr ""
+msgstr "ملفات الXML موجودة في %(outdir)s"
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -876,292 +904,304 @@ msgstr ""
 #: sphinx/builders/html/__init__.py:176
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
-msgstr ""
+msgstr "صفحة الHTML موجودة في  %(outdir)s"
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
-msgstr ""
+msgstr "فشل في قراءة معلومات ملف البناء"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
-msgstr ""
+msgstr "الفهرس العام"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
-msgstr ""
+msgstr "الفهرس"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "التالي"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "السابق"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
-msgstr ""
+msgstr "إنشاء الفهرس"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
-msgstr ""
+msgstr "كتابة صفحات إضافية "
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
-msgstr ""
+msgstr "نسخ الملفات القابلة للتحميل للنسخ..."
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
+msgstr "غير قادر على نسخ الملفات القابلة للتحميل %r : %s"
+
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
-msgstr ""
+msgstr "غير قادر على نسخ الملف الثابت %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
-msgstr ""
+msgstr "نسخ ملفات إضافية"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
-msgstr ""
+msgstr "غير قادر على نسخ المف الإضافي %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
-msgstr ""
+msgstr "ملف الشعار %r غير موجود"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
+msgstr "ملف الايقونة %r غير موجود"
+
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1220,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "الرجاء ادخال بعض النصوص"
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
-msgstr ""
+msgstr "أدخل إما 'نعم' أو'لا'"
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
+msgstr "أدخل امتداد الملف, مثلا '.rst' أو '.txt'"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
-msgstr ""
+msgstr "اسم المشروع"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
-msgstr ""
+msgstr "اسم المؤلف(ون)"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1493,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
-msgstr ""
+msgstr "نسخة المشروع"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
-msgstr ""
+msgstr "إصدار المشروع"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1511,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
-msgstr ""
+msgstr "لغة المشروع"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
-msgstr ""
+msgstr "امتداد ملف المصدر"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1533,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
-msgstr ""
+msgstr "إنشاء Makefile ؟ (نعم / لا)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
-msgstr ""
+msgstr "إنشاء ملف أوامر للويندوز؟ (نعم/لا)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1627,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
-msgstr ""
+msgstr "اسم المشروع"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
-msgstr ""
+msgstr "أسماء المؤلفين"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
-msgstr ""
+msgstr "إنشاء Makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
-msgstr ""
+msgstr "إنشاء Batchfile ؟"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
-msgstr ""
+msgstr "عرف متغير للقالب"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
-msgstr ""
+msgstr "مؤلف القسم:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
-msgstr ""
+msgstr "كاتب الكود:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
+msgstr "المؤلف"
+
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr ""
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "متغير"
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr ""
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
+msgstr "نوع"
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
+msgstr "كائن"
 
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr ""
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
-msgstr ""
+msgstr "كائن"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
-msgstr ""
+msgstr "متغيرات"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
-msgstr ""
+msgstr "متغير بيئة العمل"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
-msgstr ""
+msgstr "صفحة البحث"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2408,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
-msgstr ""
+msgstr "%s ليس مجلد."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2600,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2614,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2631,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2667,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
-msgstr ""
+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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
-msgstr ""
+msgstr "[المصدر]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[المستندات]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2826,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2991,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
-msgstr ""
+msgstr "مثال"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
-msgstr ""
+msgstr "أمثلة"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
-msgstr ""
+msgstr "ملاحظات"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
-msgid "References"
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:767
+msgid "References"
+msgstr "مراجع"
+
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
-msgid "Attention"
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
-msgid "Caution"
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
-msgid "Danger"
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
-msgid "Error"
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
+#: sphinx/locale/__init__.py:252
+msgid "Attention"
+msgstr "تنبيه"
+
+#: sphinx/locale/__init__.py:253
+msgid "Caution"
+msgstr "احتياط"
+
 #: sphinx/locale/__init__.py:254
-msgid "Hint"
-msgstr ""
+msgid "Danger"
+msgstr "خطر"
 
 #: sphinx/locale/__init__.py:255
-msgid "Important"
-msgstr ""
+msgid "Error"
+msgstr "خطأ"
 
 #: sphinx/locale/__init__.py:256
-msgid "Note"
-msgstr ""
+msgid "Hint"
+msgstr "تلميح"
 
 #: sphinx/locale/__init__.py:257
-msgid "See also"
-msgstr ""
+msgid "Important"
+msgstr "مهم"
 
 #: sphinx/locale/__init__.py:258
-msgid "Tip"
-msgstr ""
+msgid "Note"
+msgstr "ملاحظة"
 
 #: sphinx/locale/__init__.py:259
+msgid "See also"
+msgstr "شاهد أيضا"
+
+#: sphinx/locale/__init__.py:260
+msgid "Tip"
+msgstr "نصيحة"
+
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
-msgstr ""
+msgstr "تحذير"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "استمرار في الصفحة التالية"
@@ -2995,130 +3126,130 @@ msgstr ""
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:12
 msgid "Numbers"
-msgstr ""
+msgstr "أرقام"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:13
 msgid "page"
-msgstr ""
+msgstr "صفحة"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
-msgstr ""
+msgstr "قائمة المحتويات"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
-msgstr ""
+msgstr "بحث"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
-msgstr ""
+msgstr "إظهار المصدر"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
-msgstr ""
+msgstr "أهلا وسهلا  هذا"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
-msgstr ""
+msgstr "التوثيق ل"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "البحث ضمن %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
-msgstr ""
+msgstr "الحقوق"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\"> حقوق النشر </a> %(copyright)s"
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169;  حقوق النشر %(copyright)s"
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3127,57 +3258,57 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr "البحث %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "الموضوع السابق"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
-msgstr ""
+msgstr "القسم السابق"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "الموضوع التالي"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "الفصل التالي"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
-msgstr ""
+msgstr "بحث"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
-msgstr ""
+msgstr "نتائج البحث"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
-msgstr ""
+msgstr "البحث السريع"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
-msgstr ""
+msgstr "هذه الصفحة"
 
 #: sphinx/themes/basic/changes/frameset.html:5
 #: sphinx/themes/basic/changes/versionchanges.html:12
@@ -3197,7 +3328,7 @@ msgstr ""
 
 #: sphinx/themes/basic/changes/versionchanges.html:18
 msgid "Library changes"
-msgstr ""
+msgstr "تجهيز البحث"
 
 #: sphinx/themes/basic/changes/versionchanges.html:23
 msgid "C API changes"
@@ -3207,19 +3338,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3231,12 +3362,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,9 +3380,9 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
-msgstr ""
+msgstr "المحتوى"
 
 #: sphinx/transforms/__init__.py:224
 #, python-format
@@ -3268,199 +3399,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
+msgstr "فشل"
+
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/bg/LC_MESSAGES/sphinx.po b/sphinx/locale/bg/LC_MESSAGES/sphinx.po
index 6d36b05f3f2..4f63c8be22b 100644
--- a/sphinx/locale/bg/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/bg/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Bulgarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/bg/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: bg\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,124 +3130,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3126,55 +3256,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3206,19 +3336,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/bn/LC_MESSAGES/sphinx.po b/sphinx/locale/bn/LC_MESSAGES/sphinx.po
index 98ecbe5d08a..fb43f56b9b1 100644
--- a/sphinx/locale/bn/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/bn/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2009
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Bengali (http://www.transifex.com/sphinx-doc/sphinx-1/language/bn/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: bn\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "পাইথন উন্নয়ন পরামর্শ; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "বিল্টইন সমূহ"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "মডিউল লেভেল"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(-"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "সাধারণ ইনডেক্স"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "ইনডেক্স"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "পরবর্তী"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "পূর্ববর্তী"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "ইনডেক্স"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "রিলিজ"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "অনুচ্ছেদ লেখক:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "মডিউল লেখক:"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "লেখক:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "প্যারামিটার"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "রিটার্নস"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "রিটার্ন টাইপ"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (C ফাংশন)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C মেম্বার)"
-
-#: sphinx/domains/c.py:191
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C macro)"
-msgstr "%s (C ম্যাক্রো)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C টাইপ)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C ভ্যারিয়েবল)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "ফাংশন"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
+msgstr ""
+
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "%s ভার্সনে নতুন"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "%s ভার্সনে পরিবর্তিত"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "%s ভার্সন থেকে ডেপ্রিকেটেড"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "ক্লাস"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr ""
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (বিল্ট-ইন ফাংশন)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s মেথড)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (ক্লাসে)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s এ্যট্রিবিউট)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (মডিউল)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "মেথড"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "ডাটা"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "এ্যট্রিবিউট"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "মডিউল"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "কিওয়ার্ড"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "অপারেটর"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "অবজেক্ট"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "এক্সেপশন"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "স্ট্যাটমেন্ট"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "বিল্ট-ইন ফাংশন"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "রেইজেস"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s মডিউলে)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (বিল্ট-ইন ভ্যারিয়েবল)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s মডিউলে)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (বিল্ট-ইন ভ্যারিয়েবল)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (বিল্ট-ইন ক্লাস)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s ক্লাসে)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s (%s.%s মেথড)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s ক্লাস মেথড)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s (%s.%s স্ট্যাটিক মেথড)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s স্ট্যাটিক মেথড)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s ক্লাস মেথড)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s ক্লাস মেথড)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s এ্যট্রিবিউট)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "মডিউল সমূহ"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "ডেপ্রিকেটেড"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "ক্লাস মেথড"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "স্ট্যাটিক মেথড"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "এনভায়রনমেন্ট ভ্যারিয়েবল; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "শব্দকোষ"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "ব্যকরণ টোকেন"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "এনভায়রনমেন্ট ভ্যারিয়েবল"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "প্রোগ্রাম অপশন"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "মডিউল ইনডেক্স"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "অনুসন্ধান পাতা"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "অসমাপ্ত কাজ"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr ":class:`%s` এর উপনাম"
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "দৃষ্টি আকর্ষণ"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "সতর্কীকরণ"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "বিপজ্জনক"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "ভুল (এরর)"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "আভাস"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "গুরুত্বপূর্ণ"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "নোট"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "আরও দেখুন"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "পরামর্শ"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "সতর্কতা"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "পূর্ববর্তী পাতা হতে চলমান"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,181 +3131,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "অনুসন্ধান"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "যান"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "সোর্স দেখুন"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "ভুমিকা"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "ইনডেক্স ও টেবিল সমূহ:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "পূর্ণাঙ্গ সূচীপত্র"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "সকল অনুচ্ছেদ সমূহের তালিকা"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "এই সহায়িকাতে অনুসন্ধা করুন"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "গ্লোবাল মডিউল ইনডেক্স"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "সকল মডিউলে দ্রুত প্রবেশ"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "সকল ফাংশন, ক্লাস, টার্ম"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "ইনডেক্স &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "এক পাতায় সম্পূর্ণ ইনডেক্স"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "বর্ণানুসারে ইনডেক্স পাতা"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "খুব বড় হতে পারে"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "নেভিগেশন"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s এর মধ্যে খুঁজুন"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "এই ডকুমেন্ট সম্পর্কে"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "কপিরাইট"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "%(last_updated)s সর্বশেষ পরিবর্তন করা হয়েছে।"
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "<a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s দিয়ে তৈরী।"
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "%(docstitle)s-এ খুঁজুন"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "পূর্ববর্তী টপিক"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "পূর্ববর্তী অধ্যায়"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "পরবর্তী টপিক"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "পরবর্তী অধ্যায়"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "অনুসন্ধান করার জন্য অনুগ্রহপূর্বক জাভাস্ক্রিপ্ট \n   সক্রিয় করুন।"
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "খুঁজুন"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "অনুসন্ধানের ফলাফল"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "দ্রুত অনুসন্ধান"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "এই পাতা"
 
@@ -3207,19 +3337,19 @@ msgstr "C API পরিবর্তন"
 msgid "Other changes"
 msgstr "অন্যান্য পরিবর্তন"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "এই শিরোনামের পার্মালিঙ্ক"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "এই সংজ্ঞার পার্মালিঙ্ক"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "অনুসন্ধানের ম্যাচগুলো লুকান"
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "পাদটীকা"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[ছবি]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/ca/LC_MESSAGES/sphinx.po b/sphinx/locale/ca/LC_MESSAGES/sphinx.po
index 9cbebc74a9f..8022a801778 100644
--- a/sphinx/locale/ca/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ca/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2009
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Catalan (http://www.transifex.com/sphinx-doc/sphinx-1/language/ca/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: ca\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Mòduls Interns"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Nivell de mòdul"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (a "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Índex General"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "índex"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "següent"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "anterior"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s documentació"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Índex"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Versió"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor de la secció:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor del mòdul: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Paràmetres"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Retorna"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Tipus de retorn"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (funció de C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (membre de C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (macro de C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (tipus de C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "membre"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (variable de C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variable"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funció"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "membre"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tipus"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variable"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Novetat de la versió %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Canviat a la versió %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsolet desde la versió %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "class"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funció interna)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (mètode %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (class)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (mòdul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "mòdul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "paraula clau"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operador"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objecte"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "excepció"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "sentència"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "funció interna"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Llença"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (al mòdul %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (variable interna)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (al mòdul %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (variable interna)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe interna)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (class a %s)"
 
-#: sphinx/domains/python.py:613
-#, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (mètode %s.%s)"
-
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (mètode estàtic %s.%s)"
-
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
-#, python-format
-msgid "%s() (%s static method)"
-msgstr "%s() (mètode estàtic %s)"
-
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s class method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:745
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atribut %s.%s)"
+msgid "%s() (%s static method)"
+msgstr "%s() (mètode estàtic %s)"
 
-#: sphinx/domains/python.py:709
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "mòduls"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Obsolet"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "mètode estàtic"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (obsolet)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "variable d'entorn; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "variable d'entorn"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Índex de Mòduls"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Pàgina de Cerca"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "vegeu %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "vegeu també %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Pendent"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "àlies de :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Atenció"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Compte"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Perill"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Error"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Suggerència"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Important"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Vegeu també"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Truc"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Avís"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "ve de la pàgina anterior"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,181 +3131,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Cerca"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Ves a"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Mostra Codi Font"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Resum"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Índexs i taules:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Taula de Contingut Completa"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "llista totes les seccions i subseccions"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "cerca aquesta documentació"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Índex Global de Mòduls"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "accés ràpid a tots els mòduls"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "totes les funcions, classes, termes"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Índes &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Índex complet en una pàgina"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Pàgines d'índex per lletra"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "pot ser gegant"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navegació"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Cerca dins de %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Quant a aquests documents"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Última actualització el %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Creat amb <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Cercar a %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Tema anterior"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "capítol anterior"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Tema següent"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "capítol següent"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Activa JavaScript per utilitzar la funcionalitat\nde cerca."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "cerca"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Resultats de la Cerca"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Cerca ràpida"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Aquesta Pàgina"
 
@@ -3207,19 +3337,19 @@ msgstr "Canvis a la API de C"
 msgid "Other changes"
 msgstr "Altres canvis"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Link permanent a aquest títol"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Link permanent a aquesta definició"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Oculta Resultats de Cerca"
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[imatge]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/cak/LC_MESSAGES/sphinx.po b/sphinx/locale/cak/LC_MESSAGES/sphinx.po
index 2ea8716e3cc..a2e9229bb07 100644
--- a/sphinx/locale/cak/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/cak/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Julien Malard <julien.malard@mail.mcgill.ca>, 2019
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Kaqchikel (http://www.transifex.com/sphinx-doc/sphinx-1/language/cak/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: cak\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "xk'isïk"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "sachoj: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Ruwachib'äl %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Kik'ajtz'ïk %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "tajin nutz'ib'aj"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(chupam"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Konojel cholwuj"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "cholwuj"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "jun chïk"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "chi rij kan"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Cholwuj"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Rusachoj nuk'unem:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Rusachoj kamulunem:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Ütz apetïk pa rokisanem runuk'ik Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Rub'i' samäj"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Kib'i' ajtz'ib'anel(a')"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Rujalwäch samäj"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Ruch'ab'äl samaj"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Jalajöj"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "retal jalöj"
+
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "retal jalöj"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "Ruwäch"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "wachinäq"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Retal jalöj"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "wuj"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "tatz'u %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "tatz'u chuqa' %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(chupam %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Chi tiqib'ana'"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Ri <<original entry>> k'o chupam %s, pa juch' %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Tz'etb'äl"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Tz'etb'äl"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Jalajöj chïk"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Sachoj"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Tatz'u chuqa'"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,124 +3131,124 @@ msgstr "Ajilanïk"
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Ütz apetïk! Wawe' k'o"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "ri wuj richin"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3127,55 +3257,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Ruxaq wuj re'"
 
@@ -3207,19 +3337,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", pa"
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "rusachoj rusik'inïk: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "rusachoj rutz'ib'axïk: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[wachib'äl: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[wachib'äl]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/cs/LC_MESSAGES/sphinx.po b/sphinx/locale/cs/LC_MESSAGES/sphinx.po
index 1e7890782cb..8e167c76c8d 100644
--- a/sphinx/locale/cs/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/cs/LC_MESSAGES/sphinx.po
@@ -1,7 +1,7 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2008
 # Vilibald W. <vilibald.wanca@gmail.com>, 2014-2015
@@ -9,141 +9,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Czech (http://www.transifex.com/sphinx-doc/sphinx-1/language/cs/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: cs\n"
 "Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n >= 2 && n <= 4 && n % 1 == 0) ? 1: (n % 1 != 0 ) ? 2 : 3;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -151,12 +156,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -164,59 +169,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,58 +229,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Obr. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabulka %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Výpis %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -283,405 +281,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Vestavěné funkce"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Úroveň modulu"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -690,160 +713,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (v "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -853,18 +880,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -879,290 +906,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d.%m.%Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Obecný rejstřík"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "rejstřík"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "další"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "předchozí"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dokumentace pro %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Rejstřík"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Vydání"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1181,277 +1220,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1460,15 +1493,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1478,21 +1511,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1500,91 +1533,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1594,787 +1627,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor sekce: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor modulu: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autor kódu:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametry"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Vrací"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Typ návratové hodnoty"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C funkce)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C člen)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C makro)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C typ)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "člen"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C proměnná)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "proměnná"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funkce"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "člen"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "typ"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "proměnná"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nové ve verzi %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Změněno ve verzi %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Zastaralé od verze %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Vyvolá"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "třída"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (vestavěná funkce)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metoda %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (třída)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globální proměnná nebo konstanta)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumenty"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metoda"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "klíčové slovo"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operátor"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "výjimka"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "příkaz"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "vestavěná funkce"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Proměnné"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Vyvolá"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (v modulu %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (vestavěná proměnná)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (v modulu %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (vestavěná proměnná)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (vestavěná třída)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (třída v %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (metoda %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (třídní metoda %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (statická metoda %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statická metoda %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (třídní metoda %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (třídní metoda %s)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atribut %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Rejstřík modulů Pythonu"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduly"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Zastaralé"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "třídní metoda"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statická metoda"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (zastaralé)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiva)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktiva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "role"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "proměnná prostředí; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "termín v glosáři"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "token gramatiky"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "referenční návěstí"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "proměnná prostředí"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "volba programu"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Rejstřík modulů"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Vyhledávací stránka"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "viz %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "viz také %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symboly"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2386,165 +2408,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2558,11 +2600,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2572,14 +2614,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2589,29 +2631,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graf: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graf]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2624,148 +2667,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(v %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[zdroj]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "původní záznam"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dokumentace]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Kód modulu"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Zdrojový kód pro %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Přehled: kód modulu"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Všechny moduly s dostupným kódem</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2773,104 +2826,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias třídy :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2885,107 +2991,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Výstraha"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Upozornění"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Nebezpečí"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Chyba"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Rada"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Důležité"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Poznámka"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Viz také"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Varování"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "pokračujte na předchozí stránce"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3002,181 +3132,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Vyhledávání"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "OK"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Ukázat zdroj"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Přehled"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Vítejte! Toto je"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "dokumentace pro"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "naposledy aktualizováno"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Rejstříky a tabulky:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Celkový obsah"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "seznam všech sekcí a podsekcí"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "prohledat tuto dokumentaci"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Celkový rejstřík modulů"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "rychlý přístup ke všem modulům"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "všechny funkce, třídy, termíny"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Rejstřík &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Celý rejstřík na jedné stránce"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Rejstřík podle písmene"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "může být obrovský"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigace"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Prohledat %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "O těchto dokumentech"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Veškerá práva vyhrazena"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Aktualizováno dne %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Vytvořeno pomocí <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Prohledat %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Přechozí téma"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "předchozí kapitola"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Další téma"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "další kapitola"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Pro podporu vyhledávání aktivujte JavaScript."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "hledat"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Výsledky vyhledávání"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Vyhledávání nenalezlo žádný odpovídající dokument. Ujistěte se, že jste všechna slova zapsal/a správně a že jste vybral/a dostatek kategorií."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Rychlé vyhledávání"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Tato stránka"
 
@@ -3208,19 +3338,19 @@ msgstr "Změny API"
 msgid "Other changes"
 msgstr "Ostatní změny"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Trvalý odkaz na tento nadpis"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Trvalý odkaz na tuto definici"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Skrýt výsledky vyhledávání"
 
@@ -3232,12 +3362,12 @@ msgstr "Probíhá vyhledání"
 msgid "Preparing search..."
 msgstr "Vyhledávání se připravuje..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Vyhledávání dokončeno, stránky odpovídající hledanému výrazu: %s."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", v "
 
@@ -3250,7 +3380,7 @@ msgstr "Rozbalit boční lištu"
 msgid "Collapse sidebar"
 msgstr "Sbalit boční lištu"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Obsah"
 
@@ -3269,199 +3399,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Permalink k této tabulce"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Permalink k tomuto kódu"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Permalink k tomuto obrázku"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Poznámky pod čarou"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[obrázek: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[obrázek]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/cy/LC_MESSAGES/sphinx.po b/sphinx/locale/cy/LC_MESSAGES/sphinx.po
index 19a4c83d30b..db8ce46309c 100644
--- a/sphinx/locale/cy/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/cy/LC_MESSAGES/sphinx.po
@@ -1,7 +1,7 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2016
 # Geraint Palmer <palmer.geraint@googlemail.com>, 2016
@@ -9,141 +9,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Welsh (http://www.transifex.com/sphinx-doc/sphinx-1/language/cy/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: cy\n"
 "Plural-Forms: nplurals=4; plural=(n==1) ? 0 : (n==2) ? 1 : (n != 8 && n != 11) ? 2 : 3;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -151,12 +156,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -164,59 +169,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,58 +229,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Ffig. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabl %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Listing %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -283,405 +281,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Lefel modiwl"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -690,160 +713,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (yn "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -853,18 +880,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -879,290 +906,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indecs cyffredinol"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "indecs"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "nesaf"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "blaenorol"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dogfennaeth %s %s "
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Indecs"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Rhyddhad"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1181,277 +1220,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1460,15 +1493,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1478,21 +1511,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1500,91 +1533,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1594,787 +1627,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Awdur yr adran:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Awdur y fodiwl:"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Awdur y cod:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Awdur:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Paramedrau"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr ""
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "aelod"
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr ""
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
+msgstr "ffwythiant"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
-msgstr "ffwythiant"
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "aelod"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Newydd yn fersiwn %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Wedi newid yn fersiwn %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Dibrisiwyd ers fersiwn %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (newidyn byd-eang neu cysonyn)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modiwl"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "allweddair"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "gweithredydd"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "gwrthrych"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "datganiad"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "ffwythiant built-in"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Indecs Modiwlau"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Tudalen Chwilio"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "gweler %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "gweler hefyd %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symbolau"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2386,165 +2408,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2558,11 +2600,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2572,14 +2614,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2589,29 +2631,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graff: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graff]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2624,148 +2667,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(yn %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[ffynhonnell]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "eitem wreiddiol"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Cod y modiwl"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Cod ffynhonnell ar gyfer %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Trosolwg: cod y modiwl"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Holl fodiwlau lle mae'r cod ar gael</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2773,104 +2826,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2885,107 +2991,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Sylw"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Gofal"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Perygl"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Gwall"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Awgrym"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Pwysig"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Nodyn"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Gweler hefyd"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Awgrym"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Rhybudd"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "wedi'i barhau o'r tudalen blaenorol"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3002,181 +3132,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Chwilio"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Ewch"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Dangos Ffynhonell"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Trosolwg"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Croeso! Dyma"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "y dogfennaeth am"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "diweddarwyd yn ddiwethaf"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indecsau a tablau:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Tabl Cynnwys Llawn"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "rhestru holl adrannau ac isadrannau"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "chwiliwch y ddogfennaeth"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Indecs Modiwl Byd-Eang"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "mynediad cloi i bob modiwl"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "holl ffwythiannau, dosbarthau a thermau"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Indecs &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Indecs llawn ar un tudalen"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indecs tudalennau gan lythyren"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "gall fod yn enfawr"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Llywio"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Chwilio o fewn %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Ynglŷn â'r dogfennau hyn"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Hawlfraint"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Diweddarwyd yn ddiwethaf ar %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Cr谷wyd gan ddefnyddio <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s"
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Chwilio %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Pwnc blaenorol"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "pennod blaenorol"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Pwnc nesaf"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "pennod nesaf"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Trwoch JavaScript ymlaen i alluogi'r chwilio."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "chwilio"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Canlyniadau chwilio"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Nid yw eich chwiliad yn cyfateb unrhyw ddogfennau. Gwnewch yn siŵr fod pob gair wedi'i sillafu'n gywir, ac eich bod wedi dewis digon o gategorïau."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Chwilio cyflym"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Y Dudalen Hon"
 
@@ -3208,19 +3338,19 @@ msgstr "Newidiadau i'r C-API"
 msgid "Other changes"
 msgstr "Newidiadau arall"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Permalink i'r pennawd hwn"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Permalink i'r diffiniad hwn"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Cuddio Canlyniadau Chwilio"
 
@@ -3232,12 +3362,12 @@ msgstr "Yn chwilio"
 msgid "Preparing search..."
 msgstr "Paratoi chwilio..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Chwiliad wedi gorffen, wedi ffeindio %s tudalen(nau) yn cyfateb a'r ymholiad chwilio."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", yn "
 
@@ -3250,7 +3380,7 @@ msgstr "Ehangu'r bar ochr"
 msgid "Collapse sidebar"
 msgstr "Cyfangu'r bar ochr"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Cynnwys"
 
@@ -3269,199 +3399,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Permalink i'r tabl hwn"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Permalink i'r cod hwn"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Permalink i'r ddelwedd hon"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Permalink i'r toctree hwn"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Troednodiadau"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[delwedd: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[delwedd]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/da/LC_MESSAGES/sphinx.po b/sphinx/locale/da/LC_MESSAGES/sphinx.po
index 47fcbfd6f5f..332eeb67959 100644
--- a/sphinx/locale/da/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/da/LC_MESSAGES/sphinx.po
@@ -1,150 +1,156 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # askhl <asklarsen@gmail.com>, 2010-2011
 # Jakob Lykke Andersen <jakob@caput.dk>, 2014,2016
 # Joe Hansen <joedalton2@yahoo.dk>, 2016,2019
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2021
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Danish (http://www.transifex.com/sphinx-doc/sphinx-1/language/da/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: da\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "konfigurationsmappe indeholder ikke en conf.py-fil (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Kan ikke finde kildemappen (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Kildemappe og destinationsmappe kan ikke være identiske"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Kører Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Dette projekt kræver mindst Sphinx v%s og kan derfor ikke bygges med denne version."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "indlæser oversættelser [%s] ..."
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "færdig"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "ikke tilgængelig for indbyggede beskeder"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "fejlede: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "lykkedes"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "færdig med problemer"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "kompilering %s, %s advarsel."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "kompilering %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -152,12 +158,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -165,59 +171,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Ingen sådan konfigurationsværdi: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Konfigurationsværdien %r er allerede til stede"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -225,58 +231,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "figur %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "tabel %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Kildekode %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -284,405 +283,430 @@ msgstr "primary_domain %r blev ikke fundet, ignorerer."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Ukendt hændelsesnavn: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "domænet %s er allerede registreret"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Rollen %r er allerede registreret til domæne %s"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser for %r er allerede registreret"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Kunne ikke importere udvidelse %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Udvidelsen %s brugt af dette projekt kræver mindst Sphinx v%s; den kan derfor ikke bygges med denne version."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "læser kilder ..."
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "forbereder dokumenter"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Indbyggede"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Modulniveau"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -691,160 +715,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "konfigurationsværdien »epub_contributor« bør ikke være tom for EPUB3"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "ugyldig css_file: %r, ignoreret"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Beskedkatalogerne er i %(outdir)s."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "læser skabeloner ..."
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "skriver beskedkataloger ..."
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML-siden er i %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (i "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -854,18 +882,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -880,290 +908,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTML-siderne er i %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d. %b, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Generelt indeks"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "indeks"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "næste"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "forrige"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "kan ikke kopiere statisk fil %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "udgyldig js_file: %r, ignoreret"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "favicon-filen %r findes ikke"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentation"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Indeks"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Udgave"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Kodningsfejl:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1182,277 +1222,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "kan ikke finde filer %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Indtast venligst noget tekst."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Indtast venligst enten »y« eller »n«."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Indtast venligt et filsuffiks, f.eks. ».rst« eller ».txt«"
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1461,15 +1495,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1479,21 +1513,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1501,91 +1535,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Filen %s findes allerede, udelader."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1595,787 +1629,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "opret ikke makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "skabelonmappe for skabelonfiler"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Afsnitsforfatter: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Modulforfatter: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Kodeforfatter: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Forfatter: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametre"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Returnerer"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Returtype"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C-funktion)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C-medlem)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C-makro)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C-type)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "medlem"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C-variabel)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variabel"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funktion"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "medlem"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "optæl"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "optælling"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "type"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variabel"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Ny i version %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Ændret i version %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Forældet siden version %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Template-parametre"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Kaster"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klasse"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "koncept"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "optæl"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "optælling"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (indbygget funktion)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metode i %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasse)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (global variabel eller konstant)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (attribut i %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Parametre"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metode"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "attribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "nøgleord"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "undtagelse"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "erklæring"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "indbygget funktion"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variable"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Rejser"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (i modulet %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (indbygget variabel)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (i modulet %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (indbygget variabel)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (indbygget klasse)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasse i %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (metode i %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (klassemetode i %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (statisk metode i %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statisk metode i %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (klassemetode i %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (klassemetode i %s)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (attribut i %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python-modulindeks"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduler"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Forældet"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "klassemetode"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statisk metode"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (forældet)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiv)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rolle)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktiv"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rolle"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "miljøvariabel; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "begreb i ordliste"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "grammatisk element"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "referenceetiket"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "miljøvariabel"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "programtilvalg"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Modulindeks"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Søgeside"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "ny konfiguration"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "udvidelser ændret"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "kildemappe er ændret"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "se %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "se også %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symboler"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2387,165 +2410,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "overskriv eksisterende filer"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s er ikke en mappe"
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2559,11 +2602,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2573,14 +2616,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2590,29 +2633,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graf: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graf]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2625,148 +2669,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Permalink til denne ligning"
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(i %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[kilde]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<oprindeligt punkt>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Det <<oprindelige punkt>> befinder sig i %s, linje %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "oprindeligt punkt"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dok]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Modulkode"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kildekode for %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Oversigt: modulkode"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alle moduler, der er kode tilgængelig for</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2774,104 +2828,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias for :class:`%s`"
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2886,107 +2993,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Nøgleordsargumenter"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Eksempler"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Andre parametre"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "Referencer"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Vær opmærksom"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Forsigtig"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Fare"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Fejl"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Fif"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Vigtigt"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Bemærk"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Se også"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Advarsel"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "fortsat fra forrige side"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "fortsætter på næste side"
@@ -3003,181 +3134,181 @@ msgstr ""
 msgid "page"
 msgstr "side"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Søg"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Søg"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Vis kilde"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Oversigt"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Velkommen! Dette er"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "dokumentationen for"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "sidst opdateret"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indeks og tabeller:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Fuldstændig indholdsfortegnelse"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "viser alle afsnit og underafsnit"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "søg i denne dokumentation"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Globalt modulindeks"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "hurtig adgang til alle moduler"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "alle funktioner, klasser, begreber"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Indeks &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Fuldt indeks på én side"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indeksér sider efter bogstav"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "kan være enormt"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigation"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Søg i %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Om disse dokumenter"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Ophavsret"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Ophavsret</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Ophavsret %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Sidst opdateret %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Bygget med <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Søg i %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Forrige emne"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "forrige kapitel"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Næste emne"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "næste kapitel"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Aktivér venligst JavaScript for at aktivere\n    søgefunktionalitet."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
-msgstr ""
+msgstr "Bemærk: Hvis du søger efter flere ord, vises kun resultater der indeholder alle ordene."
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "søg"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Søgeresultater"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Din søgning matchede ikke nogen dokumenter. Sikr dig at alle ord er stavet korrekt og at du har valgt nok kategorier."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Hurtig søgning"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Denne side"
 
@@ -3209,19 +3340,19 @@ msgstr "Ændringer i C-API"
 msgid "Other changes"
 msgstr "Andre ændringer"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Permalink til denne overskrift"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Permalink til denne definition"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Skjul søgeresultater"
 
@@ -3233,12 +3364,12 @@ msgstr "Søger"
 msgid "Preparing search..."
 msgstr "Forbereder søgning..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Søgning færdig, fandt %s sider der matcher søgeforespørgslen."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", i"
 
@@ -3251,7 +3382,7 @@ msgstr "Udfold sidebjælke"
 msgid "Collapse sidebar"
 msgstr "Sammenfold sidebjælke"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Indhold"
 
@@ -3270,199 +3401,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Permahenvisning til denne tabel"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Permahenvisning til denne kode"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Permahenvisning til dette billede"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Permahenvisning til dette toctree"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Fodnoter"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[billede: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[billede]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/de/LC_MESSAGES/sphinx.po b/sphinx/locale/de/LC_MESSAGES/sphinx.po
index 2eaab8597dd..b0b58359f87 100644
--- a/sphinx/locale/de/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/de/LC_MESSAGES/sphinx.po
@@ -1,7 +1,7 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Georg Brandl <g.brandl@gmx.net>, 2013-2015
 # Jean-François B. <jfbu@free.fr>, 2018
@@ -11,141 +11,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: German (http://www.transifex.com/sphinx-doc/sphinx-1/language/de/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: de\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "Konfigurationsverzeichnis enthält keine conf.py Datei (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Kann Quellverzeichnis nicht finden (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Quellverzeichnis und Zielverzeichnis können nicht identisch sein"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s in Verwendung"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Dieses Projekt benötigt Version %s oder später und kann daher nicht gebaut werden."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "Lade Übersetzungen [%s]…"
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "erledigt"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "nicht verfügbar für vordefinierte Nachrichten"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "Fehlgeschlagen: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Kein builder ausgewählt, verwende 'html' per default"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "abgeschlossen"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "mit Problemen beendet"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -153,12 +158,12 @@ msgid ""
 "explicit"
 msgstr "Die Erweiterung %s gibt nicht an ob paralleles Datenlesen fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -166,59 +171,59 @@ msgid ""
 "explicit"
 msgstr "Die Erweiterung %s gibt nicht an ob paralleles Datenschreiben fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "Ungültige Nummer %r for Konfiguration %r, wird ignoriert"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Keine solche Konfigurationseinstellung: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Konfigurationswert %r bereits gesetzt"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -226,58 +231,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Abschnitt %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Abb. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tab. %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Quellcode %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -285,405 +283,430 @@ msgstr "primary_domain %r nicht gefunden, daher ignoriert."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Event %r bereits verfügbar"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Unbekannter Event name: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Pygments Lexer Name %r ist unbekannt"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Ursprüngliche Ausnahme:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Builtins"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Modulebene"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -692,160 +715,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (in "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -855,18 +882,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -881,290 +908,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d.%m.%Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Stichwortverzeichnis"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "Index"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "weiter"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "zurück"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s Dokumentation"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Stichwortverzeichnis"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Release"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1183,277 +1222,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1462,15 +1495,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1480,21 +1513,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1502,91 +1535,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1596,787 +1629,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor des Abschnitts: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor des Moduls: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autor des Quellcode: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s-%s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parameter"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Rückgabe"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Rückgabetyp"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C-Funktion)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C-Member)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C-Makro)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C-Typ)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "Member"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C-Variable)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "Variable"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "Funktion"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "Member"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "Makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "Aufzählung"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "Enumerator"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "Typ"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "Variable"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Neu in Version %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Geändert in Version %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Veraltet ab Version %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Template Parameter"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Wirft"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "Klasse"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "Aufzählung"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "Enumerator"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (Standard-Funktion)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (Methode von %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (Klasse)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globale Variable oder Konstante)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (Attribut von %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Parameter"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (Modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "Methode"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "Wert"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "Attribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "Modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "Schlüsselwort"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "Operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "Objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "Exception"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "Anweisung"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "Builtin-Funktion"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variablen"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Verursacht"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (im Modul %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (Standard-Variable)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (in Modul %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (Standard-Variable)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (Builtin-Klasse)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (Klasse in %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (Methode von %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (Klassenmethode von %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (statische Methode von %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statische Methode von %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (Klassenmethode von %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (Klassenmethode von %s)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (Attribut von %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python-Modulindex"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "Module"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Veraltet"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "Klassenmethode"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statische Methode"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (veraltet)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (Direktive)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (Rolle)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "Direktive"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "Rolle"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "Umgebungsvariable; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "Glossareintrag"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "Grammatik-Token"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "Referenz-Label"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "Umgebungsvariable"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "Programmoption"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Modulindex"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Suche"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "siehe %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "siehe auch %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Sonderzeichen"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2388,165 +2410,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2560,11 +2602,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2574,14 +2616,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2591,29 +2633,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[Diagramm: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[Diagramm]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2626,148 +2669,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(in %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[Quellcode]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Zu tun"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<ursprüngliche Eintrag>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Der <<ursprüngliche Eintrag>> steht in %s, Zeile %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "ursprüngliche Eintrag"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[Doku]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Modul-Quellcode"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Quellcode für %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Überblick: Modul-Quellcode"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alle Module, für die Quellcode verfügbar ist</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2775,104 +2828,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "Alias von :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2887,107 +2993,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Achtung"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Vorsicht"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Gefahr"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Fehler"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Hinweis"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Wichtig"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Bemerkung"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Siehe auch"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tipp"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Warnung"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "Fortsetzung der vorherigen Seite"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "Fortsetzung auf der nächsten Seite"
@@ -3004,181 +3134,181 @@ msgstr ""
 msgid "page"
 msgstr "Seite"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Inhaltsverzeichnis"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Suche"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Los"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Quellcode anzeigen"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Übersicht"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Willkommen! Dies ist"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "die Dokumentation für"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "zuletzt aktualisiert"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Verzeichnisse und Tabellen:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Vollständiges Inhaltsverzeichnis"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "Liste aller Kapitel und Unterkapitel"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "durchsuche diese Dokumentation"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Globaler Modulindex"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "schneller Zugriff auf alle Module"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "alle Funktionen, Klassen, Begriffe"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Stichwortverzeichnis &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Gesamtes Stichwortverzeichnis auf einer Seite"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Stichwortverzeichnis nach Anfangsbuchstabe"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "kann groß sein"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigation"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Suche in %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Über dieses Dokument"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Zuletzt aktualisiert am %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Mit <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s erstellt."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Suche in %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Vorheriges Thema"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "vorheriges Kapitel"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Nächstes Thema"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "nächstes Kapitel"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Bitte aktivieren Sie JavaScript, wenn Sie die Suchfunktion nutzen wollen."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "suchen"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Suchergebnisse"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Ihre Suche ergab keine Treffer. Bitte stellen Sie sicher, dass alle Wörter richtig geschrieben sind und genügend Kategorien ausgewählt sind."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Schnellsuche"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Diese Seite"
 
@@ -3210,19 +3340,19 @@ msgstr "C API-Änderungen"
 msgid "Other changes"
 msgstr "Andere Änderungen"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Link zu dieser Überschrift"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Link zu dieser Definition"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Suchergebnisse ausblenden"
 
@@ -3234,12 +3364,12 @@ msgstr "Suchen"
 msgid "Preparing search..."
 msgstr "Suche wird vorbereitet..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Die Suche ist fertig, es wurde(n) %s Seite(n) mit Treffern gefunden."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", in "
 
@@ -3252,7 +3382,7 @@ msgstr "Seitenleiste ausklappen"
 msgid "Collapse sidebar"
 msgstr "Seitenleiste einklappen"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Inhalt"
 
@@ -3271,199 +3401,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Link zu dieser Tabelle"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Link zu diesem Quellcode"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Link zu diesem Bild"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Permanenter Link zu diesem Inhaltsverzeichnis"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Fußnoten"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[Bild: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[Bild]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/el/LC_MESSAGES/sphinx.po b/sphinx/locale/el/LC_MESSAGES/sphinx.po
index 6c0fc667bab..3b283c06f38 100644
--- a/sphinx/locale/el/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/el/LC_MESSAGES/sphinx.po
@@ -1,149 +1,155 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Stelios Vitalis <liberostelios@gmail.com>, 2015
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2021
 # tzoumakers tzoumakers <tzoumakersx@gmail.com>, 2019
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Greek (http://www.transifex.com/sphinx-doc/sphinx-1/language/el/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: el\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "ο κατάλογος παραμετροποίησης δεν περιλαμβάνει κανένα αρχείο conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Δεν είναι δυνατή η εύρεση του καταλόγου πηγής (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Ο κατάλογος πηγής και ο κατάλογος προορισμού δεν είναι δυνατό να είναι ίδιοι"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Εκτέλεση Sphinx έκδοση %s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s και επομένως δεν είναι δυνατή η μεταγλωτισση με αυτή την έκδοση."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "δημιουργία καταλόγου εξόδου"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "κατά τον καθορισμό της επέκτασης %s"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "η 'παραμετροποίηση' σύμφωνα με τον τρέχοντα ορισμό στο conf.py δεν αποτελεί καλέσιμο. Παρακαλείσθε να τροποποιήσετε τον ορισμό ώστε να το κάνετε μία καλέσιμη συνάρτηση. Αυτό απαιτείται προκειμένου το conf.py να συμπεριφέρεται ως μία επέκταση Sphinx."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "φόρτωση μεταφράσεων [%s]..."
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "ολοκλήρωση"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "δεν είναι διαθέσιμο για εσωτερικά μηνύματα"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr "φόρτωση πακτωμένου περιβάλλοντος"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "αποτυχία: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Δεν επιλέχθηκε μεταγλωττιστής, θα χρησιμοποιηθεί ο προεπιλεγμένος: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "επιτυχία"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "ολοκλήρωση με προβλήματα"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "μεταγλώττιση %s, %s προειδοποίηση"
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "μεταγλώττιση %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "η κλάση κόμβου %r έχει ήδη καταχωρηθεί, οι επισκέπτες της θα υπερσκελιστούν"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "η οδηγία %r έει ήδη καταχωρηθεί, θα υπερσκελιστεί"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "ο ρόλος %r έχει ήδη καταχωρηθεί, θα υπερσκελιστεί"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -151,12 +157,12 @@ msgid ""
 "explicit"
 msgstr "η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε από  το δημιουργό της επέκτασης να το ελέγχει και να το κάνει σαφές"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -164,59 +170,59 @@ msgid ""
 "explicit"
 msgstr "η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε το δημιουργό της επέκτασης να το ελέγξει και να το κάνει σαφές"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "εκτέλεση σειριακής %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης καταλόγου %r, θα αγνοηθεί (χρησιμοποιήστε το %r για να καθορίσετε τα επιμέρους στοιχεία)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "ανέγκυρος αριθμός %r για τιμή παραμετροποίησης %r, θα αγνοηθεί"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης %r με τύπο ο οποίος δεν υποστηρίζεται, θα αγνοηθεί"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "άγνωστη τιμή παραμετροποίσης %r στην υπερσκέλιση, θα αγνοηθεί"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Δεν υπάρχει τέτοια τιμή παραμετροποίησης: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Η τιμή παραμετροποίησης %r υφίσταται ήδη."
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Υπάρχει ένα συντακτικό λάθος στο αρχείο παραμετροποίησής σας: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Το αρχείο παραμετροποίησης (ή ένα από τα στοιχεία που εισάγει) κάλεσε την sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,58 +230,51 @@ msgid ""
 "%s"
 msgstr "Υπάρχει ένα προγραμματιστικό λάθος στο αρχείο παραμετροποίησής σας:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, 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:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Τομέας %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Εικ. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Πίνακας %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Λίστα %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "Η τιμή παραμετροποίησης '{name}' πρέπει να λαμβάνει μία από τις {candidates} αλλά εκχωρήθηκε η '{current}'."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "Η τιμή παραμετροποίησης '{name]' έχει τύπο '[current__name__}'; αναμενόμενη {permitted}."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "Η τιμή παραμετροποίησης '{name}' έχει τύπο '{current__name__}', αρχικοποίηση σε '{default__name__}'."
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "η τιμή παραμετροποίησης %r έχει καθοριστεί σε μία στοιχειοσειρά με χαρακτήρες μη ASCII; αυτό μπορεί να οδηγήσει στην εμφάνιση λαθών Unicode. Παρακαλείσθε να χρησιμοποιείται στοιχειοσειρές Unicode, δηλ. %r."
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -283,405 +282,430 @@ msgstr "το primary_domain %r δεν βρέθηκε, θα αγνοηθεί."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "Από την έκδοση 2.0, το Sphinx χρησιμοποιεί το \"index\" ως master_doc από προεπιλογή. Παρακαλείσθε να προσθέσετε το \"master_doc = 'conetnts'\" στο δικό σας conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Το συμβάν %r υπάρχει ήδη"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Άγνωστο όνομα συμβάντος: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "Η επέκταση %s απαιτείται από τις ρυθμίσεις needs_extensions, αλλά δεν είναι φορτωμένη."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Το έργο χρειάζεται την επέκταση %s τουλάχιστον στην έκδοση %s και επομένως δεν είναι δυνατή η μεταγλώττιση με τη φορτωμένη έκδοση (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Το όνομα %r δεν είναι γνωστό"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "Δεν είναι δυνατό το lex του literal_block ως %s. Η επισήμανση παραβλέφθηκε."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "το έγγραφο δεν είναι αναγνωσιμό. Θα αγνοηθεί."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Η κλάση μεταγλώττισης %s δεν έχει χαρακτηριστικό \"name\" "
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Ο μεταγλωττιστής %r υφίσταται ήδη (στο δομοστοιχείο %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Το όνομα μεταγλωττιστή %s δεν είναι καταχωρημένο ή διαθέσιμο δια μέσου του σημείου εισαγωγής"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Το όνομα μεταγλωττιστή %sδεν είναι καταχορημένο"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "ο τομέας %s είναι ήδη καταχωρημένος"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "ο τομέας %s δεν έχει καταχωρηθεί ακόμη"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "Η οδηγία %r είναι ήδη καταχωρημένη στον τομέα %s"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Ο ρόλος %r είναι ήδη καταχωρημένος στον τομέα %s"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "Ο δείκτης %r είναι ήδη καταχωρημένος στον τομέα %s"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "Το object_type %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "Το crossref_type %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "το source_suffix %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "το source_parser για το %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Ο αναλυτής πηγής για το %s δεν είναι καταχωρημένος"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Ο μεταφραστής για το %r υφίσταται ήδη"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "το kwargs για το add_node() πρέπει να είναι μία (visit, depart) συνάρτηση πλειάδας: %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "το enumerable_node %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "ο συνθέτης μαθηματικών %s είναι ήδη καταχωρημένος"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "η επέκταση %r συγχωνεύθηκε ήδη με το Sphinx από την έκδοση %s; η επέκταση αυτή θα αγνοηθεί."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Αρχική εξαίρεση:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Δεν ήταν δυνατή η εισαγωγή της επέκτασης %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "η επέκταση %r δεν έχει συνάρτηση setup(); αποτελεί δομοστοιχείο επέκτασης του Sphinx;"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Η επέκταση %s η οποία χρησιμοποιείται από αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s: επομένως δεν είναι δυνατή η μεταγλώττιση με αυτή την έκδοση."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "η επέκταση %r επιστρέφει ένα μη υποστηριζόμενο αντικείμενο από τη συνάρτησή της setup(): θα έπρεπε να επιστρέφει None ή έναν κατάλογο μεταδεδομένων"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "το θέμα %r δεν έχει ρύθμιση \"theme\""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "το θέμα %r δεν έχει ρύθμιση \"inherit\""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "δεν βρέθηκε θέμα με το όνομα %r, το οποίο κληρονομήθηκε από το %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "η ρύθμιση %s.%s δεν εμφανίζεται από τις παραμετροποιήσεις θέματος που αναζητήθηκαν"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "δόθηκε μη υποστηριζόμενη επιλογή θέματος %r"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "το αρχείο %r στο μονοπάτι θέματος δεν αποτελεί ένα έγκυρο zipfile ή δεν περιλαμβάνει ένα θέμα"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "το sphinx_rtd_theme δεν αποτελεί πλέον μία σκληρή εξάρτηση από την έκδοση 1.4.0. Παρακαλείσθε να το εγκαταστήσετε χειροκίνητα. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "δεν βρέθηκε θέμα με όνομα %r (απουσιάζει το theme.conf;)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "μεταγλώττιση [mo]:"
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "εγγραφή εξόδου..."
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "όλα τα αρχεία po του %d"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "στόχοι για τα αρχεία po του %d οι οποίοι έχουν καθοριστεί"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "στόχοι για τα αρχεία po του %d τα οποία είναι ξεπερασμένα"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "όλα τα αρχεία πηγής"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "το αρχείο %r που δόθηκε στη γραμμή εντολής δεν βρίσκεται κάτω από τον κατάλογο πηγής, θα αγνοηθεί"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "το αρχείο %r που δόθηκε στη γραμμή εντολής δεν υπάρχει, θα αγνοηθεί"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "τα αρχεία πηγής %d που δόθηκαν στη γραμμή εντολής"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "στόχοι για τα αρχεία πηγής %d τα οποία είναι ξεπερασμένα"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "μεταγλώττιση [%s]:"
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "αναζήτηση για νεοξεπερασμένα αρχεία..."
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "βρέθηκε %d"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "δεν βρέθηκε κανένα"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr "Περιβάλλον μετατροπής αντικειμένων Python σε ροή bytes"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr "έλεγχος συνοχής"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "κανένας στόχος δεν είναι ξεπερασμένος."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "αναβάθμιση περιβάλλοντος:"
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s προστέθηκε, %s άλλαξε, %s απομακρύνθηκε"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "ανάγνωση πηγών..."
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "σε αναμονή για εργάτες..."
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "docname προς εγγραφή: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "προετοιμασία κειμένων"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "βρέθηκε διπλότυπη εγγραφή ToC: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "αντιγραφή εικόνων..."
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "δεν είναι δυνατή η ανάγωνση αρχείου εικόνας %r: αντί αυτού θα αντιγραφεί"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "δεν είναι δυνατή η αντιγραφή αρχείου εικόνας %r: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "δεν είναι δυνατή η εγγραφή αρχείου %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr "Το pillow δεν βρέθηκε - αντιγραφή αρχείων εικόνας"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "εγγραφή %s αρχείου..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "άγνωστο mimetype για %s, θα ανγοηθεί"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "εγγραφή %s αρχείου..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Το αρχείο επισκόπησης είναι σε %(outdir)s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "καμία αλλαγή στην έκδοση %s."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "εγγραφή αρχείου σύνοψης"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Ενσωματωμένες λειτουργίες"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Επίπεδο μονάδας λειτουργίας"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "αντιγραφή αρχείων πηγής..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "δεν ήταν δυνατή η ανάγνωση %r για τη δημιουργία changelog"
@@ -690,160 +714,164 @@ msgstr "δεν ήταν δυνατή η ανάγνωση %r για τη δημι
 msgid "The dummy builder generates no files."
 msgstr "Ο προσωρινός μεταγλωττιστής δεν δημιουργεί αρχεία."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Το αρχείο ePub βρίσκεται σε %(outdir)s."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_language\" (ή \"language\") δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_uid\" πρέπει να είναι XML NAME για EPUB3"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_title\" (ή \"html_title\") δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_author\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_contributor\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_description\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_publisher\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_copyright\" (ή \"copyright\") δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_identifier\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"version\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "ανέγκυρο css_file: %r, θα αγνοηθεί"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Οι κατάλογοι των μηνυμάτων είναι στο %(outdir)s."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "στόχοι για %d πρότυπα αρχεία"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "ανάγνωση προτύπων..."
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "εγγραφή καταλόγων μηνύματος..."
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Αναζητήστε οποιαδήποτε λάθη στο παραπάνω αποτέλεσμα ή σε %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "Δεν βρέθηκε το anchor '%s'"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "λανθασμένος σύνδεσμος: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "Δεν βρέθηκε το anchor '%s'"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Οι σελίδες manual βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"man_pages\"; δεν θα καταγραφούν manual pages"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "εγγραφή"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "η τιμή παραμετροποίησης \"man_pages\" κάνει αναφορά το άγνωστο κείμενο %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Η σελίδα HTML είναι στο %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "συναρμολόγηση απλού κειμένου"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "εγγραφή επιπρόσθετων αρχείων"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Τα αρχεία Texinfo βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του makeinfo\n(χρησιμοποιήστε το 'make info' εδώ για να το κάνετε αυτόματα)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "δεν βρέθηκε τιμή \"texinfo_documents\": δεν θα γίνει εγγραφή κανενός κειμένου"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "η τιμή παραμετροποίησης \"texninfo_documents\" αναφέρεται σε άγνωστο κείμενο %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "επεξεργασία %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "επίλυση αναφορών..."
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (σε "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "αντιγραφή αρχείων υποστήριξης Texinfo"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "σφάλμα κατά την εγγραφή του αρχείου Makefile: %s"
@@ -853,18 +881,18 @@ msgstr "σφάλμα κατά την εγγραφή του αρχείου Makefi
 msgid "The text files are in %(outdir)s."
 msgstr "Τα αρχεία κειένου βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "σφάλμα καταγραφής αρχείου %s: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s."
@@ -879,290 +907,302 @@ msgstr "το αρχείο πληροφοριών μεταγλώττισης εί
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Οι σελίδες HTML βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Αδυναμία ανάγνωσης αρχείου πληροφοριών μεταγλώττισης: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
-msgstr "%d de %B de %Y"
-
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "η τιμή παραμετροποίησης html_use_opensearch πρέπει να είναι τώρα στοιχειοσειρά"
+msgstr "%d %B %Y"
 
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Κεντρικό Ευρετήριοο"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "ευρετήριο"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "επόμενο"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "προηγούμενο"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "αντιγραφή αρχείων μεταφόρτωσης..."
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "δεν είναι δυνατή η αντιγραφή του μεταφορτωμένου αρχείου %r: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "αντιγραφή στατικών αρχείων..."
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "δεν είναι δυνατή η αντιγραφή στατικού αρχείου %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "δεν είναι δυνατή η αντιγραφή του επιπλέον αρχείου %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Αδυναμία εγγραφής του αρχείου πληροφοριών μεταγλώττισης: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "ο κατάλογος εύρεσης δεν ήταν δυνατό να φορτωθεί, αλλά δε θα μεταγλωττιστούν όλα τα έγγραφα: ο κατάλογος δε θα είναι πλήρης."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "η σελιδα %s ταιριάζει δύο σχέδια στo html_sidebars: %r and %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "ένα σφάλμα Unicode παρουσιάστηκε κατά τη δημιουργία της σελίδας %s. Παρακαλείστε να επιβεβαιώσετε ότι όλες οι τιμές παραμετροποίησης οι οποίες περιλαμβάνουν μη-ASCII περιεχόμενο είναι στοιχειοσειρές Unicode."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Ένα σφάλμα συνέβη κατά τη σύνθεση της σελίδας %s.\n\nΑιτία %r "
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "ανέγκυρο js_file: %r, θα αγνοηθεί"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Πολλά math_renderers έχουν καταγραφεί. Αλλά δεν έχει επιλεγεί κανένα math_renderer."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Δόθηκε άγνωστο math_renderer %r."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "Η εγγραφή html_extra_path %r δεν υπάρχει"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "η εγγραφή html_static_path %r δεν υπάρχει"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "το αρχείο logo %r δεν υπάρχει"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "το αρχείο favicon %r δεν υπάρχει"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "Τεκμηρίωση του %s - %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Τα αρχεία LaTeX βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του (pdf)latex\n(χρησιμοποιήστε το 'make latexpdf' εδώ για να το κάνετε αυτόματα)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"latex_documents\": δεν θα πραγματοποιηθεί εγγραφή για κανένα κείμενο"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "η τιμή παραμετροποίησης \"latex_documents\" κάνει αναφορά το άγνωστο κείμενο %s"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Ευρετήριο"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Δημοσίευση"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "καμία γνωστή επιλογή Babel για τη γλώσσα %r"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "αντιγραφή αρχείων υποστήριξης TeX"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "αντιγραφή αρχείων υποστήριξης TeX..."
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "αντιγραφή επιπρόσθετων αρχείων"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Παρουσιάστηκε εξαίρεση κατά τη μεταγλώττιση, εκκίνηση αποσφαλματιστή: "
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "σφάλμα reST markup:"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Σφάλμα κωδικοποίησης:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Το πλήρες ιστορικό έχει αποθηκευτεί σε %s, σε περίπτωση που  επιθυμείτε να αναφέρετε το ζήτημα στους προγραμματιστές."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Σφάλμα αναδρομής:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "Αυτό μπορεί να συμβεί με πολύ μεγάλα ή βαθιά εμφωλιασμένα αρχεία πηγής. Μπορείτε προσεκτικά να αυξήσετε την προεπιλεγμένη τιμή αναδρομικότητας Python στο conf.py με π.χ.:"
+msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "Εμφανίστηκε εξαίρεση:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Παρακαλείστε να το αναφέρετε αν ήταν ένα σφάλμα χρήσης, ώστε ένα καλύτερο μήνυμα σφάλματος να δοθεί την επόμενη φορά."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Μία αναφορά σφάλματος μπορεί να υποβληθεί στον ινχηλάτη στο https://github.com/sphinx-doc/sphinx/issues>. Ευχαριστούμε!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "ο αριθμός εργασίας θα πρέπει να είναι θετικός αριθμός"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Για περισσότερες πληροφορίες, επισκεφτείτε το <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,279 +1219,273 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nΔημιουργία τεκμηρίωσης από τα αρχεία πηγής.\n\nτο sphinx-builld δημιουργεί τεκμηρίωση από τα αρχεία στο SOURCEDIR και τα τοποθετεί \nστο OUTPUTDIR. Αναζητά το \"conf.py\" στο SOURCEDIR για τις ρυθμίσεις παραμετροποίησης.\nΤο εργαλείο 'sphinx-quickstarter' μπορεί να χρησιμοποιηθεί για να δημιουργηθούν τα πρότυπα αρχεία,\nσυμπεριλαμβανομένου του 'conf.py'\n\nΤο sphinx-build μπορεί να δημιουργήσει τεκμηρίωση σε διάφορους τύπους. Ένας τύπος \nεπιλέγεται καθορίζοντας το όνομα του μεταγλωττιστή στη γραμμή εντολών: η προεπιλογή είναι\nHTML. Οι μεταγλωττιστές μπορούν επίσης να εκτελέσουν άλλες εργασίες σχετικές με την επεξεργασία \nτης τεκμηρίωσης.\n\nΑπό προεπιλογή, οτιδήποτε είναι ξεπερασμένο θα μεταγλωττιστεί. Αποτέλεσμα μόνο για συκεγκεκριμένα \nαρχεία μπορεί να παραχθεί καθορίζοντας επι μέρους ονομάτων αρχείων.\n"
+msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "μονοπάτι για τα αρχεία πηγής τεκμηρίωσης"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "μονοπάτι στον κατάλογο εξόδου"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "μία λίστα με συγκεκριμένα αρχεία να επαναμεταγλωττιστούν. Θα αγνοηθεί αν δοθεί το -a"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "γενικές επιλογές"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "μεταγλωττιστής για χρήση (προεπιλογή: html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "εγγραφή όλων των αρχείων (προεπιλογή: εγγραφή μόνο νέων και αλλαγμένων αρχείων)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "μην χρησιμοποιείτε ένα αποθηκευμένο περιβάλλον, πάντα να διαβάζετε όλα τα αρχεία"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "μονοπάτι για το αποθηκευμένο περιβάλλον και τα αρχεία doctree (προεπιλογή: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "παράλληλος μεταγλωττισμός με Ν διεργασίες όπου είναι δυνατό (ιδιαίτερη τιμή \"auto\" θα ορίσει Ν στο cpu-count)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "το μονοπάτι όπου βρίσκεται το αρχείο παραμετροποίησης (conf.py) (προεπιλογή: το ίδιο όπως το SOURCEDIR)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "να μη χρησιμοποιηθεί κανένα αρχείο παραμετροποίησης, μόνο επιλογές -D"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "παράκαμψη ρύθμισης στο αρχείο παραμετροποίησης"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "μεταφορά τιμής στα πρότυπα HTML"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "ορίστε ετικέτα: συμπεριλάβατε \"only\" τμήματα με TAG"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "Ο τρόπος nit-picky, προειδοποιεί για όλες τις αναφορές που απουσιάζουν"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "επιλογές εξόδου κονσόλας"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "αυξήστε τον βερμπαλισμό (μπορεί να επαναληφθεί)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "καμία έξοδος στο stdout, μόνο προειδοποιήσεις στο stderr"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "κανένα αποτέλεσμα ούτε προειδοποιήσεις"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "να γίνεται εκπομπή χρωματιστής εξόδου (προεπιλογή: auto-detect)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "να μην παρουσιάζεται έγχρωμο αποτέλεσμα (προεπιλογή: αυτόματη αναγνώριση)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "προειδοποιήσεις εγγραφής (και σφάλματα) στο δοθέν αρχείο"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "μετατροπή προειδοποιήσεων σε σφάλματα"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "απεικόνιση πλήρους ιστορικού σε περίπτωση εξαίρεσης"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "εκτέλεση Pdb σε περίπτωση εξαίρεσης"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "δεν είναι δυνατή η εύρεση αρχείων %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "δεν γίνεται συνδιασμός της επιλογής -a και των ονομάτων αρχείων"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "δεν είναι δυνατό το άνοιγμα του αρχείου προειδοποίησης %r: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "Το όρισμα -D πρέπει να είναι της μορφής όνομα=τιμέ"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "Το όρισμα -Α πρέπει να είναι της μορφής όνομα=τιμή"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "αυτόματη εισαγωγή docstrings από τα δομοστοιχεία"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "αυτόματα κομμάτια δοκιμαστικού κώδικα σε τμήματα doctest"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "σύνδεσμος μεταξύ τεκμηρίωσης Sphinx διαφόρων έργων"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "γράψτε εγγραφές \"todo\" οι οποίες μπορούν αν εμφανίζονται ή να αποκρύπτονται κατά τη μεταγλώττιση"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "αναζήτηση για κάλυψη βιβλιογραφίας"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "να συμπεριληφθεί το math, απεικονισμένο ως εικόνες PNG η SVG"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "να συμπεριληφθεί το math, απεικονισμένο στο φυλλομετρηρή απο το MathJax"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "υποθετική εισαγωγή περιεχομένου βασισμένη στις τιμές παραμετροποίησης"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "να συμπεριληφθούν σύνδεσμοι στον πηγαίο κώδικα των τεκμηριωμένων αντικειμένων Python"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "δημιουργία αρχείου .nojekyll για έκδοση του εγγράφου στις σελίδες GitHub "
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "Παρακαλείστε να εισάγετε ένα έγκυρο όνομα μονοπατιού."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Παρακαλείστε να εισάγετε κάποιο κείμενο."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Παρακαλείστε να εισάγετε ένα από τα %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Παρακαλείστε να εισάγετε είτε 'y' είτε 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Παρακαλείστε να εισάγετε μία επέκταση αρχείου, π.χ. '.rst' ή '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "* Σημείωση: εισήχθησαν μη-ASCII χαρακτήρες και είναι άγνωστη η κωδικοποίηση του τερματικού -- λαμβάνεται ως UTF-8 ή Latin-1."
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Καλώς ήρθατε στο εργαλείο γρήγορης εκκίνησης Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "Ριζικό μονοπάτι για την τεκμηρίωση"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Σφάλμα: ένα υπάρχον conf.py έχει βρεθεί στοn επιλεγμένο ριζικό κατάλογο."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα έργα Sphinx."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Παρακαλείστε να εισάγετε ένα νέο ριζικό μονοπάτι (ή απλά πιέστε το Enter για έξοδο)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Ξεχωριστοί κατάλογοι για πηγή και μεταγλώττιση (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "Πρόθεμα ονόματος για πρότυπα και στατικούς καταλόγους"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Όνομα έργου"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Όνομα(τα) συγγραφέα"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1460,15 +1494,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Έκδοση έργου"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Κυκλοφορία έργου"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1478,21 +1512,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Γλώσσα έργου"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Επέκταση αρχείου πηγής"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1500,91 +1534,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Όνομα του κυρίους σας εγγράφου (χωρίς επέκταση)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Σφάλμα: το κύριο αρχείο %s έχει ήδη βρεθεί στο επιλεγμένο ριζικό κατάλογο."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα αρχεία."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Παρακαλείσθε να εισάγετε ένα νέο όνομα αρχείου, ή να μεταονομάσετε το υπάρχον αρχείο και να πιέσετε το Enter"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Υποδείξτε ποιά απο τις ακόλουθες επεκτάσεις Sphinx πρέπει να ενεργοποιηθούν:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Σημείωση: τα imgmath και mathjax δεν είναι δυνατό να ενεργοποιηθούν ταυτόχρονα. Το imgmath έχει αποεπιλεγθεί. "
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Δημιουργία Makefile; (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "Δημιουργία αρχείου εντολών Windows; (y/n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Δημιουργία αρχείου %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Το αρχείο %s υπάρχει ήδη, παραλείπεται."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Ολοκλήρωση: μία αρχική δομή καταλόγου δημιουργήθηκε."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1594,787 +1628,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nΔημιουργία απαιτούμενων αρχείων για ένα έργο Sphinx.\n\nΤο sphinx-quickstart είναι ένα διαδραστικό εργαλείο το οποίο κάνει κάποιες ερωτήσεις για το δικό σας \nέργο και μετά δημιουργεί έναν πλήρη κατάλογο τεκμηρίωσης και δείγμα \nMakefile για να χρησιμοποιηθεί με το sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "ήσυχος τρόπος"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "Επιλογές δομής"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "αν ορίζεται, θα ξεχωρίσουν οι κατάλογοι πηγής και μεταγλώττισης"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "αντικατάσταση για τελεία σε _templates κλπ."
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "Βασικές επιλογές έργου"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "όνομα έργου"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "ονόματα συγγραφέων"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "έκδοση του έργου"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "δημοσίευση του έργου"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "γλώσσα εγγράφου"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "επέκταση αρχείου πηγής"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "κύριο όνομα εγγράφου"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "χρηση epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Επιλογές επέκτασης"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "ενεργοποίηση της επέκτασης %s"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "ενεργοποίηση αυθαίρετων επεκτάσεων"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Δημιουργία Makefile και Batchfile"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "δημιουργία makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "να μη δημιουργηθεί makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "δημιουργία batchfile"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "να μη δημιουργηθεί batchfile"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "χρησιμοποιήστε το make-mode για το Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "μην χρησιμοποιείτε make-mode για Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "Προτυποποίηση έργου"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "πρότυπος κατάλογος για πρότυπα αρχεία"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "ορίστε μία τιμή προτύπου"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "καθορίστηκε το \"quiet\", αλλά δεν καθορίστηκε είτε το \"project\" είτε το \"author\"."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Σφάλμα: το καθορισθέν μονοπάτι δεν είναι κατάλογος, ή τα αρχεία sphinx υπάρχουν ήδη."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "Το sphinx-quickstart δημιουργεί μόνο εντός ενός κενού καταλόγου. Παρακαλείσθε να καθορίσετε ένα νέο ριζικό μονοπάτι."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Ανέγκυρη μεταβλητή προτύπου: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "Ανιχνεύθηκε προσπάθεια υπερβολικής μείωσης εσοχών"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Ανέγκυρη λεζάντα: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "η προδιαγραφή αριθμού σειράς είναι εκτός e;yroyw (1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Δεν είναι δυνατή η ταυτόχρονη χρήση των επιλογών \"%s\" και \"%s\""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Το συμπεριληφθέν αρχείο %r δεν βρέθηκε ή απέτυχε η ανάγνωσή του"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Η κωδικοποίηση %r που χρησιμοποιήθηκε για την ανάγνωση του συμπεριληφθέντος αρχείου %r φαίνεται να είναι λανθασμένη, προσπαθήστε να δώσετε μία επιλογή :encoding:"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Το αντικείμενο  με όνομα %r δεν βρέθηκε στο συμπεριληφθέν αρχείο %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Δεν είναι δυνατή η χρήση \"leneno-match\" με ένα κομματιασμένο σετ απο \"lines\""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Προσδιορισμός γραμμής %r: δεν ελήφθησαν γραμμές από το συμπεριληφθέν αρχείο %r"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Συντάκτης τμήματος: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Συντάκτης μονάδας: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Συντάκτης κώδικα: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Συντάκτης: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Παράμετροι"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Επιστρέφει"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Επιστρεφόμενος τύπος"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (συνάρτηση C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (μέλος C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (μακροεντολή C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (τύπος C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "μέλος"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (μεταβλητή C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "μεταβλητή"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "συνάρτηση"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "μέλος"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "μακροεντολή"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "ένωση"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerator"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "τύπος"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "μεταβλητή"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Νέο στην έκδοση %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Άλλαξε στην έκδοση %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Αποσύρθηκε στην έκδοση %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "Η παραπομπή [%s] δεν αναφέρεται."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "Διπλότυπη δήλωση, η οποία έχει επίσης οριστεί  στο '%s'. \nΉ δήλωση είναι '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Παράμετροι Προτύπου"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Προκαλεί"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "κλάση"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "ένωση"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "έννοια"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerator"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "Διπλότυπος δήλωση, η οποία έχει επίσης οριστεί στο '%s \nΗ δήλωση είναι '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (ενσωματωμένη συνάρτηση)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (μέθοδος της %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (κλάση)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (καθολική μεταβλητή ή σταθερά)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (ιδιότητα της %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Παράμετροι"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (μονάδα)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "μέθοδος"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "δεδομένα"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "ιδιότητα"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "μονάδα"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "διπλότυπη ετικέτα της εξίσωσης %s, άλλη εμφάνιση στο %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Ανέγκυρο math_eqref_format: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "λέξη κλειδί"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "τελεστής"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "αντικείμενο"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "εξαίρεση"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "δήλωση"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "ενσωματωμένη συνάρτηση"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Μεταβλητές"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Προκαλεί"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (στη μονάδα %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (ενσωματωμένη μεταβλητή)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (στη μονάδα %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (ενσωματωμένη μεταβλητή)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (ενσωματωμένη κλάση)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (κλάση σε %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (μέθοδος %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (μέθοδος κλάσης της %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (στατική μέθοδος %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (στατική μέθοδος της %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (μέθοδος κλάσης %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (μέθοδος κλάσης της %s)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (ιδιότητα της %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Ευρετήριο Μονάδων της Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "μονάδες"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Αποσύρθηκε"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "μέθοδος της κλάσης"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "στατική μέθοδος"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "περισσότεροι από έναν στόχοι βρέθηκα για την παραπομπή %r: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (αποσύρθηκε)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (οδηγία)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (ρόλος)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "οδηγία"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "ρόλος"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "μεταβλητή περιβάλλοντος; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Λανθασμένη περιγραφή επιλογής %r, θα πρέπει να μοιάζει με \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" ή \"+opt args\""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "γλωσσάρι"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "γραμματική ένδειξη"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "ετικέτα αναφοράς"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "μεταβλητή περιβάλλοντος"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "επιλογή προγράμματος"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "έγγραφο"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Ευρετήριο μονάδων"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Σελίδα αναζήτησης"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "το numfig έχει απενεργοποιηθεί. Το :numref: θα ανγοηθεί."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "δεν έχει ορισθεί αριθμός για %s:%s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "ο σύνδεσμος δεν έχει λεζάντα: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "ανέγκυρο numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "ανέγκυρο numfig_format: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "νέα παραμετροποίηση"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "η παραμετροποίηση άλλαξε"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "αλλαγμένες επεκτάσεις"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "η έκδοση του περιβάλλοντος μεταλώττισης δεν είναι η τρέχουσα"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "ο πηγαίος κατάλογος έχει αλλάξει"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Το περιβάλλον δεν είναι συμβατό με τον επιλεγμένο μεταγλωττιστή, παρακαλείστε να επιλέξετε ένα διαφορετικό κατάλογο toctree."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Αδυναμία σάρωσης εγγράφων σε %s: %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Ο τομέας %r δεν είναι καταχωρημένος"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr "Βρέθηκε αυτοαναφερόμενο toctree. Θα αγνοηθεί."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "το έγγραφο δεν συμπεριλαμβάνεται σε κανένα toctree"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "δείτε %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "δείτε επίσης %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "άγνωστος τύπος εγγραφής ευρετηρίου %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Σύμβολα"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "αναγνωρίστηκαν κυκλικές αναφορές toctree, θα αγνοηθούν: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "το toctree περιλαμβάνει αναφορά στο έγγραφο %r η οποία δεν έχει τίτλο: δεν θα δημιουργηθεί σύνδεσμος"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "Το toctree περιλαμβάνει αναφορά στο αποκλεισμένο κείμενο %r"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "το toctree περιλαμβάνει αναφορά στο μη υπαρκτό έγγραφο %r"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "το αρχείο εικόνας δεν είναι αναγνώσιμο: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "το αρχείο εικόνας %s δεν είναι αναγνώσιμο: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr "το μεταφορτωμένο αρχείο δεν είναι αναγνώσιμο: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "στο %s έχουν ήδη ανατεθεί αριθμοί τομέα (εμφωλιασμένο αριθμημένο toctree;)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr "Θα δημιουργούσε το αρχείο %s."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2386,165 +2409,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr "\nΑναζητήστε αναδρομικα σε <MODULE_PATH>για δομοστοιχεία Python και πακέτα και δημιουργήστε \nένα αρχείο reST με οδηγίες automodule για κάθε πακέτο στο <OUTPUT_PATH>.\n\nΤα <EXCLUDE_PATTERN>μπορεί να αποτελούν αρχεία ή/και σχέδια καταλόγων τα οποία θα \nεκτελεστούν κατά τη δημιουργία.\n\nΣημείωση: από προεπιλογή αυτό το σενάριο δεν θα αντικαταστήσει τα ήδη δημιουργημένα αρχεία."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr "μονοπάτι για το δομοστοιχείο για το έγγραφο"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "αρχεία fnmatch-style και/ή υποδείγματα καταλόγου που θα εξαιρεθούν από τη δημιουργία"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr "κατάλογο για τοποθέτηση όλων των προϊόντων"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "μέγιστο βάθος από υποδομοστοιχεία για απεικόνιση στο TOC (προεπιλογή: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "αντικατάσταση υπάρχοντων αρχείων"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "ακολουθία συμβολικών συνδέσμων. Ισχυρό όταν συνδυάζεται με το collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "εκτελέστε το σενάριο χωρίς τη δημιουργία αρχείων"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr "τοποθετήστε βιβλιογραφία για κάθε δομοστοιχείο στη δικής της σελίδα"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr "να συμπεριληφθούν τα δομοστοιχεία \"_private\""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr "όνομα αρχείου του πίνακα περιεχομένων (προεπιλογή: δομοστοιχεία)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "να μη δημιουργηθεί αρχείο με πίνακα περιεχομένων"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "μη δημιουργείτε κεφαλίδες για πακέτα δομοστοιχείων/πακέτων (π.χ. όταν τα docstrings τα περιλαμβάνουν ήδη)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr "τοποθέτηση βιβλιογραφίας δομοστοιχείου πριν από την βιβλιογραφία υπόδομοστοιχείου"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
-msgstr "ερμηνεία μονοπατιών δομοστοιχείων σύμφωνα με την προδιαγραφή POP-0420 αυτονόητων namespaces"
+msgstr "ερμηνεία μονοπατιών δομοστοιχείων σύμφωνα με την προδιαγραφή  POP-0420 αυτονόητων namespaces"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "επέκταση αρχείου (προεπιλογή: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr "δημιουργία ενός πλήρους έργου με το sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "η προσθήκη του module_path στο sys.path, χρησιμοποιείται όταν δίδεται το --full"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr "όνομα έργου (προεπιλογή: όνομα ριζικού δομοστοιχείου)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr "συγγραφέας(εις) έργου, χρησιμοποιείται όταν δίδεται το --full"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr "έκδοση έργου, χρησιμοποιείται όταν δίνεται το --full"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "έκδοση έργου, χρησιμοποιείται όταν δίδεται το --full, προεπιλογή σε --doc-version"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "επιλογές επέκτασης"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "το %s δεν είναι κατάλογος."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "ανέγκυρο regex %r σε %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Η δοκιμή της κάλυψης στις πηγές ολοκληρώθηκε, δείτε τα αποτελέσματα στο %(outdir)s python.txt."
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "ανέγκυρο regex %r στο coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "το δομοστοιχείο %s δεν ήταν δυνατό να εισαχθεί: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "λείπει '+' ή '-' στην επιλογή '%s'."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "Η '%s δεν είναι μία έγκυρη επιλογή."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' δεν αποτελεί μία έγκυρη επιλογή για pyversion"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "ανέγκυρος τύπος TestCode"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Ολοκληρώθηκε η δοκιμή των doctests στις πηγές, δείτε τα αποτελέσματα σε %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "δεν υπάρχει κώδικας/αποτέλεσμα στο τμήμα %s στο %s:%s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "Ο ανέγκυρος κώδικας doctest θα αγνοηθεί: %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2558,11 +2601,11 @@ msgstr "Η οδηγία Graphviz δεν είναι δυνατό να περιλ
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Το εξωτερικό αρχείο Graphviz %r δεν βρέθηκε ή απέτυχε η ανάγνωσή του"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Η οδηγία χωρίς περιεχόμενο \"graphviz\" θα αγνοηθεί."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2572,14 +2615,14 @@ msgid ""
 "%r"
 msgstr "το dot δεν παρήγαγε κανένα αρχείο εξόδου:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "η εντολή dot %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για αποτέλεσμα graphviz), ελέγξτε τη ρύθμιση graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2589,29 +2632,30 @@ msgid ""
 "%r"
 msgstr "το dot ολοκλήρωσε με σφάλμα:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "Το graphviz_output_format πρέπει να είναι ένα από τα 'png', 'svg', αλλά είναι %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr "κωδικός dot %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[γράφημα: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[γράφημα]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2624,148 +2668,158 @@ msgid ""
 "%r"
 msgstr "η μετατροπή ολοκλήρωσε με σφάλμα:[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "Η εντολή LaTex %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για απεικόνιση μαθηματικών), ελέγξτε τη ρύθμιση imgmath_latex"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s η εντολή %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για μαθηματική απεικόνιση), ελέγξτε τη ρύθμιση imgmath_%s"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr "απεικόνιση latex %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "σε σειρά latex %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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 "το απόθεμα intersphinx έχει μεταφερθεί: %s->%s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "φότωση του αποθέματος intersphinx από %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 "παρουσιάστηκαν κάποια ζητήματα με μερικά απο τα αποθέματα, αλλά υπήρξαν λειτουργικές εναλλακτικές:"
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(στη %s έκδοση %s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(στο %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "το αναγνωριστικό intersphinx %r δεν είναι στοιχειοσειρά. Θα αγνοηθεί"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[πηγή]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Εκκρεμότητα"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "βρέθηκε εγγραφή TODO:%s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Το <<original entry>> βρίσκεται στο %s, γραμή %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "αρχική εγγραφή"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr "επισήμανση κώδικα δομοστοιχείου..."
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[τεκμηρίωση]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Κώδικας μονάδας"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Πηγαίος κώδικας για το %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Επισκόπηση: κώδικας της μονάδας"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Όλες οι μονάδες για τις οποίες υπάρχει διαθέσιμος κώδικας</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "ανέγκυρη υπογραφή για αυτόματο %s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "σφάλμα κατά τη μορφοποίηση των ορισμάτων για %s:%s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "απουσιάζει το χαρακτηριστικό %s στο αντικείμενο %s"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2773,104 +2827,157 @@ msgid ""
 "explicit module name)"
 msgstr "δεν γνωρίζω ποιο δομοστοιχείο να εισάγω για αυτόματη τεκμηρίωση %r (προσπαθήστε να τοποθετήσετε μία οδηγία \"module\" ή  \"currentmodule\" στο έγγραφο, ή να δώσετε ένα σαφές όνομα δομοστοιχείου)"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" στο όνομα automodule δεν βγάζει νόημα"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "ορίσματα υπογραφής ή επιστροφή σημείωσης η οποία δόθηκε για το automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ πρέπει να είναι λίστα στοιχειοσειράς, όχι %r (στο δομοστοιχείο %s) -- θα αγνοηθεί το __all__"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr "απουσιάζον χαρακτηριστικό αναφερόμενο στο δομοστοιχείο :members\" ή __all__: %s, χαρακτηριστικό %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Βάσεις: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "ψευδώνυμο της :κλάσης:`%s`"
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "αδυναμία εισαγωγής %s"
+msgid "autosummary: failed to import %s"
+msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr "αδυναμία ανάλυσης ονόματος %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "αδυναμία εισαγωγής αντικειμένου %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "Το autosummary δημιουργεί αρχεία .rst εσωτερικά. Αλλά το δικό σας source_suffix δεν περιλαμβάνει .rst. Θα παραλειφθεί."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr "[autosummary] δημιουργία autosummary για: %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[αυτόματη περίληψη] εγγραφή στο %s"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2885,107 +2992,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nΔημιουργία ReStrucuredText χρησιμοποιώντας τις οδηγίες autosummary.\n\nΤο sphinx-autogen αποτελεί ένα πρόσθιο εργαλείο για το sphinx.ext.autosummary.generate. Δημιουργεί \nτα αρχεία reStructuredText από τις οδηγίες autosummary οι οποίες περιλαμβάνονται στα \nπαραδοθέντα αρχεία εισόδου.\n\nΗ μορφή της οδηγίας autosummary τεκμηρειώνεται στο \nδομοστοιχείο ``sphinx.ext.autosummary``  της Python και μπορεί να αναγνωστεί χρησιμοποιώντας το :: \n\npydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "αρχεία πηγής για να δημιουργηθούν τα αρχεία reST"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "ο κατάλογος που θα τοποθετεί όλο το αποτέλεσμα εξόδου"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "προεπιλεγμένη επέκταση για αρχεία (προεπιλογή: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "προσαρμοσμένος κατάλογος προτύπου (προεπιλογή: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "μέλη εισαγμένα στο έγγραφο (προεπιλογή: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Ορίσματα λέξης-κλειδί"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Παράδειγμα"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Παραδείγματα"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Σημειώσεις"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Άλλες παράμετροι"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "Αναφορές"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "Προειδοποιήσεις"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr "Αποδόσεις"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Προσοχή"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Προσοχή"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Κίνδυνος"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Σφάλμα"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Συμβουλή"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Σημαντικό"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Σημείωση"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Δείτε επίσης"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Πρακτική συμβουλή"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Προειδοποίηση"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "συνεχίζεται από την προηγούμενη σελίδα"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "συνέχεια στην επόμενη σελίδα"
@@ -3002,181 +3133,181 @@ msgstr "Αριιθμοί"
 msgid "page"
 msgstr "σελίδα"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Πίνακας περιεχομένων"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Αναζήτηση"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Πάμε"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Προβολή κώδικα"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Επισκόπηση"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Καλωσήρθατε! Αυτή είναι"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "η τεκμηρίωση του"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "τελευταία ενημέρωση"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Ευρετήρια και πίνακες:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Πλήρης Πίνακας Περιεχομένων"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "απαριθμεί όλα τα κεφάλαια και υποκεφάλαια"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "αναζήτηση αυτής της τεκμηρίωσης"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Καθολικό Ευρετήριο Μονάδων"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "γρήγορη πρόσβαση σε όλες τις μονάδες"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "όλες οι συναρτήσεις, κλάσεις, όροι"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Ευρετήριο &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Πλήρες ευρετήριο σε μία σελίδα"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Σελίδες ευρετηρίου ανά γράμμα"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "μπορεί να είναι τεράστιο"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Πλοήγηση"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Αναζήτηση στο %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Σχετικά με αυτά τα κείμενα"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a>%(copyright)s"
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Τελευταία ενημέρωση στις %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Δημιουργήθηκε με το <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Αναζήτηση %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Προηγούμενο θέμα"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "προηγούμενο κεφάλαιο"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Επόμενο θέμα"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "επόμενο κεφάλαιο"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Παρακαλώ, ενεργοποιήστε τη JavaScript για να είναι δυνατή η λειτουργία\n    αναζήτησης."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "αναζήτηση"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Αποτελέσματα Αναζήτησης"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Η αναζήτησή σας δεν ταυτοποιήθηκε με κανένα κείμενο. Παρακαλώ, επιβεβαιώστε ότι όλες οι λέξεις έχουν τη σωστή ορθογραφία και ότι έχετε επιλέξεις αρκετές κατηγορίες."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Σύντομη αναζήτηση"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Αυτή η σελίδα"
 
@@ -3208,19 +3339,19 @@ msgstr "Αλλαγές στο API της C"
 msgid "Other changes"
 msgstr "Άλλες αλλαγές"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Μόνιμος σύνδεσμος σε αυτήν την κεφαλίδα"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Μόνιμος σύνδεσμος σε αυτόν τον ορισμό"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Απόκρυψη Ευρεθέντων Αναζητήσεων"
 
@@ -3232,12 +3363,12 @@ msgstr "Εκτελείται η αναζήτηση"
 msgid "Preparing search..."
 msgstr "Προετοιμασία αναζήτησης..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Η αναζήτηση ολοκληρώθηκε, βρέθηκε/αν %s σελίδα/ες με βάση τους όρους αναζήτησης."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", στο "
 
@@ -3250,7 +3381,7 @@ msgstr "Άνοιγμα πλαϊνής μπάρας"
 msgid "Collapse sidebar"
 msgstr "Κλείσιμο πλαϊνής μπάρας"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Περιεχόμενα"
 
@@ -3269,199 +3400,207 @@ msgstr "Δεν υπάρχει αναφορά για την υποσημείωσ
 msgid "Footnote [#] is not referenced."
 msgstr "Η υποσημείωση [#] δεν αναφέρεται."
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ασυνεπείς αναφορές υποσημείωσης στα μεταφρασμένα μηνύματα. original: {0}, translated: {1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "ασυνεπείς αναφορές στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ασυνεπείς αναφορές παραπομπής στο μεταφρασμένο μήνυμα. αρχικό: {0}, μεταφρασμένο: {1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ασυνεπείς αναφορές όρων στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "περισσότεροι από ένας στόχοι βρέθηκαν για 'οποιαδήποτε' παραπομπή %r: θα μπορούσε να είναι %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "Ο %s:%s στόχος αναφοράς δεν βρέθηκε: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "ο στόχος αναφοράς %r δεν βρέθηκε: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Άγνωστος τύπος αρχείου: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "μη κωδικοποιήσιμοι χαρακτήρες πηγής, θα αντικατασταθούν με \"?\": %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr "παράβλεψη"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr "αποτυχία"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "σφάλμα ανάγνωσης: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "καταγραφή λάθους: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Ανέγκυρος τύπος ημερομηνίας. Τοποθετείστε στη στοιχειοσειρά μονά εισαγωγικά εάν θέλετε να το εξάγετε απευθείας: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "το toctree περιλαμβάνει αναφορά σε άγνωστο αρχείο %r"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "εξαίρεση κατά την αξιολόγηση μόνο της έκφρασης οδηγίας: %s"
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr "Η υποστήριξη για αξιολόγηση συντακτικού της Python 2 είναι απαρχαιωμένη και θα αφαιρεθεί απο το Sphinx 4.0. Μετατροπή του %s σε συντακτικό της Python 3."
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "ο προεπιλεγμένος ρόλος %s δεν βρέθηκε"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "δεν έχει καθοριστεί numfig_format για το %s"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Κανένα ID δεν έχει ανατεθεί στο κόμβο %s"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Απευθείας σύνδεσμος σε αυτόν τον πίνακα"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Απευθείας σύνδεσμος σε αυτόν τον κώδικα"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Απευθείας σύνδεσμος σε αυτήν την εικόνα"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Απευθείας σύνδεσμος σε αυτόν τον πίνακα περιεχομένων"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "Δεν ήταν δυνατή η λήψη του μεγέθους της εικόνας. Η επιλογή :scale: θα αγνοηθεί."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "άγνωστο toplevel_sectioning %r για την κλάσση %r"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr "πολύ μεγάλο :maxdepth:, θα αγνοηθεί."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr "ο τίτλος του εγγράφου δεν είναι μονός κόμβος κειμένου"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "ο ανακαλυφθέν τίτλος κόμβος δεν βρίσκεται σε τομέα, θέμα, πίνακα, προειδοποίηση ή πλαϊνή μπάρα"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Σημειώσεις υποσέλιδου"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "τόσο η επιλογή για tabularcolumns όσο και για :widths: δίνονται. Η επιλογή :widths: θα αγνοηθεί."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "η μονάδα διάστασης %s δεν είναι έγκυρη. Θα αγνοηθεί."
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "βρέθηκε άγνωστος τύπος εγγραφής ευρετηρίου %s"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[εικόνα: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[εικόνα]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "η λεζάντα δεν βρίσκεται εντός μίας εικόνας."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "μη υλοποιημένος τύπος κόμβου: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr "άγνωστος τύπος κόμβου: %r"
diff --git a/sphinx/locale/eo/LC_MESSAGES/sphinx.po b/sphinx/locale/eo/LC_MESSAGES/sphinx.po
index 1af0769f33a..332b31c58e7 100644
--- a/sphinx/locale/eo/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/eo/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Dinu Gherman <gherman@darwin.in-berlin.de>, 2014
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Esperanto (http://www.transifex.com/sphinx-doc/sphinx-1/language/eo/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: eo\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indico universala"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "indico"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "sekva"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "antaŭa"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentaro"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Aŭtoro:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametroj"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr ""
-
-#: sphinx/domains/c.py:189
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C member)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr ""
-
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr ""
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "membro"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funkcio"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "membro"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "nomaĵo"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
-msgstr "tipo"
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
+msgstr "tipo"
+
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klaso"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr ""
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klaso)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "datenoj"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atributo"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "escepto"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "vidu %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "vidu ankaŭ %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simboloj"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Eraro"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,124 +3131,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Universala modjulindico"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Indico &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Aŭtora rajto"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3127,55 +3257,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Antaŭa temo"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "antaŭa ĉapitro"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Sekva temo"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "sekvo ĉapitro"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "serĉu"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3207,19 +3337,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/es/LC_MESSAGES/sphinx.po b/sphinx/locale/es/LC_MESSAGES/sphinx.po
index 65ea746fe22..0be57452619 100644
--- a/sphinx/locale/es/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/es/LC_MESSAGES/sphinx.po
@@ -1,167 +1,172 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Edward Villegas-Pulgarin <cosmoscalibur@gmail.com>, 2018
-# Edward Villegas-Pulgarin <cosmoscalibur@gmail.com>, 2019
+# Edward Villegas-Pulgarin <cosmoscalibur@gmail.com>, 2018-2019
 # Edward Villegas-Pulgarin <cosmoscalibur@gmail.com>, 2018
 # Guillem Borrell <guillem@torroja.dmt.upm.es>, 2011
 # Ivan García <ivan.garcia@studio-point.com>, 2019
 # Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2013-2018,2020
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016,2021
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-16 23:58+0000\n"
-"Last-Translator: Leonardo J. Caballero G. <leonardocaballero@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Spanish (http://www.transifex.com/sphinx-doc/sphinx-1/language/es/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: es\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "directorio de configuración no contiene un archivo conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "No se encuentra directorio fuente (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Directorio fuente y directorio destino no pueden ser idénticos"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Ejecutando Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr "Por razones de seguridad, el modo paralelo está deshabilitado en macOS y python3.8 y superior. Para más detalles, lea https://github.com/sphinx-doc/sphinx/issues/6803"
+msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Este proyecto necesita al menos Sphinx v%s y por lo tanto no se puede construir con esta versión."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "creando directorio de salida"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "mientras configura la extensión %s:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' como se define actualmente en el archivo conf.py no es un Python invocable. Por favor, modifique su definición para que sea una función invocable. Esto es necesario para que el archivo conf.py se comporte como una extensión de Sphinx."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "cargando traducciones [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "hecho"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "no disponible para mensajes incorporados"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr "cargando el ambiente pickled"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "fallo: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Ningún constructor seleccionado, utilizando el valor predeterminado: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "éxitoso"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "finalizo con problemas"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "compilación %s, %sadvertencia (con advertencias tratadas como errores)."
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "compilación %s, %s advertencias (con advertencias tratadas como errores)."
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "construir %s, %s advertencia."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "compilación %s, %s advertencias."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "construir %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "la clase de nodo %r ya está registrada, sus visitantes serán reemplazados"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "la directiva %r ya está registrada, esa se reemplazará"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "el rol %r ya está registrado, ese se reemplazará"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr "la extensión de %s no declara si es seguro para la lectura en paralelo, asumiendo que no es - consulte con el autor de la extensión para comprobar y hacer explícito"
+msgstr "la extensión de %s no declara si es seguro para la lectura  en paralelo, asumiendo que no es - consulte con el autor de la extensión para comprobar y hacer explícito"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "la extensión %s no es segura para lectura paralela"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -169,59 +174,59 @@ msgid ""
 "explicit"
 msgstr "la extensión %s no declara si es seguro para la escritura paralela, suponiendo que no lo sea - solicite al autor de la extensión que lo verifique y haga explicito"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "la extensión %s no es segura para escritura paralela"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "realizando serialmente %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "no se puede reemplazar el ajuste de la configuración del diccionario %r, haciendo caso omiso (utilice %r para definir elementos individuales)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "número no válido %r de valor de configuración %r, haciendo caso omiso"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "no se puede reemplazar los ajustes de configuración %r con tipo no compatible, haciendo caso omiso"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "valor de configuración desconocido %r en anulación, ignorando"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "No hay tal valor de configuración: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Valor de configuración %r ya presente"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Hay un error de sintaxis en su archivo de configuración: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "El archivo de configuración (o uno de los módulos que importa) invocó sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -229,58 +234,51 @@ msgid ""
 "%s"
 msgstr "Hay un error programable en su archivo de configuración:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "El valor de configuración `source_suffix' espera una cadena de caracteres, una lista de cadena de caracteres o un diccionario. Pero `%r' es dado."
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Sección %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Figura %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabla %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Lista %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "El valor de configuración `{name}` tiene que ser uno de {candidates}, pero fue dado `{current}`."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "El valor de configuración `{name}' tiene tipo `{current.__name__}'; esperado {permitted}."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "El valor de configuración `{name}' tiene el tipo `{current.__name__}', el valor predeterminado es `{default.__name__}'."
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "el valor de configuración %r se establece en una cadena con caracteres no ASCII; esto puede provocar errores Unicode. Por favor, utilice cadenas Unicode, ej. %r."
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -288,405 +286,430 @@ msgstr "primary_domain %r no fue encontrado, se ignora."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "Desde la versión 2.0, Sphinx usa \"index\" como master_doc por defecto. Agregue \"master_doc = 'contents'\" a su archivo de configuración conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Evento %r ya presente"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nombre de evento desconocido: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "La extensión %s es requerida por la configuración de needs_extensions, pero esta no es cargada."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Este proyecto necesita la extensión %s por lo menos en la versión %s y por lo tanto no puede ser construido con la versión cargada (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "El nombre del lexer de pigmentos %r se desconoce"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "No pudo el léxico literal_block como \"%s\". Destacado omitido."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "documento no legible. Ignorado."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Constructor clase %s no tiene ningún atributo \"name\""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Constructor %r ya existe (en el módulo %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Nombre de constructor %s no registrados o disponibles a través del punto de entrada"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Nombre de constructor %s no registrado"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "dominio %s ya esta registrado"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "dominio %s no esta registrado"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "La directiva %r ya fue registrada en el dominio %s"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "El rol %r ya fue registrado en el dominio %s"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "El índice %r ya fue registrado en el dominio %s"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "El %r object_type ya está registrado"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "El %r crossref_type ya está registrado"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r ya está registrado"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser para %r ya está registrado"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Analizador de fuentes para %s no registrado"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Traductor para %r ya existe"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "kwargs para la función add_node() debe ser una tupla de función (visitar, salir): %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r ya esta registrado"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "Renderizador matemático %s ya fue registrado"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "la extensión %r ya se fusionó con Sphinx desde la versión %s; esta extensión se omite."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Excepción original:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "No puede importar la extensión %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "extensión %r no tiene ninguna función setup(); ¿es realmente un módulo de extensión de Sphinx?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "La extensión %s utilizada por este proyecto necesita al menos la versión de Sphinx v%s; por lo tanto no puede ser construido con esta versión."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "extensión %r devuelve un objeto no soportado de su función setup(); debe devolver un diccionario de metadatos o ninguno"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "tema %r no tiene configuraciones de \"tema\""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "tema %r no tiene configuraciones de \"heredar\""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "no encontrado ningún tema llamado %r, heredado por %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "configuración de %s.%s se produce en ninguna de las configuraciones de tema buscado"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "opción de tema no soportada %r fue dada"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "archivo %r o ruta del tema no es un archivo zip válido o no contiene ningún tema"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme ya no es una dependencia difícil desde la versión 1.4.0. Por favor, instale manualmente. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "sin tema llamado %r encontrado (¿falta el archivo theme.conf?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "una imagen adecuada para %s constructor no encontrado: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "una imagen adecuada para %s constructor no encontrado: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "compilando [mo]:"
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "escribiendo salida... "
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "Todos los %d archivos po"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "los objetivos para %d los archivos po que se especifican"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "los objetivos para %d los archivos po que estan desactualizados"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "todos los archivos fuente"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "archivo %r dado en la línea de comandos no está en el directorio fuente, ignorado"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "archivo %r dado en la línea de comandos no existe, ignorado"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d archivos fuente dados en la línea de comandos"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "los objetivos para %d los archivos fuentes que estan desactualizados"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "compilando [%s]:"
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "buscando por archivos no actualizados..."
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "encontrado %d"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "no encontrado"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr "preparando ambiente"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr "verificando consistencia"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "no hay archivos objetivo desactualizados."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "actualizando ambiente"
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%sañadido, %s cambiado, %s removido"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "leyendo fuentes..."
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "Esperando a los workers..."
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "docnames para escribir: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "preparando documentos"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "entrada de tabla de contenido duplicada encontrada: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "copiando imágenes..."
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "no puede leer el archivo de imagen %r: en su lugar, lo copia"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "no se puede copiar archivo de imagen %r: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "no se puede escribir archivo de imagen %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr "no se encuentra Pillow - copiando archivos de imágenes"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "escribiendo archivo %s..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "mimetype desconocido para %s, ignorando"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "escribiendo archivo %s..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "El archivo de resumen está en %(outdir)s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "no hay cambios en versión %s."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "escribiendo archivo de resumen..."
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Funciones incorporadas"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Nivel de módulo"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "copiando archivos fuente"
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "no se pudo leer %r for para la creación del registro de cambios"
@@ -695,160 +718,164 @@ msgstr "no se pudo leer %r for para la creación del registro de cambios"
 msgid "The dummy builder generates no files."
 msgstr "El constructor ficticio no genera archivos."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "El archivo ePub está en %(outdir)s."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_language\" (o \"language\") no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "el valor de configuración \"epub_uid\" debe ser XML NAME para EPUB3"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_title\" (or \"html_title\") no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_author\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_contributor\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_description\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_publisher\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_copyright\" (or \"copyright\") no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_identifier\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"version\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "css_file inválido: %r, ignorado"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Los catálogos de mensajes están en %(outdir)s."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "objetivos para los archivos de plantillas %d"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "leyendo plantillas..."
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "escribiendo catálogos de mensajes..."
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Busque cualquier error en la salida anterior o en el archivo %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "Ancla '%s' no encontrado"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "enlace roto: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "Ancla '%s' no encontrado"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Las páginas del manual están en %(outdir)s."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "no se encontró el valor de configuración \"man_pages\"; no se escribirán las páginas del manual"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "escribiendo"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "El valor de configuración \"man_pages\" hace referencia a un documento desconocido %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Página HTML está en %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "ensamblando documento sencillo"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "escribiendo archivos adicionales"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Los archivos Texinfo están en %(outdir)s."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nEjecute el comando 'make' en ese directorio para ejecutarlos a través de makeinfo\n(usa el comando 'make info' aquí para hacer esto automáticamente)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "no se encontró el valor de configuración \"texinfo_documents\"; no se escribirán documentos"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "El valor de configuración \"texinfo_documents\" hace referencia a un documento desconocido %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "procesando %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "resolviendo referencias..."
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (en "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "copiando archivos de soporte Texinfo"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "error escribiendo archivo Makefile: %s"
@@ -858,18 +885,18 @@ msgstr "error escribiendo archivo Makefile: %s"
 msgid "The text files are in %(outdir)s."
 msgstr "Los archivos de texto están en %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "error escribiendo archivo %s: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Los archivos XML están en %(outdir)s."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Los archivos pseudo-XML están en %(outdir)s."
@@ -884,290 +911,302 @@ msgstr "el archivo de información de compilación está roto: %r"
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Las páginas HTML están en %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Error al leer la información de compilación del fichero: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d de %B de %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "El valor de configuración html_use_opensearch ahora debe ser una cadena"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Índice General"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "índice"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "siguiente"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "anterior"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr "generando índices"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr "escribiendo páginas adicionales"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "copiando archivos descargables..."
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "no se puede copiar archivo descargable %r: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "copiando archivos estáticos..."
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "no se puede copiar archivo estático %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr "copiando archivos extras"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "no se puede copiar archivo extra %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Error al escribir el archivo de información de compilación: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "no se pudo cargar el índice de búsqueda, pero no se crearán todos los documentos: el índice estará incompleto."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "La página %s coincide con dos patrones en html_sidebars: %r y %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "Se produjo un error Unicode al representar la página %s. Asegúrese de que todos los valores de configuración que contengan contenido que no sea ASCII sean cadenas Unicode."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Ha ocurrido un error al renderizar la pagina %s. Motivo: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr "volcar inventario de objetos"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr "volcar el índice de búsqueda en %s"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "js_file inválido: %r, ignorado"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Muchos math_renderers están registrados. Pero no se ha seleccionado math_renderer."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Desconocido math_renderer %r es dado."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "entrada html_extra_path %r no existe"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "entrada html_extra_path %r se coloca dentro de outdir"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "entrada html_static_path %r no existe"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "entrada html_static_path %r se coloca dentro de outdir"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "archivo de logo %r no existe"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "el archivo %r usado para el favicon no existe"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "documentación de %s - %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Los archivos LaTeX están en %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nEjecuta el comando 'make' en este directorio para compilarlos usando (pdf)latex\n(usa el comando 'make latexpdf' aquí para hacer esto automáticamente)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "no se encontró el valor de configuración \"latex_documents\"; no se escribirán documentos"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "El valor de configuración \"latex_documents\" hace referencia a un documento desconocido %s"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Índice"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Versión"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "No se conoce la opción de Babel para el idioma %r"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "copiando archivos de soporte TeX"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "copiando archivos de soporte TeX..."
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "copiando archivos adicionales"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr "Clave de configuración desconocida: latex_elements[%r], ignorada."
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r no tiene configuración de \"tema\""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r no tiene configuración de \"%s\""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Ha ocurrido un error al compilar, iniciando depurador:"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr "¡Interrumpido!"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "error en marcado de reST"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Error de codificación:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "El rastreo completo se ha guardado en %s, si desea informar el problema a los desarrolladores."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Error de recursión:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "Esto puede suceder con archivos fuente muy grandes o profundamente anidados. Puede aumentar cuidadosamente el límite de recursión de Python predeterminado de 1000 en el archivo conf.py con, por ejemplo:"
+msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "Ha ocurrido una excepción:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Por favor, informe también esto si fue un error del usuario, de modo que la próxima vez se pueda proporcionar un mejor mensaje de error."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Se puede presentar un informe de error en el rastreador en <https://github.com/sphinx-doc/sphinx/issues>. ¡Gracias!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "número de trabajo debe ser un número positivo"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Para más información, visita <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1184,296 +1223,290 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nGenerar documentación a partir de archivos fuente.\n\nsphinx-build genera documentación de los archivos en SOURCEDIR y la coloca\nen OUTPUTDIR. Busca el archivo 'conf.py' en SOURCEDIR para los ajustes de la \nconfiguración. La herramienta 'sphinx-quickstart' puede usarse para generar archivos de plantilla,\nincluyendo el archivo 'conf.py'\n\nsphinx-build puede crear documentación en diferentes formatos. Un formato es\nseleccionado especificando el nombre del constructor en la línea de comando; por defecto es\nHTML. Los constructores también pueden realizar otras tareas relacionadas con la\ndocumentación.\n\nPor defecto, todo lo que está desactualizado está construido. Salida solo para los archivos\nseleccionados se pueden construir especificando nombres de archivo individuales.\n"
+msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "ruta a los archivos fuente de la documentación"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "ruta al directorio de salida"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "una lista de archivos específicos para reconstruir. Ignorado si se especifica -a"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "opciones generales"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "constructor a usar (por defecto: html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "escribir todos los archivos (por defecto: solo escribir archivos nuevos y modificados)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "no usar un entorno guardado, siempre leer todos los archivos"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "ruta para el entorno en caché y los archivos doctree (predeterminado: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "construir en paralelo con N procesos donde sea posible (el valor especial \"auto\" establecerá N en recuento de CPU)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "ruta del archivo de configuración (conf.py) donde se encuentra (predeterminado: igual que el valor SOURCEDIR)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "no use ningún archivo de configuración, solomente opciones -D"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "sobreescribir un ajuste en el fichero de configuración"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "pasar un valor a la plantilla HTML"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "define la etiqueta: incluye bloques \"only\" con TAG"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "modo quisquilloso, advierte sobre todas las referencias faltantes"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "opciones de salida de consola"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "aumentar la verbosidad (puede repetirse)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "sin salida en salida estándar, solo advertencias en los mensajes de error estándar"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "sin salida, ni siquiera advertencias"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "emitir salida de color (predeterminado: detección automática)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "no emite salida de color (predeterminado: detección automática)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "escribir avisos (y errores) al fichero indicado"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "convertir advertencias en errores"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr "con -W, sigue adelante cuando recibas advertencias"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "mostrar rastreo completo en excepción"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "ejecutar Pdb en excepción"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "no se pueden encontrar los archivos %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "no se puede combinar la opción -a y nombres de archivo"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "no se puede abrir el archivo de advertencia %r: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "El argumento de la opción -D debe estar en la forma nombre=valor"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "El argumento de la opción -A debe estar en la forma nombre=valor"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "insertar automáticamente docstrings de los módulos"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "probar automáticamente fragmentos de código en bloques doctest"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "enlace entre la documentación de Sphinx de diferentes proyectos"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "escribir entradas de \"todo\" que se pueden mostrar u ocultar en la compilación"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "verificación para el cubrimiento de la documentación"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "incluir expresiones matemáticas, mostradas como imágenes PNG o SVG"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "incluir matemática, mostrada en el navegador por MathJax"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "inclusión condicional de contenido basado en valores de configuración"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "incluir enlaces al código fuente de objetos documentados de Python"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "crear archivo .nojekyll para publicar el documento en páginas GitHub"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "Por favor, ingrese un nombre de ruta válido."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Por favor, ingrese algún texto."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Por favor, ingrese uno de %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Por favor, ingrese cualquiera de 'y' o 'n'"
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Por favor, ingrese un archivo de sufijo, por ejemplo, '.rst' o '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "* Nota: caracteres no ASCII ingresados y codificación de terminal desconocida, suponiendo UTF-8 o Latin-1."
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Bienvenido a la utilidad de inicio rápido de Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Ingrese los valores para las siguientes configuraciones (solo presione Entrar para\naceptar un valor predeterminado, si se da uno entre paréntesis)."
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Ruta raíz seleccionada: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr "Ingrese la ruta raíz para la documentación."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "Ruta raíz para la documentación"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Error: un archivo conf.py ya existe en la ruta raíz seleccionada."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart no sobreescribirá proyectos existentes de Sphinx."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Por favor, ingrese una nueva ruta raíz (o ingrese Enter para salir)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Tiene dos opciones para colocar el directorio de compilación para la salida de Sphinx.\nO usas un directorio \"_build\" dentro de la ruta raíz, o separas\ndirectorios \"fuente\" y \"compilación\" dentro de la ruta raíz."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Separar directorios fuente y compilado (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "Dentro del directorio raíz, se crearán dos directorios más; \"_templates\"\npara plantillas HTML personalizadas y \"_static\" para hojas de estilo personalizadas y otras archivos\nestáticos. Puede ingresar otro prefijo (como \".\") Para reemplazar el guión bajo."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "Prefijo de nombre para directorios de plantillas y estático"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "El nombre del proyecto aparecerá en varios lugares en la documentación construida."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Nombre de proyecto"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Autor(es)"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr "Sphinx tiene la noción de una \"version\" y un \"release\" para el\nsoftware. Cada versión puede tener múltiples versiones. Por ejemplo, para\nPython la versión es algo así como 2.5 o 3.0, mientras que el lanzamiento es\nalgo así como 2.5.1 o 3.0a1. Si no necesita esta estructura dual,\nsolo establezca ambos en el mismo valor."
+msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Versión del proyecto"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Liberación del proyecto"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1483,21 +1516,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Si los documentos deben escribirse en un idioma que no sea inglés,\npuede seleccionar un idioma aquí por su código de idioma. Sphinx entonces\ntraducir el texto que genera a ese idioma.\n\nPara obtener una lista de códigos compatibles, vea\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Lenguaje del proyecto"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr "El sufijo del nombre de archivo para los archivos de origen. Comúnmente, esto es \".txt\"\no \".rst\". Solo los archivos con este sufijo se consideran documentos."
+msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Sufijo del archivo fuente"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1505,91 +1538,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr "Un documento es especial porque se considera el nodo superior del\n\"contents tree\", es decir, es la raíz de la estructura jerárquica\nde los documentos. Normalmente, esto es \"index\", pero si su documento \"index\"\nes una plantilla personalizada, también puede establecerlo en otro nombre de archivo."
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Nombre del documento maestro (sin sufijo)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Error: el archivo maestro %s ya se ha encontrado en la ruta raíz seleccionada."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart no sobreescribirá el archivo existente."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Ingrese un nuevo nombre de archivo o cambie el nombre del archivo existente y presione Enter"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Indique cuál de las siguientes extensiones de Sphinx deben habilitarse:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Nota: imgmath y mathjax no se pueden habilitar al mismo tiempo. imgmath ha sido deseleccionado."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Se puede generar un archivo Makefile y un archivo de comandos de Windows para que usted\nsolo tiene que ejecutar, por ejemplo, `make html' en lugar de invocar sphinx-build\ndirectamente."
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Crear Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "¿Crear archivo de comandos para Windows? (y/n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Creando archivo %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "El archivo %s ya existe, omitiendo."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Terminado: se ha creado una estructura de directorio inicial."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Ahora debe completar su archivo maestro %s y crear otros archivos fuente\nde documentación."
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Use el archivo Makefile para compilar los documentos, así ejecute el comando:\n    make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Use el comando sphinx-build para compilar los documentos, así ejecute el comando:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "donde \"builder\" es uno de los constructores compatibles, por ejemplo, html, latex o linkcheck."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1599,787 +1632,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nGenere los archivos necesarios para un proyecto Sphinx.\n\nsphinx-quickstart es una herramienta interactiva que hace algunas preguntas sobre su\nproyecto y luego genera un directorio completo de documentación y un ejemplo del archivo\nMakefilepara ser utilizado con el comando sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "modo silencioso"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr "raíz del proyecto"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "Opciones de estructura"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "si se especifica, separe los directorios de fuentes y de compilación"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "reemplazo para punto en _templates, etc."
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "Opciones básicas del proyecto"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "nombre del proyecto"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "autores"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "versión del proyecto"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "liberación del proyecto"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "lenguaje del documento"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "sufijo de archivo fuente"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "nombre de documento maestro"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "usar epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Opciones de extensión"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "habilitada extensión %s"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "habilitar extensiones arbitrarias"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "creación del Makefile y Batchfile"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "crear makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "no crear makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "crear batchfile"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "no crear batchfile"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "use el modo make para Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "no use el modo make para Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "Plantillas de proyecto"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "directorio de plantillas para archivos de plantillas"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "definir una variable de proyceto"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "se especifica \"quiet\", pero no se especifica ninguno de \"project\" o \"author\"."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Error: la ruta especificada no es un directorio, o ya existen archivos sphinx."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart solo se genera en un directorio vacío. Por favor, especifique una nueva ruta raíz."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Variable de plantilla inválida: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "Más dedent ha detectado"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Subtítulo inválido: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "la especificación del número de línea está fuera de range(1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "No puede utilizar ambas opciones \"%s\" y \"%s\""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Archivo incluido %r no encontrado o la lectura del mismo fallo"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Codificación %r usado para la lectura archivo incluido %r parece estar mala, trate de darle una opción :encoding:"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objeto nombrado %r no encontrado en el archivo incluido %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "No puede utilizar a \"lineno-match\" con un conjunto desunido de \"líneas\""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Línea especifico %r: sin líneas tiradas desde el archivo incluido %r"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor de la sección: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor del módulo: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Código del autor: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parámetros"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Devuelve"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Tipo del valor devuelto"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (función C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (miembro C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (macro C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (tipo C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "miembro"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (variable C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variable"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "función"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "miembro"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "unión"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumeración"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tipo"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variable"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
-msgstr "descripción duplicada del objeto C de %s, otra instancia en %s, utilice :noindex: para uno de ellos"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nuevo en la versión %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Distinto en la versión %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsoleto desde la versión %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "citación duplicada %s, otra instancia en %s"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "Citación [%s] no está referenciada."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "Declaración duplicada, también definida en '%s'.\nDeclaración es '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Parametros de Plantilla"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Lanzamientos"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "clase"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "unión"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "concepto"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumeración"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "Definición duplicada, también definida en '%s'.\nEl nombre de la definición es '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (función incorporada)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (método de %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (clase)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variable global o constante)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atributo de %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumentos"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (módulo)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "método"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "dato"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atributo"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "módulo"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "duplicada %s descripción de %s, otra %s en %s"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "etiqueta duplicada de la ecuación %s, otra instancia en %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "No válido math_eqref_format: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "palabra clave"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operador"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objeto"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "excepción"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "sentencia"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "función incorporada"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variables"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Muestra"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (en el módulo %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (variable incorporada)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (en el módulo %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (variable incorporada)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (clase incorporada)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (clase en %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (método de %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (método de clase de %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (método estático de %s.%s)"
+msgid "%s() (%s property)"
+msgstr "%s() (propiedad de %s)"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (método estático de %s)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (método de clase de %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (método de clase de %s)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atributo de %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr "%s() (propiedad de %s)"
+msgid "%s (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Índice de Módulos Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "módulos"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Obsoleto"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "método de la clase"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "método estático"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, 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:1176
+#: sphinx/domains/python.py:1264
 #, 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:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (obsoleto)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directiva)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (opción directiva)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "directiva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr "directive-option"
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rol"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "descripción duplicada de %s %s, otra instancia en %s"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "variables de entorno; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Descripción de la opción con formato incorrecto %r, debe verse como \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" o \"+opt args\""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr "%sopción de línea de comando "
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr "opción de línea de comando"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr "el término del glosario debe ir precedido de una línea vacía"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr "los términos del glosario no deben estar separados por líneas vacías"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "el glosario parece estar mal formateado, verifique la sangría"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "termino de glosario"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "gramática simbólica"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "etiqueta de referencia"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "variables de entorno"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "opción de programa"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "documento"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Índice de Módulos"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Página de Búsqueda"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "etiqueta duplicada %s, otra instancia en %s"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "duplicada %s descripción de %s, otra instancia en %s"
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig está deshabilitado. :numref: se ignora."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "no se asigna ningún número para %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "el enlace no tiene subtítulo: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "inválido numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "inválido numfig_format: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "nueva configuración"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "configuración modificada"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "extensiones modificadas"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "la versión del entorno de compilación no es actual"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "directorio fuente ha cambiado"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Este entorno es incompatible con el generador seleccionado, elija otro directorio doctree."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Error al escanear los documentos en %s: %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Dominio %r no está registrado"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr "toctree auto referenciado encontrado. Ignorado."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "documento no está incluido en ningún toctree"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "ver %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "ver también %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "tipo de entrada de índice desconocido %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Símbolos"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "referencias circulares de toctree detectadas, ignorando: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree contiene una referencia al documento %r que no tiene título: no se generará ningún enlace"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree contiene referencia al documento excluido %r"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree contiene referencias a documentos inexistentes %r"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "archivo de imagen no legible:%s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "archivo de imagen %s no legible: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr "el archivo de descarga no es legible: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s ya tiene asignados números de sección (¿número de árbol anidado?)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr "Debería crear archivo %s."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2391,165 +2413,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr "\nMire recursivamente en <MODULE_PATH> para módulos y paquetes de Python y cree\nun archivo reST con directivas automodule por paquete en el <OUTPUT_PATH>.\n\nLos <EXCLUDE_PATTERN>s pueden ser patrones de archivo y/o directorio que serán\nexcluidos de la generación.\n\nNota: Por defecto, este script no sobrescribirá los archivos ya creados."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr "ruta al módulo al documento"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "archivo de estilo fnmatch y/o patrones de directorio para excluir de la generación"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr "directorio para colocar toda la salida"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "rofundidad máxima de submódulos para mostrar en la tabla de contenido (predeterminado: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "sobreescribir archivos existentes"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "seguir enlaces simbólicos. Potente cuando se combina con el paquete collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "ejecutar la rutina sin crear archivos"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr "poner documentación para cada módulo en su propia página"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr "incluir \"_private\" en módulos"
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr "nombre de archivo de la tabla de contenido (predeterminado: módulos)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "no crear un archivo de tabla de contenido"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "no cree encabezados para los paquetes de módulos/paquetes (por ejemplo, cuando las cadenas de documentación \"docstrings\" ya los contienen)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr "poner la documentación del módulo antes de la documentación del submódulo"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interpretar las rutas del módulo de acuerdo con la especificación de espacios de nombres implícitos en la PEP-0420"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "sufijo de archivo (por defecto: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr "generar un proyecto completo con sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "agregue module_path al sys.path, que se usa cuando se da el parámetro --full"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr "nombre del proyecto (predeterminado: nombre del módulo raíz)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr "autor(es) del proyecto, utilizado cuando se da el parámetro --full"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr "versión del proyecto, utilizado cuando se da el parámetro --full"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "lanzamiento del proyecto, utilizado cuando se da el parámetro --full, por defecto es --doc-version"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "opciones de extensión"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s no es un directorio."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "expresiones regulares inválidas %r en %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Pruebas de cobertura en las fuentes terminadas, mira los resultados en %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "expresiones regulares inválidas %r en coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "el módulo %s no podía ser importado: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "falta '+' o '-' en la opción '%s'."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' no es una opción válida."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' no es una opción pyversion válida"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "tipo de TestCode inválido"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Prueba de doctests en las fuentes terminadas, mira los resultados en %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "sin código/salida en el bloque %s en %s:%s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "ignorando el código doctest no válido: %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "====================== duraciones de lectura más lentas ======================="
@@ -2563,11 +2605,11 @@ msgstr "Directiva Graphviz no puede tener tanto el contenido y un argumento de n
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Archivo externo Graphviz %r no encontrado o la lectura del mismo fallo"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignorando la directiva \"graphviz\" sin contenido."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2577,14 +2619,14 @@ msgid ""
 "%r"
 msgstr "dot no produjo un archivo de salida:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "comando dot %r no se puede ejecutar (necesarios para la salida de graphviz), Compruebe la configuración de graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2594,30 +2636,31 @@ msgid ""
 "%r"
 msgstr "dot salió con error:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "el valor del parámetro graphviz_output_format debe ser uno de 'png', 'svg', pero es %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr "dot código %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[gráfica: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[gráfica]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr "el comando convert %r no puede ejecutar, compruebe el valor de configuración image_converter"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
+msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
 #, python-format
@@ -2629,148 +2672,158 @@ msgid ""
 "%r"
 msgstr "convert salió con error:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "el comando convert %r no puede ejecutar, compruebe el valor  de configuración image_converter"
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "comando LaTeX %r no se puede ejecutar (necesario para la visualización matemática), compruebe la configuración de imgmath_latex"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "El comando%s %r no se puede ejecutar (necesario para la visualización matemática), verifique la configuración imgmath_%s"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr "visualizar latex %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "en línea latex %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(en %s versión %s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(en %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, 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:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr "Error al leer intersphinx_mapping[%s], ignorado: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[fuente]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Por hacer"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Marca TODO encontrada: %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<entrada original>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(La  <<entrada original>> se encuentra en %s, línea %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "entrada original"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr "resaltando el código del módulo..."
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[documentos]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Código de módulo"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Código fuente para %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Resumen: código de modulo"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Todos los módulos para los cuales disponen código</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "firma inválida para auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "error al formatear argumentos para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "falta el atributo %s en el objeto %s"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autodoc: no se pudo determinar %r que se documentará, se produjo la siguiente excepción:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2778,104 +2831,157 @@ msgid ""
 "explicit module name)"
 msgstr "no sabe qué módulo importar para el autodocumento %r (intente colocar una directiva \"module\" o \"currentmodule\" en el documento o dar un nombre explícito al módulo)"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" en el nombre del automodule no tiene sentido"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "argumentos de firma o anotación de retorno dada para automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ debe ser una lista de cadenas, no %r (en el módulo %s) -- ignorando __all__"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr "atributo faltante mencionado en :members: o módulo __all__:  %s, atributo %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Bases: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias de :class:`%s`"
+msgid "alias of TypeVar(%s)"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "Error al analizar type_comment para %r: %s"
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "referencias autosummary excluidas documento %r. Ignorado."
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary: no se encontró el archivo stub %r. Verifique su configuración de autosummary_generate."
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "fallo al importar %s"
+msgid "autosummary: failed to import %s"
+msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr "fallo al analizar el nombre %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "fallo al importar el objeto %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: archivo no encontrado: %s"
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary genera archivos .rst internamente. Pero su source_suffix no contiene archivo .rst. Saltado."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autosummary: no se pudo determinar %r que se documentará, se produjo la siguiente excepción:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr "[autosummary] generar autosummary para: %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[autosummary] escribiendo a %s"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr "[autosummary] fallo al importar %r: %s"
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2890,107 +2996,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nGenere ReStructuredText usando directivas de resumen automático \"autosummary\".\n\nsphinx-autogen es una interfaz para sphinx.ext.autosummary.generate. Genera\nlos archivos reStructuredText de las directivas autosummary contenidas en el\nlos archivos de entrada dados.\n\nEl formato de la directiva autosummary está documentado en el módulo Python\n``sphinx.ext.autosummary`` y se puede leer usando el siguiente comando::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "archivos fuente para generar archivos rST para"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "directorio para colocar toda la salida en"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "sufijo predeterminado para archivos (predeterminado: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "directorio de plantillas personalizadas (predeterminado: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "documento importados miembros (predeterminado: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Argumentos de palabras clave"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Ejemplo"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Ejemplos"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Notas"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Otros parámetros"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "Referencias"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "Avisos"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr "Campos"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Atención"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Prudencia"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Peligro"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Error"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Consejo"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Importante"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Ver también"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Truco"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Advertencia"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "proviene de la página anterior"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "continué en la próxima página"
@@ -3007,181 +3137,181 @@ msgstr "Números"
 msgid "page"
 msgstr "página"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Tabla de contenido"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Búsqueda"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Ir a"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Mostrar el código"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Resumen"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "¡Bienvenido! Este es"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "la documentación para"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "actualizado por última vez el"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Índices y tablas:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Índice de contenidos completo"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "muestra todas las secciones y subsecciones"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "buscar en esta documentación"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Índice Global de Módulos"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "acceso rápido a todos los módulos"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "todas las funciones, clases, términos"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Índice &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Índice completo en una página"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Índice alfabético de páginas"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "puede ser muy grande"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navegación"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Buscar en %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Sobre este documento"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Derechos de autor</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Derechos de autor %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Actualizado por última vez en %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Creado con <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Buscar en %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Tema anterior"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "capítulo anterior"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Próximo tema"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "próximo capítulo"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Por favor, active JavaScript para habilitar la funcionalidad\n    de búsqueda."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr "La búsqueda de varias palabras solo muestra coincidencias que contienen\n    todas las palabras."
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "buscar"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Resultados de la búsqueda"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Su búsqueda no coincide con ningún documentos. Por favor, asegúrese de que todas las palabras estén correctamente escritas y que usted allá seleccionado las suficientes categorías."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Búsqueda rápida"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Esta página"
 
@@ -3213,19 +3343,19 @@ msgstr "Cambios en la API C"
 msgid "Other changes"
 msgstr "Otros cambios"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Enlazar permanentemente con este título"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Enlazar permanentemente con esta definición"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Ocultar coincidencias de la búsqueda"
 
@@ -3237,12 +3367,12 @@ msgstr "Buscando"
 msgid "Preparing search..."
 msgstr "Preparando búsqueda..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Búsqueda finalizada, encontró %s página(s) acorde con la consulta de búsqueda."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", en "
 
@@ -3255,7 +3385,7 @@ msgstr "Expandir barra lateral"
 msgid "Collapse sidebar"
 msgstr "Contraer barra lateral"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Contenidos"
 
@@ -3274,199 +3404,207 @@ msgstr "Pie de página [%s] no está referenciado."
 msgid "Footnote [#] is not referenced."
 msgstr "Pie de página [#] no está referenciado."
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referencias de pie de página inconsistentes en el mensaje traducido. original: {0}, traducido: {1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "referencias inconsistentes en el mensaje traducido. original: {0}, traducido: {1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referencias de citas inconsistentes en el mensaje traducido. original: {0}, traducido: {1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referencias de término inconsistentes en el mensaje traducido. original: {0}, traducido: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "más de un objetivo destino encontrado para 'cualquier' referencia cruzada %r: podría ser %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s destino de referencia no encontrada: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "%r destino de referencia no encontrada: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "No se pudo recuperar la imagen remota: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr "No se pudo recuperar la imagen remota: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Formato de imagen desconocido: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "caracteres fuente no codificables, reemplazando con \"?\": %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr "omitido"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr "fallado"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "leyendo error: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "escribiendo error: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Formato de fecha inválido. Cite la cadena con comillas simples si desea generarla directamente: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree contiene referencia al archivo inexistente %r"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "excepción al evaluar solamente la expresión directiva: %s"
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr "El soporte para evaluar la sintaxis de Python 2 está en desuso y se eliminará en Sphinx 4.0. Convierta %s a la sintaxis de Python 3."
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "rol por defecto %s no encontrado"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format no está definido para %s"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Cualquier ID no asignado para el nodo %s"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Enlace permanente a esta tabla"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Enlace permanente a este código fuente"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Enlace permanente a esta imagen"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Enlace permanente a la tabla de contenidos"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "No se pudo obtener el tamaño de la imagen. La opción :scale: se ignora."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "desconocida %r toplevel_sectioning para la clase %r"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr "demasiado grande :maxdepth:, ignorado."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr "El título del documento no es un nodo de texto único"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "no se encontró el nodo de título en la sección, tema, tabla, advertencia o barra lateral"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Notas a pie de página"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "ambas columnas tabulares y la opción :widths: se dan. La opción :widths: se ignora."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "la unidad de dimensión %s no es válida. Ignorado."
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "tipo de entrada de índice desconocido %s encontrado"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[imagen: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[imagen]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "subtítulo no dentro de una figura."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "tipo de nodo no implementado: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr "tipo de nodo desconocido: %r"
diff --git a/sphinx/locale/et/LC_MESSAGES/sphinx.po b/sphinx/locale/et/LC_MESSAGES/sphinx.po
index 1f40f10c0a9..7ffff972296 100644
--- a/sphinx/locale/et/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/et/LC_MESSAGES/sphinx.po
@@ -1,151 +1,156 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Aivar Annamaa <aivar.annamaa@gmail.com>, 2011
 # Ivar Smolin <okul at linux ee>, 2012
-# Ivar Smolin <okul@linux.ee>, 2013-2020
+# Ivar Smolin <okul@linux.ee>, 2013-2021
 # Luc Saffre <luc.saffre@gmail.com>, 2015
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-05-04 14:44+0000\n"
+"Last-Translator: Ivar Smolin <okul@linux.ee>\n"
 "Language-Team: Estonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/et/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: et\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "seadistuste kataloog (%s) ei sisalda faili conf.py"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Lähtekataloogi (%s) pole võimalik leida"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Lähtekataloog ja sihtkataloog ei tohi olla identsed"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s käitamine"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "See projekt vajab vähemalt Sphinxi v%s ja seetõttu pole projekti võimalik käesoleva versiooniga ehitada."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "väljundkataloogi loomine"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "tõlgete laadimine [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "valmis"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
-msgstr ""
+msgstr "serialiseeritud keskkonna laadimine"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "tõrge: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Ehitajat pole valitud, kasutatakse vaikimisi ehitajat: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "oli edukas"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "lõppes probleemidega"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "ehitamine %s, %s hoiatus."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "ehitamine %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -153,12 +158,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
-msgstr ""
+msgstr "laiendus %s pole rööbiti lugemiseks turvaline"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -166,59 +171,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
-msgstr ""
+msgstr "laiendus %s pole rööbiti kirjutamiseks turvaline"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "vigane arv %r seadistuse väärtusele %r, eiratakse"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Puudub määratud seadistusväärtus: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Seadistuste väärtus %r on juba olemas"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
-msgstr ""
+msgstr "Sinu seadistusfailis on süntaksi viga: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Seadistusfail (või mõni selle poolt imporditud moodulitest) kutsus välja sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -226,58 +231,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Sektsioon %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Joonis %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabel %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Nimekiri %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -285,405 +283,430 @@ msgstr "primary_domain %r ei leitud, eiratakse."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
-msgstr ""
+msgstr "needs_extensions sätted nõuavad laiendust %s, kuid see pole laaditud."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
-msgstr ""
+msgstr "See projekt vajab laiendust %s vähemalt versiooniga %s ja seetõttu pole projekti võimalik laaditud versiooniga (%s) ehitada."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "dokument pole loetav ja seda eiratakse."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Ehitaja klassil %s puudub atribuut \"name\""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Ehitaja %r on juba olemas (moodulis %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Ehitajat nimega %s pole registreeritud"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "domeen %s on juba registreeritud"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domeen %s pole veel registreeritud"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser on %r jaoks juba registreeritud"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Lähtekoodi analüsaatorit pole %s jaoks registreeritud"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Algne erind:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Laiendust %s pole võimalik importida"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "erindil %r puudub funktsioon setup(); kas see on päriselt Sphinxi laiendusmoodul?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Pythoni täiustusettepanekud; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "teemal %r puudub \"theme\" säte"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "teemal %r puudub \"inherit\" säte"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "fail %r teemarajal pole korrektni zip-fail või ei sisalda see teemat"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme pole alates versioonist 1.4.0 enam otsene sõltuvus. Palun paigalda see käsitsi. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "teemat nimega %r ei leitud (kas theme.conf on puudu?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "ehitamine [mo]: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "väljundi kirjutamine... "
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "%d määratud po-faili sihtfailid"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "%d po-faili sihtfailid on aegunud"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "kõik lähtefailid"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "%d lähtefaili sihtfailid on aegunud"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "ehitamine [%s]: "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "praeguseks aegunud failide otsimine... "
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "leitud %d"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "ei leitud"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
-msgstr ""
+msgstr "kooskõla kontrollimine"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "aegunud sihtfaile pole"
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "keskkonna uuendamine:"
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "lisatud %s, muudetud %s, eemaldatud %s"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "lähtefailide lugemine..."
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "dokumentide ettevalmistamine"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "kujutiste kopeerimine... "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "kujutise faili %r pole võimalik kopeerida: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "kujutise faili %r pole võimalik kirjutada: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "faili %s kirjutamine..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "faili %s kirjutamine..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Ülevaatefail asub kataloogis %(outdir)s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "versioonis %s pole muutusi."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "kokkuvõttefaili kirjutamine..."
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Sisseehitatud"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Mooduli tase"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "lähtefailide kopeerimine..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -692,181 +715,185 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "vigane css_file: %r, eiratakse"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Sõnumikataloogid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "%d mallifaili sihtfailid"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "mallide lugemine... "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "sõnumikataloogide kirjutamine... "
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Otsi vigu ülalolevast väljundist või failist %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Juhendi lehed asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "seadistusparameetrit \"man_pages\" ei leitud, juhendi lehti ei kirjutata"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
-msgstr ""
+msgstr "seadistusparameeter \"man_pages\" viitab tundmatule dokumendile %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML-leht asub kataloogis %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
-msgstr ""
+msgstr "täiendavate failide kirjutamine"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Texinfo failid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "seadistusparameetrit \"texinfo_documents\" ei leitud, dokumente ei kirjutata"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
-msgstr ""
+msgstr "seadistusparameeter \"texinfo_documents\" viitab tundmatule dokumendile %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "viidete lahendamine..."
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (pealkirjas "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
-msgstr ""
+msgstr "Texinfo tugifailide kopeerimine"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
-msgstr ""
+msgstr "viga faili Makefile kirjutamisel: %s"
 
 #: sphinx/builders/text.py:30
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Tekstifailid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "viga faili %s kirjutamisel: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "XML-failid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "PseudoXML-failid asuvad kataloogis %(outdir)s."
@@ -881,290 +908,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTML-lehed asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
-msgstr ""
+msgstr "Viga ehitamise infofaili lugemisel: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d. %b %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Üldindeks"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "indeks"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "järgmine"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "eelmine"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
-msgstr ""
+msgstr "indeksite genereerimine"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
-msgstr ""
+msgstr "täiendavate lehtede kirjutamine"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "allalaaditavate failide kopeerimine..."
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "staatiliste failide kopeerimine... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "staatilist faili %r pole võimalik kopeerida"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
-msgstr ""
+msgstr "lisafailide kopeerimine"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
-msgstr ""
+msgstr "lisafaili %r pole võimalik kopeerida"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
-msgstr ""
+msgstr "Viga ehitamise infofaili kirjutamisel: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
-msgstr ""
+msgstr "lehe %s renderdamisel tekkis Unicode viga. Palun veendu, et kõik mitte-ASCII sisuga seadistusparameetrid on kirjeldatud Unicode stringidena."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
-msgstr ""
+msgstr "otsinguindeksi tõmmise kirjutamine keelele %s"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "vigane js_file: %r, eiratakse"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
-msgstr ""
+msgstr "html_extra_path kirjet %r pole olemas"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "html_extra_path kirje %r asub väljaspool väljundkataloogi"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "logofaili %r pole olemas"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "favicon faili %r pole olemas"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentatsioon"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTeX-failid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nNende jooksutamiseks läbi (pdf)latex programmi käivita selles kataloogis\n'make' (selle automaatseks tegemiseks kasuta `make latexpdf')."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "seadistusparameetrit \"latex_documents\" ei leitud, dokumente ei kirjutata"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "seadistusparameeter \"latex_documents\" viitab tundmatule dokumendile %s"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Indeks"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Redaktsioon"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
-msgstr ""
+msgstr "TeX-i tugifailide kopeerimine"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "TeX-i tugifailide kopeerimine..."
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
-msgstr ""
+msgstr "lisafailide kopeerimine"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
-msgstr ""
+msgstr "Katkestatud!"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
-msgstr ""
+msgstr "Rekursiooni viga:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Kui see oli kasutaja viga, siis anna palun sellest teada, et tulevikus oleks võimalik parem veateade väljastada."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
-msgstr "Vearaportit on võimalik esitada jälguris aadressil <https://github.com/sphinx-doc/sphinx/issues>. Aitäh!"
+msgstr "Vearaportit on võimalik esitada träkkeris aadressil <https://github.com/sphinx-doc/sphinx/issues>. Aitäh!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Lisateabe jaoks külasta <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1181,279 +1220,273 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nDokumentatsiooni genereerimine lähtefailidest.\n\nsphinx-build genereerib dokumentatsiooni kataloogis SOURCEDIR asuvatest\nfailidest ja paneb selle kataloogi OUTPUTDIR. Seadistusparameetrite lugemiseks\notsitakse SOURCEDIR kataloogist faili 'conf.py'. Mallifailide, kaasa arvatud\nconf.py genereerimiseks võib kasutada vahendit 'sphinx-quickstart'.\n\nsphinx-build suudab luua dokumentatsiooni erinevates vormingutes. Vormingu\nvalimiseks määratakse käsurealt ehitaja nimi, vaikimisi on selleks HTML.\nEhitaja võib läbi viia ka teisi dokumentatsiooni töötlemiseks vajalikke\ntoiminguid.\n\nVaikimisi ehitatakse kõik, mis on uuenenud. Üksikute failinimede määramisega\nsaab ainult valitud failidest genereeritud väljundit.\n"
+msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "dokumentatsiooni lähtefailide rada"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "väljundkataloogi rada"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "määratud failide uuestiehitamine. Võtme -a korral eiratakse"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "üldsuvandid"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "kasutatav ehitaja (vaikimisi: html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "kõikide failide kirjutamine (vaikimisi kirjutatakse ainult uued ja muutunud failid)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "salvestatud keskkonda ei kasutata, alati loetakse kõik failid"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "puhverdatud keskkonna ja dokumendipuu rada (vaikimisi: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "rööbiti ehitamine N protsessiga, kui võimalik (eriväärtus \"auto\" määrab N väärtuseks protsessorite arvu)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "seadistusfaili (conf.py) asukoha rada (vaikimisi sama mis SOURCEDIR)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "seadistusfaili ei kasutata üldse, ainult -D suvandid"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "seadistusfailis määratud väärtuse asendamine"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "väärtuse edastamine HTML-mallidesse"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "konsooliväljundi suvandid"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "hoiatuste (ja vigade) kirjutamine määratud faili"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "hoiatuste muutmine vigadeks"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "erindi korral täieliku tagasijälituse näitamine"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "erindi korral Pdb käivitamine"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "faile %r pole võimalik leida"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "suvandit -a ja failinimesid pole võimalik kombineerida"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "hoiatuste faili %r pole võimalik avada: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "-D suvandi argument peab olema vormingus nimi=väärtus"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "-A suvandi argument peab olema vormingus nimi=väärtus"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "moodulite dokumentatsioonistringide automaatne lisamine"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "dokumentatsioonistringides olevate koodijuppide automaattestimine"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "eri projektide Sphinx-dokumentatsiooni omavaheline viitamine"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "\"teha\" sissekannete kirjutamine, mida võib ehitamisega peita või näidata"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "dokumentatsiooni katvuse kontrollid"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "matemaatika kaasamine, mis renderdatakse PNG- või SVG-kujutisteks"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "matemaatika kaasamine, mis renderdatakse veebisirvikus MathJax-i abil"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "sisu tingimuslik kaasamine seadistusparameetrite alusel"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "dokumenteeritud Python-objektide lähtekoodile viitamise kaasamine"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ".nojekyll faili loomine dokumentide avaldamiseks GitHub-i lehtedel"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Palun sisesta mingi tekst."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Palun sisesta kas 'y' või 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Tere tulemast kasutama Sphinx %s lendstardi utiliiti."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
-msgstr ""
+msgstr "Palun sisesta väärtused järgnevate sätete jaoks (kandiliste sulgude vahel\nvõib olla vaikeväärtus, millega nõustumiseks vajuta lihtsalt Enter)."
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
-msgstr ""
+msgstr "Valitud juurkataloog: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Viga: valitud juurkataloogist leiti olemasolev conf.py."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart ei kirjuta olemasolevaid Sphinx-projekte üle."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Palun sisesta uus juurkataloog (või vajuta Enter lõpetamiseks)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
-msgstr ""
+msgstr "Sphinx'i väljundi ehitamise kataloogi asetamiseks on kaks valikut.\nVõid kasutada kataloogi \"_build\" juurkataloogis või eraldiseisvaid \n\"source\" ja \"build\" katalooge juurkataloogis."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Lähtekoodi ja ehitamise kataloogide eraldamine (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "Mallide ja staatilise kataloogi nime eesliide"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Projekti nimi"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Autorite nimed"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1462,15 +1495,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Projekti versioon"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Projekti väljalase"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1480,21 +1513,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Projekti keel"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Lähtefaili järelliide"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1502,91 +1535,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Sinu põhidokumendi nimi (ilma järelliiteta)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
-msgstr ""
+msgstr "Viga: valitud juurkataloogist leiti peafail %s."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart ei kirjuta olemasolevat faili üle."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Palun sisesta uus failinimi või nimeta olemasolev fail ümber ja vajuta Enter"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Märkus: imgmath ja mathjax ei saa korraga lubatud olla. imgmath eemaldati valikust."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Kas luua Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "Kas luua Windowsi käsufail? (y/n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Faili %s loomine."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Fail %s on juba olemas ja jäetakse vahele."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Lõpetamine: Algne kataloogistruktuur on loodud."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
-msgstr ""
+msgstr "Sa peaks nüüd asustama oma peafaili %s ja looma ülejäänud dokumentatsiooni\nlähtefailid. "
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
-msgstr ""
+msgstr "Dokumentide ehitamiseks kasuta Makefile, näiteks:\n   make ehitaja"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
-msgstr ""
+msgstr "Dokumentide ehitamiseks kasuta käsku sphinx-build, näiteks:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
-msgstr ""
+msgstr "kus \"ehitaja\" on üks toetatud ehitajatest, nt. html, latex või linkcheck."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1596,787 +1629,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nSphinx-projekti jaoks vajalike failide genereerimine.\n\nsphinx-quickstart on interaktiivne tööriist, mis küsib mõned küsimused Sinu\nprojekti kohta ja seepeale genereerib täieliku dokumentatsioonikataloogi ning\nnäidis-Makefile kasutamiseks koos sphinx-buildiga.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "vaikne režiim"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "Struktuuri suvandid"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "kasutamise korral eraldatakse lähtefailide ja ehitamise kataloogid"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "Projekti põhisuvandid"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "projekti nimi"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "autorite nimed"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "projekti versioon"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "projekti väljalase"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "dokumendi keel"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "lähtefaili järelliide"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "põhidokumendi nimi"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Laienduste suvandid"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "laienduse %s lubamine"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "suvaliste laienduste määramine"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Makefile ja Batchfile loomine"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "makefile loomine"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "makefile loomata jätmine"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "batchfile loomine"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "batchfile loomata jätmine"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "Projekti loomine mallist"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "mallifailide kataloog"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "malli muutuja kirjeldamine"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Vigane mallimuutuja: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Vigane selgitustekst: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Suvandeid \"%s\" ja \"%s\" pole võimalik korraga kasutada"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Sektsiooni autor: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Mooduli autor: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Koodi autor: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parameetrid"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Tagastab"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Tagastustüüp"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (C funktsioon)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C liige)"
-
-#: sphinx/domains/c.py:191
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C macro)"
-msgstr "%s (C makro)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C tüüp)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "liige"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C muutuja)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "muutuja"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funktsioon"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "liige"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "loend"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tüüp"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "muutuja"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Uus versioonis %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Muudetud versioonis %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Iganenud alates versioonist %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Malli parameetrid"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klass"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "loend"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (sisseehitatud funktsioon)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s meetod)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klass)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globaalmuutuja või konstant)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atribuut)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumendid"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (moodul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "meetod"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "andmed"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribuut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "moodul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "võrrandil %s on topeltsilt, teine instants on %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
-msgstr ""
+msgstr "Vigane math_eqref_format: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "võtmesõna"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operaator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "erind"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "lause"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "sisseehitatud funktsioon"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Muutujad"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (moodulis %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (sisseehitatud muutuja)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (moodulis %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (sisseehitatud muutuja)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (sisseehitatud klass)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klass moodulis %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s meetod)"
+msgid "%s() (%s class method)"
+msgstr "%s() (klassi %s meetod)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s staatiline meetod)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s staatiline meetod)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (klassi %s.%s meetod)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (klassi %s meetod)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s atribuut)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Pythoni moodulite indeks"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moodulid"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Iganenud"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "klassi meetod"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "staatiline meetod"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (iganenud)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiiv)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (roll)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktiiv"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "roll"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "keskkonnamuutuja; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
-msgstr ""
+msgstr "%s käsureasuvand"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
-msgstr ""
+msgstr "käsureasuvand"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "sõnastiku termin"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "grammatika märk"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "viite silt"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "keskkonnamuutuja"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "programmi suvand"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Mooduli indeks"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Otsinguleht"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
-msgstr ""
+msgstr "vigane numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
+msgstr "vigane numfig_format: %s"
+
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
-msgstr ""
+msgstr "See keskkond pole valitud ehitajaga ühilduv, palun vali mõni teine dokumendipuu kataloog."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "dokument pole ühegi sisukorrapuu osa"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "vaata %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "vaata ka %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Sümbolid"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "kujutise fail pole loetav: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "kujutise fail %s pole loetav: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2388,165 +2410,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "laienduse suvandid"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s pole kataloog."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Lähtefailide katvustestimine on lõppenud, vaata tulemusi failist %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "vigane TestCode tüüp"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Lähtefailide doctest-testimine on lõppenud, vaata tulemusi failist %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "vigase doctest koodi eiramine: %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2560,11 +2602,11 @@ msgstr "Graphviz direktiivil ei tohi samaaegselt olla argumendid content ja file
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Välist Graphviz-faili %r ei leitud või esines tõrge selle lugemisel"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ilma sisuta \"graphviz\" direktiivi eiramine."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2574,14 +2616,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot käsku %r pole võimalik käivitada (vajalik graphvizi väljundi jaoks), kontrolli graphviz_dot sätteid"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2591,30 +2633,31 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format peab olema kas 'png' või 'svg', kuid mitte %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[joonis: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[joonis]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr ""
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
+msgstr "teisendamise käsku %r pole võimalik käivitada, kontrolli image_converter sätteid: %s"
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
 #, python-format
@@ -2626,148 +2669,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "teisendamise käsku %r pole võimalik käivitada, kontrolli image_converter sätteid"
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Püsiviit sellele võrrandile"
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(projektis %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[lähtekood]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Teha"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Leitud TEHA kirje: %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<algne kirje>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<algne kirje>> asub failis %s, real %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "algne kirje"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dokumentatsioon]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Mooduli kood"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s lähtekood</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Ülevaade: mooduli kood"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Kõik lähtekoodiga moodulid</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2775,104 +2828,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Põlvnemine: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "klassi :class:`%s` sünonüüm"
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "tõrge %s importimisel"
+msgid "autosummary: failed to import %s"
+msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "tõrge objekti %s importimisel"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr "[autosummary] automaatkokkuvõtte genereerimine failile: %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[autosummary] kirjutamine kataloogi %s"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2887,107 +2993,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "lähtefailid, mille kohta rST-faile genereerida"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "väljundfailide kataloog"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "failide vaikimisi järelliide (vaikimisi: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "kohandatud mallide kataloog (vaikimisi: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "imporditud liikmete dokumenteerimine (vaikimisi: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Võtmesõnadega argumendid"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Näide"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Näited"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Märkused"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Tähelepanu"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Ettevaatust"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Oht"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Viga"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Vihje"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Tähtis"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Märkus"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Vaata ka"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Nõuanne"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Hoiatus"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "jätk eelmisele leheküljele"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "jätkub järgmisel leheküljel"
@@ -3004,181 +3134,181 @@ msgstr ""
 msgid "page"
 msgstr "lehekülg"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Sisukorratabel"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Otsing"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Otsi"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Näita lähtekoodi"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Ülevaade"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Tervitused! See on"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "dokumentatsioon projektile"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "viimati uuendatud"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indeksid ja tabelid:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Täielik sisukorratabel"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "toob välja kõik sektsioonid ja alamsektsioonid"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "otsi sellest dokumentatsioonist"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Globaalne moodulite indeks"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "kiire ligipääs kõigile moodulitele"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "kõik funktsioonid, klassid ja terminid"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Indeks &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Täisindeks ühel lehel"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indeksi leheküljed algustähe kaupa"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "võib olla väga suur"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigatsioon"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Otsi %(docstitle)s piires"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Info selle dokumentatsiooni kohta"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Autoriõigus"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Autoriõigused</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Autoriõigused %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Viimati uuendatud %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Loodud <a href=\"http://sphinx-doc.org/\">Sphinxiga</a> (versioon: %(sphinx_version)s)."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Otsi %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Eelmine teema"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "eelmine jaotis"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Järgmine teema"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "järgmine jaotis"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Otsingu võimaldamiseks tuleb aktiveerida JavaScript."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "otsi"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Otsingu tulemused"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
-msgstr "Sinu otsingule ei vastanud ükski dokument. Palun veendu, et kõik sisestatud sõnad on õigesti kirjutatud ja sa oled valikud piisaval hulgal kategooriaid."
+msgstr "Sinu otsingule ei vastanud ükski dokument. Palun veendu, et kõik sisestatud sõnad on õigesti kirjutatud ja sa oled valinud piisavalt kategooriaid."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Kiirotsing"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Käesolev leht"
 
@@ -3210,19 +3340,19 @@ msgstr "C API muutused"
 msgid "Other changes"
 msgstr "Ülejäänud muutused"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Püsiviit sellele pealkirjale"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Püsiviit sellele definitsioonile"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Varja otsingu tulemused"
 
@@ -3234,12 +3364,12 @@ msgstr "Otsimine"
 msgid "Preparing search..."
 msgstr "Otsingu ettevalmistamine..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Otsingu tulemusena leiti %s leht(e)."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3252,7 +3382,7 @@ msgstr "Näita külgriba"
 msgid "Collapse sidebar"
 msgstr "Varja külgriba"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Sisukord"
 
@@ -3271,199 +3401,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
-msgstr ""
+msgstr "Tundmatu pildivorming: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "viga lugemisel: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "viga kirjutamisel: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Püsiviit sellele tabelile"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Püsiviit sellele programmikoodile"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Püsiviit sellele pildile"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Püsiviit sellele sisukorrapuule"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: on liiga suur ja seda eiratakse."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Joonealused märkused"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[pilt: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[pilt]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/eu/LC_MESSAGES/sphinx.po b/sphinx/locale/eu/LC_MESSAGES/sphinx.po
index c6f25f8b028..4796b123c3c 100644
--- a/sphinx/locale/eu/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/eu/LC_MESSAGES/sphinx.po
@@ -1,7 +1,7 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Ales Zabala Alava <shagi@gisa-elkartea.org>, 2011
 # Asier Iturralde Sarasola <asier.iturralde@gmail.com>, 2018
@@ -9,141 +9,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Basque (http://www.transifex.com/sphinx-doc/sphinx-1/language/eu/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: eu\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -151,12 +156,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -164,59 +169,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,58 +229,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -283,405 +281,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Hobekuntza Proposamena; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Modulu maila"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -690,160 +713,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (hemen: "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -853,18 +880,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -879,290 +906,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y %b %d"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indize orokorra"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "indizea"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "hurrengoa"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "aurrekoa"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentazioa"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Indizea"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Argitalpena"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1181,277 +1220,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1460,15 +1493,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1478,21 +1511,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1500,91 +1533,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1594,787 +1627,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Atalaren egilea: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Moduluaren egilea: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Kodearen egilea: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Egilea:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametroak"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Itzultzen du"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Itzulketa mota"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C funtzioa)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C partaidea)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C makroa)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C mota)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "partaidea"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C aldagaia)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "aldagaia"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funtzioa"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "partaidea"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makroa"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "mota"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "aldagaia"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Berria %s bertsioan"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "%s bertsioan aldatuta"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "%s bertsiotik aurrera zaharkituta"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Jaurtitzen du"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klasea"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metodoa)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasea)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (aldagai globala edo konstantea)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atributua)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumentuak"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modulua)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metodoa"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "datuak"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atributua"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modulua"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "gako-hitza"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "eragiketa"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objetua"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "salbuespena"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "sententzia"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Aldagaiak"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Goratzen du"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s moduluan)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr ""
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s moduluan)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr ""
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasea %s-(e)n)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metodoa)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s klaseko metodoa)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s metodo estatikoa)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s metodo estatikoa)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s klaseko metodoa)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s klaseko metodoa)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s atributua)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python moduluen indizea"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduluak"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Zaharkitua"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "klaseko metodoa"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "metodo estatikoa"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (zaharkitua)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rola)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rola"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "inguruneko aldagaia; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "glosarioko terminoa"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "gramatikako token-a"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "erreferentzia etiketa"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "inguruneko aldagaia"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "programako aukera"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Moduluen indizea"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Bilaketa orria"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "%s ikusi"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "ikusi %s baita ere"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2386,165 +2408,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2558,11 +2600,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2572,14 +2614,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2589,29 +2631,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2624,148 +2667,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[iturburua]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Egitekoa"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "jatorrizko sarrera"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dokumentazioa]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Moduluko kodea"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s(r)en iturburu kodea</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Gainbegirada: moduluko kodea"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Kodea eskuragarri duten modulu guztiak</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2773,104 +2826,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2885,107 +2991,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Adi"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Kontuz"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Arriskua"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Errorea"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Argibidea"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Garrantzitsua"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Oharra"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Ikusi baita ere"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Iradokizuna"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Kontuz"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "aurreko orritik jarraitzen du"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3002,181 +3132,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Bilatu"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Joan"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Iturburua ikusi"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Gainbegirada"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indizeak eta taulak:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Eduki taula osoa"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "atal eta azpiatal guztiak zerrendatu"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "dokumentazio honetan bilatu"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Modulu indize globala"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "modulu guztietara atzipen azkarra"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "funtzio, klase, termino guztiak"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Indizea &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Indize guztia orri batean"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indize orriak hizkika"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "handia izan daiteke"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Nabigazioa"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Bilatu %(docstitle)s(e)n"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Dokumentu hauen inguruan"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Azken aldaketa: %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "<a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s erabiliz sortutakoa."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "%(docstitle)s bilatu"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Aurreko gaia"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "aurreko kapitulua"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Hurrengo gaia"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "hurrengo kapitulua"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Mesedez, gaitu JavaScript-a bilaketa erabili ahal izateko."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "bilatu"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Bilaketa emaitzak"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Bilaketa azkarra"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Orri hau"
 
@@ -3208,19 +3338,19 @@ msgstr "C API aldaketak"
 msgid "Other changes"
 msgstr "Beste aldaketak"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Goiburu honetarako esteka iraunkorra"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Definizio honetarako esteka iraunkorra"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Bilaketa bat-etortzeak ezkutatu"
 
@@ -3232,12 +3362,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3250,7 +3380,7 @@ msgstr "Alboko barra luzatu"
 msgid "Collapse sidebar"
 msgstr "Alboko barra tolestu"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Edukiak"
 
@@ -3269,199 +3399,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Oin-oharrak"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[irudia]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/fa/LC_MESSAGES/sphinx.po b/sphinx/locale/fa/LC_MESSAGES/sphinx.po
index 066cfc4bb7a..2b55ac4bcfa 100644
--- a/sphinx/locale/fa/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/fa/LC_MESSAGES/sphinx.po
@@ -1,1166 +1,1209 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
+# Hadi F <h_adi_f@yahoo.com>, 2020
+# Hadi F <h_adi_f@yahoo.com>, 2020-2021
+# Pikhosh <pikhosh@gmail.com>, 2020
+# Pikhosh <pikhosh@gmail.com>, 2020
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-05-08 12:28+0000\n"
+"Last-Translator: Hadi F <h_adi_f@yahoo.com>\n"
 "Language-Team: Persian (http://www.transifex.com/sphinx-doc/sphinx-1/language/fa/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: fa\n"
 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
-msgstr ""
+msgstr "شاخه‌ی پیکربندی(%s)، پرونده‌ی conf.py را ندارد"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
-msgstr ""
+msgstr "شاخه‌ی منبع(%s) پیدا نشد."
+
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr "نشانی (%s) شاخه نیست"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
-msgstr ""
+msgstr "شاخه‌های مبدأ و مقصد نمی توانند یکسان باشند"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
-msgstr ""
+msgstr "اجرای اسفینکس نگارش %s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr ""
+msgstr "به دلایل امنیّتی، حالت موازی در macOS و پایتون 3.8 و جدیدتر از آن غیرفعّال است. برای جزئیّات بیشتر لطفاً این مقاله را بخوانید: https://github.com/sphinx-doc/sphinx/issues/6803"
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
-msgstr ""
+msgstr "این پروژه دست که به افینکس نگارش%s نیاز دارد و برای همین با این نسخه قابل ساخت نیست."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
-msgstr ""
+msgstr "ایجاد پوشه ی برون داد"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
-msgstr ""
+msgstr "در حال راه اندازی افزونه‌ی%s:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
-msgstr ""
+msgstr "'setup' آن طور که در conf.py تعریف شده شیئ قابل فراخوانی پایتون نیست. لطفاً تعریفش را تغییر دهید تا تابع قابل فراخوان پایتون شود. این کار لازمه‌ی conf.py است تا به عنوان افزنه‌ی اسفینکس کار کند."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
-msgstr ""
+msgstr "بارگذاری ترجمه ها [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
-msgstr ""
+msgstr "انجام شد"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
-msgstr ""
+msgstr "برای پیام‌های داخلی در دسترس نیست"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
-msgstr ""
+msgstr "بارگذاری محیط pckle شده"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
-msgstr ""
+msgstr "شکست خورد: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
-msgstr ""
+msgstr "هیچ سازنده‌ای برگزیده نشده، استفاده از قالب خروجی پیش‌فرض: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
-msgstr ""
+msgstr "موفّقیّت‌آمیز بود"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
-msgstr ""
+msgstr "انجام شد ولی با مشکل"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
-msgstr ""
+msgstr "ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار می‌شود)."
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
-msgstr ""
+msgstr "ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار می‌شود)."
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
-msgstr ""
+msgstr "ساخت %s، %s هشدار."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
-msgstr ""
+msgstr "ساخت %s، %s هشدار."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
-msgstr ""
+msgstr "ساخت %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
-msgstr ""
+msgstr "بست کلاس %r در حال حاضر ثبت نام شده است، بازدیدکنندگان این پیوند نادیده گرفته خواهد شد"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
-msgstr ""
+msgstr "دستور %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
-msgstr ""
+msgstr "نقش %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr ""
+msgstr "افزونه‌ی %s مشخّص نکرده که آیا برای خواندن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
-msgstr ""
+msgstr "افزونه ی %sبرای خواندن موازی امن نیست"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr ""
+msgstr "افزونه‌ی %s مشخّص نکرده که آیا برای نوشتن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
-msgstr ""
+msgstr "افزونه‌ی %s برای نوشتن موازی امن نیست"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
-msgstr ""
+msgstr "انجام چندباره‌ی %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
-msgstr ""
+msgstr "امکان لغو تنظیمات پیکربندیdictionary %r ، نادیده گرفته می‌شود (برای تعیین تک تک عناصر %r را به کار ببرید)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
-msgstr ""
+msgstr "شماره نامعتبر %r برای پیکربندی مقدار %r، نادیده گرفته می‌شود"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
-msgstr ""
+msgstr "امکان لغو تنظیمات پیکربندی %r با نوع پشتیبانی نشده نبود، نادیده گرفته می‌شود"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
-msgstr ""
+msgstr "مقدار پیکربندی ناشناخته %r در ابطال، نادیده گرفته شد"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
-msgstr ""
+msgstr "چنین مقداری برای پیکربندی نبود: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
-msgstr ""
+msgstr "مقدار پیکربندی %r از قبل موجود است"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
-msgstr ""
+msgstr "خطای نحوی در پرونده‌ی پیکربندی شما وجود دارد: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
-msgstr ""
+msgstr "پرونده‌ی پیکربندی (یا یکی از ماژول هایی که وارد می کند)  sys.exit() را فراخواند"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
 "\n"
 "%s"
-msgstr ""
+msgstr "یک خطای قابل برنامه ریزی در پرونده‌ی پیکربندی شما وجود دارد:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
-msgstr ""
+msgstr "مقدار پیکربندی 'source_suffix' انتظار یک رشته، لیست رشته ها، یا فرهنگ لغت را داشت. اما '%r' داده شده است."
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
-msgstr ""
+msgstr "بخش%s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
-msgstr ""
+msgstr "شکل %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
-msgstr ""
+msgstr "جدول %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
-msgstr ""
+msgstr "فهرست %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
-msgstr ""
+msgstr "مقدار پیکربندی '{name}' باید یکی از {candidates} باشد، اما '{current}' داده شده."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
-msgstr ""
+msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، ولی انتظار می‌رفت {permitted} می‌بود."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
-msgstr ""
-
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
+msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، حالت پیش‌فرض {permitted} است."
 
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
-msgstr ""
+msgstr "دامنه‌ی اصلی %r یافت نشد، نادیده گرفته می‌شوند."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr ""
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr "از زمان نسخه‌ی ۲ تا به حال، اسفیکنس به صورت پیش فرض از \"index\" به عنوان ریشه‌ی سند(root_doc) استفاده می‌کند. لطفاً \"root_doc = 'contents'\" را به پرونده  conf.py تان اضافه کنید."
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
-msgstr ""
+msgstr "رویداد %r در حال حاضر موجود است"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
-msgstr ""
+msgstr "نوع اتفاق نامشخّص است: %s"
+
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr "مدیر %r برای رویداد %r یک باعث ایراد شد"
 
-#: sphinx/extension.py:51
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
-msgstr ""
+msgstr "تنظیمات needs_extensions (نیازهای افزونه) افزونه‌ی %s را نیاز دارد، ولی بارگذاری نمی شود."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
-msgstr ""
+msgstr "این پروژه افزونه‌ی %s (دست کم نسخه‌ی %s) را نیاز دارد، بنابراین نمی تواند با نسخه بارگذاری شده (%s) ساخته شود."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
-msgstr ""
+msgstr "نام رنگ‌مایه خوان %r شناخته شده نیست"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
-msgstr ""
+msgstr "امکان خواندن قسمت \"%s\" به عنوان بخش نثل قول ادبی نبود. برجسته کردن آن نادیده گرفته شد."
+
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr "برای سند \"%s\": %r پرونده های متعدد یافت شده \nاز %r برای ساخت استفاده کنید."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
-msgstr ""
+msgstr "سند قابل خواندن نیست. نادیده گرفته شد."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
-msgstr ""
+msgstr "کلاس سازنده %s هیچ ویژگی‌ای به عنوان \"name\" ندارد"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
-msgstr ""
+msgstr "سازنده %r در حال حاضر وجود دارد (در پیمانه‌ی %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
-msgstr ""
+msgstr "نام سازنده %s یا ثبت شده نیست و یا فقط از طریق نقطه ورود در دسترس است"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
-msgstr ""
+msgstr "نام سازنده %s ثبت نشده است"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
-msgstr ""
+msgstr "دامنه ی %sپیش تر ثبت شده"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
-msgstr ""
+msgstr "دامنه %s هنوز ثبت نشده است"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
-msgstr ""
+msgstr "دستورالعمل %r قبلاً برای دامنه %s ثبت شده"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
-msgstr ""
+msgstr "نقش %r قبلاً برای دامنه %s ثبت شده"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
-msgstr ""
+msgstr "شاخص %r قبلاً برای دامنه %s ثبت شده"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
-msgstr ""
+msgstr "نوع شیئ(object_type) ٪r قبلاً برای دامنه %s ثبت شده"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
-msgstr ""
+msgstr "ارجاع متقابل (crossref_type) %r قبلاً ثبت شده"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
-msgstr ""
+msgstr "پسوند (source_suffix) %r قبلاً ثبت شده است"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
-msgstr ""
+msgstr "تحلیل‌گر منبع (source_parser) %r قبلاً ثبت شده است"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
-msgstr ""
+msgstr "تجزیه کننده مبدإ برای %s ثبت نشده است"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
-msgstr ""
+msgstr "در حال حاضر برای %r مترجم وجود دارد"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
-msgstr ""
+msgstr "مؤلّفه‌های کلیدی برای تابع add_node() باید تاپل تابعی (بازدید، خروج) باشند: %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
-msgstr ""
+msgstr "بست قابل شمارش (enumerable_node) %r قبلاً ثبت شده است"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
-msgstr ""
+msgstr "ترسیم‌گر ریاضی %s قبلاً ثبت شده"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
-msgstr ""
+msgstr "افزونه‌ی %r از نسخه‌ی %s اسفینکس به بعد، در آن ادغام شده؛ بنابراین نادیده گرفته می‌شود."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
-msgstr ""
+msgstr "ایراد اصلی:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
-msgstr ""
+msgstr "امکان وارد کردن افزونه‌ی %s نبود"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
-msgstr ""
+msgstr "افزونه‌ی %r  هیچ تابع setup()ی ندارد؛ آیا این مورد واقعاً یک پیمانه‌ی افزونه‌ی اسفینکس است؟"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
-msgstr ""
+msgstr "افزونه‌ی %s که در این پروژه استفاده شده دست کم نیازمند اسفینکس نسخه‌ی %s است؛ بنابراین با این نسخه قابل ساخت نیست."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
-msgstr ""
+msgstr "افزونه‌ی %r شیئ پشتیبانی نشده‌‌ای از تابع setup()ش برگرداند؛ در حالی که می بایست مقدار تهی/هیچ و یا یک دیکشنری فراداده‌ برمی‌گرداند"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
-msgstr ""
+msgstr "زمینه ی %r فاقد تنظیمات است"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
-msgstr ""
+msgstr "زمینه‌ی %r تنظیمات به ارث بری ندارد"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
-msgstr ""
+msgstr "هیچ زمینه‌ای به نام %r پیدا نشد، که با %r جایگزین شود"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
-msgstr ""
+msgstr "تنظیمات %s. %s در هیچ یک از پیکربندی‌های جستجو شده رخ نمی‌دهد"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
-msgstr ""
+msgstr "گزینه‌ی پشتیبانی نشده‌ی زمینه %r داده شده"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
-msgstr ""
+msgstr "پرونده‌ی %r که مسیر زمینه به آن اشاره دارد یا پرونده زیپ معتبری نیست یا هیچ زمینه‌ای درونش ندارد"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr ""
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr "زمینه‌ی خواندن مستندات اسفینکس (< 0.3.0) پیدا شد. از نسخه‌ی ۶/۰ اسفینکس این زمینه‌ دیگر در دسترس نخواهد بود"
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
-msgstr ""
+msgstr "هیچ زمینه‌ای با نام %r  پیدا نشد(آیا پرونده theme.conf گم شده؟)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
-msgstr ""
+msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
-msgstr ""
+msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
-msgstr ""
+msgstr "ساخت پرونده‌ی [mo]: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
-msgstr ""
+msgstr "نوشتن برون‌داد... "
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
-msgstr ""
+msgstr "همه‌ی پرونده‌های %d po"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
-msgstr ""
+msgstr "اهداف برای %d پرونده‌های poی که مشخّص شده"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
-msgstr ""
+msgstr "مقصد‌های %d پرونده‌های poی هستند که منسوخ شده‌اند"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
-msgstr ""
+msgstr "همه‌ی پرونده‌های منبع"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
-msgstr ""
+msgstr "پرونده‌ی %r که در خط فرمان داده شده، در شاخه‌ی منبع نیست, نادیده گرفته می‌شود"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
-msgstr ""
+msgstr "پرونده‌ی %r که در خط فرمان داده شده، وجود ندارد، نادیده گرفته می‌شود"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
-msgstr ""
+msgstr "پرونده‌های منبع %d داده شده در خط فرمان"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
-msgstr ""
+msgstr "مقصد‌های %d پرونده‌های منبعی هستند که منسوخ شده‌اند"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
-msgstr ""
+msgstr "ساخت [%s]: "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
-msgstr ""
+msgstr "در پی پرونده‌هایی که الآن منسوخ هستند... "
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
-msgstr ""
+msgstr "%d تا مورد پیدا شد"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
-msgstr ""
+msgstr "چیزی پیدا نشد"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
-msgstr ""
+msgstr "بارگذاری محیط pickle شده"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
-msgstr ""
+msgstr "بررسی ثبات"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
-msgstr ""
+msgstr "هیچ مقدار تاریخ منسوخ نیست."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
-msgstr ""
+msgstr "به روز رسانی محیط: "
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
-msgstr ""
+msgstr "%s اضافه شد، %s تغییر کرد، %s حذف شد"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
-msgstr ""
+msgstr "خواندن منبع‌ها... "
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
-msgstr ""
+msgstr "در انتظار برای ابزارهای کارگر..."
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
-msgstr ""
+msgstr "نام مستندات برای نوشتن: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
-msgstr ""
+msgstr "آماده سازی اسناد"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
-msgstr ""
+msgstr "عنوان تکراری در فهرست مطالب پیدا شد:%s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
-msgstr ""
+msgstr "در حال رونوشت از تصاویر... "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
-msgstr ""
+msgstr "امکان خواندن پرونده‌ی تصویری %r نبود: در عوض کپی می‌شود"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
-msgstr ""
+msgstr "نمی تواند پرونده‌ی تصویر %r: %s را کپی کند"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
-msgstr ""
+msgstr "نمی تواند پرونده‌ی تصویری %r: %s را بنویسد"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
-msgstr ""
+msgstr "Pillow پیدا نشد- رونوشت برداشتن از پرونده‌های تصویری"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr ""
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr "نوشتن پرونده‌های نوع رسانه..."
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr "نوشتن پرونده META-INF/container.xml..."
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr "نوشتن پرونده‌ی content.opf..."
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
-msgstr ""
+msgstr "نوع رسانه‌ی ناشناخته %s، نادیده گرفته شد"
+
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr "نوشتن پرونده‌ی خلاصه toc.ncx..."
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "نوشتن پرونده‌ی %s..."
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
-msgstr ""
+msgstr "پرونده‌ی بازبینی در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
-msgstr ""
+msgstr "بدون تغییرات در نسخه‌ی %s."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
-msgstr ""
+msgstr "نوشتن پرونده‌ی خلاصه..."
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "درونی سازی"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "در سطح ماژول"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
-msgstr ""
+msgstr "رونوشت از پرونده‌های مبدأ..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
-msgstr ""
+msgstr "نمی‌توان %r را برای ایجاد گزارش تغییرات خواند"
 
 #: sphinx/builders/dummy.py:22
 msgid "The dummy builder generates no files."
-msgstr ""
+msgstr "سازنده‌ی بدلی هیچ پرونده‌ای تولید نمی کند."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
-msgstr ""
+msgstr "پرونده‌ی ePub در پوشه‌ی %(outdir)s است."
+
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr "نوشتن پرونده‌ی nav.xhtml..."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی زبان پرونده epub (\"epub_language\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی شناسه‌ی یکتای انتشار الکترونیکی (\"epub_uid\") باید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) یک XML NAME باشد"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی عنوان (\"html_title\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی مؤلّف (\"epub_author\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی حامی (\"epub_contributor\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی توضیحات (\"epub_description\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی ناشر (\"epub_publisher\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی حق انتشار (\"epub_copyright\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی شناسه (\"epub_identifier\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
-msgstr ""
+msgstr "مقدار پیکربندی ویراست (\"version\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
-msgstr ""
+msgstr "پرونده‌ی css نامعتبر%r: نادیده گرفته می‌شود"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
-msgstr ""
+msgstr "سیاهه‌های پیام‌ها در %(outdir)s است."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
-msgstr ""
+msgstr "مقصد‌های قالب پرونده‌های %d"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
-msgstr ""
+msgstr "خواندن قالب‌ها... "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
-msgstr ""
+msgstr "نوشتن سیاهه‌های پیام... "
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
-msgstr ""
+msgstr "به دنبال هر یک از خطاهای بالا در یا در برون‌داد و یا در %(outdir)s/output.txt بگردید"
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
-msgstr ""
+msgid "broken link: %s (%s)"
+msgstr "پیوند خراب:  %s (%s)"
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
-msgstr ""
+msgid "Anchor '%s' not found"
+msgstr "مهار '%s' پیدا نشد"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
-msgstr ""
+msgstr "صفحات راهنما در %(outdir)s است."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
-msgstr ""
+msgstr "هیچ مقداری برای تنظیمات «صفحات راهنما» ا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
-msgstr ""
+msgstr "در حال نوشتن"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
-msgstr ""
+msgstr "پیکربندی مقدارهای «صفحات راهنما» به سند ناشناخته‌ای ارجاع می‌دهند %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
-msgstr ""
+msgstr "صفحه HTML در %(outdir)s است."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
-msgstr ""
+msgstr "سر جمع کرد تک سند"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
-msgstr ""
+msgstr "نوشتن پرونده‌های اضافی"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
-msgstr ""
+msgstr "پرونده‌ی اطّلاعات متن در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
-msgstr ""
+msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها رh با makeinfo اجرا کند\n(برای انجام خودکار `make info' را به کار ببرید)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
-msgstr ""
+msgstr "هیچ تنظیماتی برای «صفحات راهنما» پیدا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
-msgstr ""
+msgstr "مقدار پیکربندی اطّلاعات متن سندها (texinfo_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
-msgstr ""
+msgstr "در حال پردازش %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
-msgstr ""
+msgstr "حل ارجاع‌ها..."
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
-msgstr ""
+msgstr " (در "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
-msgstr ""
+msgstr "رونوشت از پرونده‌های با پشتیبانی اطلاعات متن"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
-msgstr ""
+msgstr "خطای نوشتن پرونده‌ی ساخت (Makefile) : %s"
 
 #: sphinx/builders/text.py:30
 #, python-format
 msgid "The text files are in %(outdir)s."
-msgstr ""
+msgstr "پرونده‌ی متنی در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
-msgstr ""
+msgstr "خطای نوشتن پرونده: %s, %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
-msgstr ""
+msgstr "پرونده‌ی XML در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
-msgstr ""
+msgstr "پرونده‌های شبه XML در پوشه‌ی %(outdir)s."
 
 #: sphinx/builders/html/__init__.py:144
 #, python-format
 msgid "build info file is broken: %r"
-msgstr ""
+msgstr "پرونده‌ی اطّلاعات ساخت خراب است: %r"
 
 #: sphinx/builders/html/__init__.py:176
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
-msgstr ""
+msgstr "صفحات HTML در %(outdir)s است."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
-msgstr ""
+msgstr "شکست در خواندن پرونده‌ی اطّلاعات ساخت: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
-msgstr ""
+msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "فهرست کلی"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "فهرست"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "بعدی"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "قبلی"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
-msgstr ""
+msgstr "تولید نمایه‌ها"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
-msgstr ""
+msgstr "نوشتن صفحات اضافی"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
-msgstr ""
+msgstr "رونوشت از پرونده‌های قابل دریافت... "
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
-msgstr ""
+msgstr "نمی تواند از پرونده‌ی قابل دریافت %r: %s رونوشت بگیرد"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr ""
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr "شکست در رونوشت یک پرونده‌ی به html_static_file: %s: %r"
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr "رونوشت از پرونده‌های ثابت"
+
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
-msgstr ""
+msgstr "نمی تواند از پرونده‌ی ثابت %r رونوشت بگیرد"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
-msgstr ""
+msgstr "رونوشت برداری از پرونده‌های اضافی"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
-msgstr ""
+msgstr "نمی تواند از پرونده‌ی اضافه‌ی %r رونوشت بگیرد"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
-msgstr ""
+msgstr "شکست در نوشتن پرونده‌ی اطّلاعات ساخت: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
-msgstr ""
+msgstr "نمایه‌ی جستجو نمی‌تواند بارگزاری شود، ولی برای همه‌ی مستندات ساخته‌ نمی‌شود: نمایه‌ ناقص خواهد بود."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
-msgstr ""
+msgstr "صفحه‌ی %s با دو الگو در نوار کناری صفحه (html_sidebars) هم‌خوانی دارد: %r و%r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
-msgstr ""
+msgstr "هنگام ارائه‌ی صفحه‌ی %s خطای یونیکد رخ داد. لطفاً اطمینان حاصل کنید که تمام مقدارهای پیکربندی‌ها دارای محتوای غیر اَسکی، رشته‌متن‌های یونکد هستند."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
-msgstr ""
+msgstr "خطایی در نمایش صفحه‌ی %s رخ داد.\nعلّت: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
-msgstr ""
+msgstr "خالی کردن فهرست اشیاء"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
-msgstr ""
+msgstr "خالی کردن نمایه‌ی جستجو در %s"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
-msgstr ""
+msgstr "پرونده‌ی js نامعتبر%r: نادیده گرفته می‌شود"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
-msgstr ""
+msgstr "ارا‌ئه کننده‌های ریاضی زیادی ثبت شده‌اند، ولی هیچ کدام انتخاب نشده."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
-msgstr ""
+msgstr "نمایش‌دهنده‌ی ریاضی نامشخّص %r داده شده."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
-msgstr ""
+msgstr "مدخل مسیر اضافی (html_extra_path) %r وجود ندارد"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "مدخل مسیر اضافی (html_extra_path) %r درون شاخه‌ی خارجی قرار دارد"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
-msgstr ""
+msgstr "مدخل مسیر ثابت (html_static_path) %r وجود ندارد"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "مدخل مسیر ثابت (html_static_path) %r درون شاخه‌ی خارجی قرار دارد"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
-msgstr ""
+msgstr "پرونده‌ی آرم %r وجود ندارد"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
-msgstr ""
+msgstr "پرونده‌ی آیکون مورد علاقه %r وجود ندارد"
+
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr "از نسخه‌ی ۳.۵.۰ به بعد افزودن پیوند همیشگی (html_add_permalinks) منسوخ شده. لطفاً از به جایش html_permalinks و html_permalinks_icon را به کار ببرید."
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
-msgstr ""
+msgstr "مستندات %s%s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
-msgstr ""
+msgstr "پرونده‌ی LaTeX در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
-msgstr ""
+msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها را با لتکس(pdf) اجرا کند\n(برای انجام خودکار `make latexpdf' را به کار ببرید)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
-msgstr ""
+msgstr "هیچ مقدار پیکربندی اسناد لتکسی (latex_documents) پیدا نشد؛ بنابراین هیچ سندی نوشته نخواهد شد"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
-msgstr ""
-
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+msgstr "مقدار پیکربندی سندهای لتکس (latex_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد"
+
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "فهرست"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "انتشار"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
-msgstr ""
+msgstr "بدون گزینه‌ی Babel شناخته شده برای زبان %r"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
-msgstr ""
+msgstr "رونوشت از پرونده‌های پشتیبانی لتکس"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
-msgstr ""
+msgstr "رونوشت از پرونده‌های پشتیبانی لتکس..."
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
-msgstr ""
+msgstr "رونوشت برداری از پرونده‌های اضافی"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
-msgstr ""
+msgstr "کلید پیکربندی ناشناخته: latex_elements[%r]، نادیده گرفته می‌شود."
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr "کلید زمینه‌ی ناشناخته: latex_theme_options[%r]، نادیده گرفته می‌شود."
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
-msgstr ""
+msgstr "%r فاقد تنظیمات زمینه است"
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
-msgstr ""
+msgstr "%r فاقد تنظیمات  \"%s\"  است"
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
-msgstr ""
+msgstr "در حین ساخت ایرادی رخ داد، شروع اشکال زدا:"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
-msgstr ""
+msgstr "قطع شد!"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
-msgstr ""
+msgstr "خطای نشانه‌گذاری متن بازساختمند (reST)"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
-msgstr ""
+msgstr "خطای کدگذاری نویسه:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
-msgstr ""
+msgstr "اگر می‌‌خواهید مشکل را به توسعه‌دهندگان گزارش دهید، ردیابی کامل خطا در %s ذخیره شده است."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
-msgstr ""
+msgstr "خطای بازگشتی:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr ""
+msgstr "این اتّفاق ممکن است برای پرونده‌های بسیار تو در توی منبع بیافتد. شما می‌توانید محدودیّت ۱۰۰۰ تایی مقدار پیش‌فرض اجرای بازگشت پایتون را در conf.py زیاد کنید، مثلاً با:"
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
-msgstr ""
+msgstr "ایراد رخ داد:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
-msgstr ""
+msgstr "لطفاً اگر این مورد خطای کاربر بوده، آن را گزارش دهید تا برای بارهای بعدی پیام خطای بهتری بتواند ارائه شود."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
-msgstr ""
+msgstr "گزارش اشکال می تواند در ردیاب در مسیر <https://github.com/sphinx-doc/sphinx/issues> ثبت شود. با سپاس!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
-msgstr ""
+msgstr "شماره‌ی کار باید یک عدد مثبت باشد"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
-msgstr ""
+msgstr "برای اطّلاعات بیشتر به <http://sphinx-doc.org/> بروید."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1177,296 +1220,290 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr ""
+msgstr "\nایجاد مستندات از پرونده‌های مبدأ.\n\nسازنده‌ی اسفنکس مستندات را از روی پرونده های مبنع در پوشه‌‌ی منبع تولید کرده در پوشه‌ی برون‌داد قرار می‌دهد.\nاین سازنده در پوشه‌ی مبدأ به دنبال پرونده 'conf.py' تنظیمات پیکربندی می‌گردد.\nاین امکان وجود دارد که از ابزار شروع سریع اسفینکس ('sphinx-quickstart') برای تولید پرونده‌های قالب، که شامل پرونده 'conf.py' هم می‌شود استفاده شود.\n\nسازنده‌ی اسفینکس می توند مستندات را در قالب‌های گوناگونی از پرونده‌های خروجی ایجاد کند. قالب پرونده خروجی با مشخّص کردن نام سازنده در خط فرمان مشخّص می‌شود که به صورت پیش فرض HTML است.  همچنین، سازنده‌ها می‌توانند کارهای دیگر مربوط به فرآیند پردازش مستندسازی را انجام دهند.\n\nبه صورت پیش فرض، هر چیزی که منسوخ شده باشد تولید می‌شود. برون‌داد برای پرونده‌های منتخب می‌تواند فقط با مشخّص کردن نام تک تک پرونده‌ها ساخته شود.\n"
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
-msgstr ""
+msgstr "مسیر پرونده‌های مستندات"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
-msgstr ""
+msgstr "مسیری برای شاخه‌ی برون داد"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
-msgstr ""
+msgstr "لیست پرونده‌هایی که قرار است دوباره ساخته شوند. اگر با -a مشخّص شده باشند نادیده گرفته می‌شوند"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
-msgstr ""
+msgstr "گزینه‌های کلی"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
-msgstr ""
+msgstr "قالب سازنده مورد استفاده (پیش‌فرض:html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
-msgstr ""
+msgstr "نوشتن همه‌ی پرونده‌ها (پیش‌گزیده: فقط پرونده‌های جدید نو تغییر یافته را بنویس)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
-msgstr ""
+msgstr "از محیط ذخیره شده استفاده نکن، همیشه همه پرونده ها را بخوان"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
-msgstr ""
+msgstr "مسیر برای محیط ذخیره‌ شده و پرونده‌های doctree (پیش فرض: OUTPUTDIR /.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
-msgstr ""
+msgstr "درصورت امکان ساخت به صورت موازی با N فرآیند پردازشی (مقدار ویژه‌ی «خودکار» شمار N را به تعداد پردازنده تنظیم می‌کند)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
-msgstr ""
+msgstr "مسیر جایی که پرونده‌ی پیکربندی (conf.py) قرار دارد ( پیش‌گزیده: مثل پوشه‌ی منبع)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
-msgstr ""
+msgstr "هیچ پرونده‌ی پیکربندی‌ای استفاده نکن، فقط گزینه‌ی -D"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
-msgstr ""
+msgstr "نادیده گرفتن تنظیماتی در پرونده‌ی پیکره‌بندی"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
-msgstr ""
+msgstr "مقداری را به قالب‌های HTML بدهید"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
-msgstr ""
+msgstr "تعریف برچسب: «فقط» تکّه‌های با برچسب گنجانده شود"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
-msgstr ""
+msgstr "حالت ریزبینانه، هشدار درباره‌ی همه‌ی ارجاع‌های ناپیدا"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
-msgstr ""
+msgstr "گزنیه‌های برون‌داد میز فرمان"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
-msgstr ""
+msgstr "افزایش ارائه‌ی جزئیّات (می تواند تکرار شود)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
-msgstr ""
+msgstr "بدون برون‌داد در درگاه خروجی استاندارد(stdout)، فقط هشدارها در درگاه استاندارد خطاها (stderr)"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
-msgstr ""
+msgstr "بدون هیچ برون‌داد، حتّی بدون هشدار"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
-msgstr ""
+msgstr "خروجی رنگ شده منتشر شود (پیش‌فرض: تشخیص خودکار)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
-msgstr ""
+msgstr "خروجی رنگ شده منتشر نشود (پیش‌فرض: تشخیص خودکار)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
-msgstr ""
+msgstr "نوشتن هشدارها (و خطاها) در پرونده‌ی داده شده"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
-msgstr ""
+msgstr "تغییر هشدارها به خطاها"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
-msgstr ""
+msgstr "با سوییچ -W، در هنگام گرفتن هشدار ادامه بده"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
-msgstr ""
+msgstr "نمایش گزارش کامل ردیابی ایراد"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
-msgstr ""
+msgstr "ایراد در اجرای Pdb"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
-msgstr ""
+msgstr "پرونده‌های %r پیدا نشدند"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
-msgstr ""
+msgstr "نمی توان گزینه‌ی -a را با نام پرونده‌ها ترکیب کرد"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
-msgstr ""
+msgstr "امکان باز کردن پرونده هشدار نبود %r: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
-msgstr ""
+msgstr "نشانوند گزینه‌ی D- می‌بایست در قالب نام=مقدار (name=value) باشد"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
-msgstr ""
+msgstr "نشانوند گزینه‌ی A- می‌بایست در قالب نام=مقدار (name=value) باشد"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
-msgstr ""
+msgstr "درج خودکار رشته‌مستندات را از پیمانه‌ها"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
-msgstr ""
+msgstr "آزمایش خودکار تکّه‌کدها در قسمت‌های مختلف پیمانه‌ی doctest"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
-msgstr ""
+msgstr "پیوند بین اسناد Sphinx از پروژه های گوناگون"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
-msgstr ""
+msgstr "نوشتن مدخل‌های لیست اقدام‌ها (\"todo\")که در ساخت می تواند نشان داده و یا پنهان شوند"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
-msgstr ""
+msgstr "بررسی برای پوشش اسناد"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
-msgstr ""
+msgstr "گنجاندن رابطه‌های ریاضی که در قالب PNG یا SVG به نمایش در آمده"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
-msgstr ""
+msgstr "گنجاندن رابطه‌های ریاضی که MathJax در مرورگر نمایش در آورده"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
-msgstr ""
+msgstr "گنجاندن شرطی محتوا بر اساس مقادیر پیکربندی"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
-msgstr ""
+msgstr "گنجاندن ویندهای کد منبع اشیاء مستند شده‌ی پایتون"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
-msgstr ""
+msgstr "ساخت پرونده‌ی nojekyll  برای انتشار سند در صفحات گیت-هاب"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
-msgstr ""
+msgstr "لطفاً نام مسیر معتبری را وارد کنید."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
-msgstr ""
+msgstr "لطفاً متنی وارد کنید."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
-msgstr ""
+msgstr "لطفاً یکی از  %s وارد کنید."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
-msgstr ""
+msgstr "لطفاً یا y و یا n وارد کنید."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
-msgstr ""
+msgstr "لطفاً یک پسوند را وارد کنید، مثل: '.rst'  یا '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
-msgstr ""
+msgstr "به ابزار شروع سریع اسفینکس %s خوش آمدید."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
-msgstr ""
+msgstr "لطفاً مقدارهای تنظیمات زیر را وارد کنید\n(اگر مقدار پیش‌گزیده‌ای درون داده کروشه شده بود، برای برای پذیرش آن فقط کلید Enter‌را فشار دهید)."
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
-msgstr ""
+msgstr "مسیر برگزیده‌ی ریشه‌ی مستندات: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
-msgstr ""
+msgstr "مسیر ریشه‌ی مستندات را وارد کنید."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
-msgstr ""
+msgstr "مسیر ریشه‌ی مستندات"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
-msgstr ""
+msgstr "خطا: در مسیر ریشه‌ی انتخاب شده‌، پرونده‌ی conf.pyی دیگری یپدا شد."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
-msgstr ""
+msgstr "ابراز شروع سریع اسفینکس روی پروژه‌های از قبل موجود اسفینکس بازنویسی نمی‌کند."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
-msgstr ""
+msgstr "لطفاً یک مسیر ریشه‌ی جدید وارد کنید (یا برای خروج Enter‌ را بزنید)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
-msgstr ""
+msgstr "شما برای تعیین شاخه‌ی ساخت برای برون‌داد اسفینکس دو گزینه دارید.\nیا از شاخه‌ای با نام \"_build\" درون شاخه‌ی ریشه استفاده کنید،\nو یا شاخه‌های را درون یک مسیر ریشه با نام‌های منبع (source) و ساخت (build) جدا کنید."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
-msgstr ""
+msgstr "شاخه‌های منبع و ساخت از یکدیگر جدا شوند؟(y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
-msgstr ""
+msgstr "درون شاخه‌ی ریشه، دو شاخه‌ی دیگر ساخته خواهد شد؛\n\"_templates\" برای قالب‌های سفارشی HTML و \"_static\" برای قالب برگه‌ها و بقیّه‌ی پرونده‌های ثابت.\nشما می‌توانید پیشوند دیگری (مانند «.») برای جایگزینی نویسه‌ی خط به کار ببرید."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
-msgstr ""
+msgstr "برای  شاخه‌های قالب‌ها (templates) و ثابت‌ها (static) نویسه‌ی پیشوندی را بنویسید"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
-msgstr ""
+msgstr "نام پروژه در چندین جا در سند ساخته شده به کار می‌رود."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
-msgstr ""
+msgstr "نام پروژه"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
-msgstr ""
+msgstr "نام نویسنده (ها)"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr ""
+msgstr "اسفینکس نظریّه‌ای برای یک «نسخه» و یک «نگارش» برای نرم افزار دارد.\nهر نسخه‌ای می تواند چندید نگارش داشته باشد.\n مثلاً برای پایتون نسخه‌ چیزی شبیه به ۲/۵ یا ۳/۰ است،\n در حالی که انتشار چیزیست شبیه به ۲/۵/۱ یا ۳/۰a۱ \n.\nاگر شما نیازی به این ساختار دوگانه ندارید، هر دو را یکی تعیین کنید."
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
-msgstr ""
+msgstr "نسخه انتشار پروژه"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
-msgstr ""
+msgstr "انتشار پروژه"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1474,115 +1511,115 @@ msgid ""
 "\n"
 "For a list of supported codes, see\n"
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
-msgstr ""
+msgstr "اگر مستندات قرار است با زبانی غیر از انگلیسی نوشته شود،\nمی توانید همین‌جا یک زبان را با انتخاب کد زبانیش انتخاب کنید.\nاسفینکس سپس متن‌هایی را که تولید می‌کند را به آن زبان ترجمه می‌کند.\n\nبرای فهرست زبان‌های پشتیبانی شده، به این نشانی مراجعه کنید\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
-msgstr ""
+msgstr "زبان پروژه"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr ""
+msgstr "پسوند نام پرونده برای پرونده‌های منبع. معمولاً این پسوند یا \".txt\" است و یا \".rst\".\nفقط پرونده‌هایی بای این پسوند به عنوان اسناد در نظر گرفته می‌شوند."
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
-msgstr ""
+msgstr "پسوند پرونده‌ی منبع"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
 "of the documents. Normally, this is \"index\", but if your \"index\"\n"
 "document is a custom template, you can also set this to another filename."
-msgstr ""
+msgstr "یک سند از آن جهت خاص است که  به عنوان بست بالایی «درختواره‌ی محتوا» در نظر گرفته می‌شود.\nیعنی، این سند ریشه‌ی ساختار سلسله مراتبی اسناد است.\nمعمولاً سند این کار «نمایه» است، ولی اگر سند «نمایه‌»‌ی شما قالب سفارشی است؛ می توانید آن را به نام دیگری تغییر دهید."
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
-msgstr ""
+msgstr "نام سند اصلی شما (بدون پسوند)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
-msgstr ""
+msgstr "خطا: پرونده‌ی اصلی %s از قبل در مسیر ریشه‌ی برگزیده بوده‌است."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
-msgstr ""
+msgstr "ابراز شروع سریع اسفینکس روی پرونده‌های از قبل موجود بازنویسی نمی‌کند."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
-msgstr ""
+msgstr "لطفاُ یک نام جدید وارد کنید، یا نام پرونده‌ی موجود را تغییر دهید و Enter‌ را فشار دهید"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
-msgstr ""
+msgstr "مشخّص کنید کدام یک از این افزونه‌های اسفینکس باید فعّال باشد:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
-msgstr ""
+msgstr "یادداشت: ابزارهای‌ imgmath و mathjax نمی‌توانند در یک زمان فعّال باشند. انتخاب imgmath لغو شد."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
-msgstr ""
+msgstr "پرونده‌های خط‌فرمان ویندوز و Makefile می‌توانند برای شما تولید شوند، به گونه‌ای که شما فقط نیاز باشد تا مثلاً فرمان `make html' را به جای فراخوان مستقیم ابزار ساخت اسفینکس اجرا کنید."
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
-msgstr ""
+msgstr "آیا پرونده‌ی‌ make ایجاد شود؟ (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
-msgstr ""
+msgstr "آیا پرونده‌ی خط فرمان ویندوز ساخته شود؟ (y/n)ٍ"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
-msgstr ""
+msgstr "ایجاد پرونده‌ی %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
-msgstr ""
+msgstr "پرونده‌ی %r در حال حاضر وجود دارد، رد شدن."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
-msgstr ""
+msgstr "پایان یافت: ساختار آغازین شاخه ایجاد شد."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
-msgstr ""
+msgstr "شما باید حالا دیگر پرونده‌ی اصلی‌تان %s را جمع آوری کنید و بقیّه‌ی پرونده‌های منبع مستندات را ایجاد کنید. ‌"
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
-msgstr ""
+msgstr "از Makefile  برای ساختن مستندات استفاده کنید، مانند این:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
-msgstr ""
+msgstr "از فرمان ساخت اسفینکس برای ساختن مستندات استفاده کنید، مانند این:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
-msgstr ""
+msgstr "که در آن سازنده یکی از سازنده‌های پشتیبانی شده است، مانند html, latex و یا linkcheck."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1590,789 +1627,778 @@ msgid ""
 "sphinx-quickstart is an interactive tool that asks some questions about your\n"
 "project and then generates a complete documentation directory and sample\n"
 "Makefile to be used with sphinx-build.\n"
-msgstr ""
+msgstr "\nتولید پرونده‌های مورد نیاز برای یک پروژه‌ی اسفینکس\n\nابزار شروع سریع اسفینکس ابزاری تعاملی است که شماری سؤال درباره‌ی پروژه‌یتان از شما می پرسد\nو سپس یک شاخه‌ی کامل مستندات و پرونده ساخت Makefile را برای استفاده به همراه ابزار ساخت اسفینکس تولید می‌کند.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
-msgstr ""
+msgstr "حالت سکوت"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
-msgstr ""
+msgstr "ریشه‌ی پروژه"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
-msgstr ""
+msgstr "گزینه‌های ساختار"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
-msgstr ""
+msgstr "در صورتی مشخّص شدن، شاخه‌های منبع و ساخت از یکدیگر جدا می‌شوند"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr "در صورت مشخّص بودن، شاخه‌ی build (ساخت) را درون شاخه‌ی منبع بساز"
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
-msgstr ""
+msgstr "جایگزینی نقطه در _templates (قالب‌ها) و ... ."
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
-msgstr ""
+msgstr "گزینه‌های اساسی پروژه"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
-msgstr ""
+msgstr "نام پروژه"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
-msgstr ""
+msgstr "نام نویسندگان"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
-msgstr ""
+msgstr "نسخه انتشار پروژه"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
-msgstr ""
+msgstr "انتشار پروژه"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
-msgstr ""
+msgstr "زبان سند"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
-msgstr ""
+msgstr "پسوند پرونده‌ی منبع"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
-msgstr ""
+msgstr "نام سند اصلی"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
-msgstr ""
+msgstr "استفاده epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
-msgstr ""
+msgstr "گزینه‌های افزونه"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
-msgstr ""
+msgstr "فعّال‌سازی %s افزونه"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
-msgstr ""
+msgstr "فعّال‌سازی افزونه‌های اختیاری"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
-msgstr ""
+msgstr "ایجاد Makefile و Batchfile"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
-msgstr ""
+msgstr "ایجاد پرونده‌ی سازنده (makefile)"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
-msgstr ""
+msgstr "پرونده‌ی سازنده (makefile) را ایجاد نکن"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
-msgstr ""
+msgstr "ایجاد Batchfile"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
-msgstr ""
+msgstr "batchfile را ایجاد نکن"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
-msgstr ""
+msgstr "اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
-msgstr ""
+msgstr "عدم اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
-msgstr ""
+msgstr "قالب سازی پروژه"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
-msgstr ""
+msgstr "شاخه‌ی قالب شامل پرونده‌های قالب"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
-msgstr ""
+msgstr "تعریف متغیّر قالب"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
-msgstr ""
+msgstr "حالت «ساکت» تعیین شده، ولی یکی از موارد «پروژه» یا «نویسنده» مشخّص نشده."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
-msgstr ""
+msgstr "خطا: مسیر مشخّص شده پوشه نیست، یا از قبل پرونده‌های اسفینکس وجود داشته‌اند."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
-msgstr ""
+msgstr "ابزار شروع سریع اسفینکس فقط یک پوشه‌ی خالی درست می کند. لطفاً یک مسیر ریشه‌ی جدید مشخّص کنید."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
-msgstr ""
+msgstr "متغیرهای نامعتبرقالب؛ %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr ""
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr "غیرفاصله‌ در فرآیند حذف فاصله‌ از ابتدای سطر حذف شد"
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
-msgstr ""
+msgstr "برچسب نامعتبر:%s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
-msgstr ""
+msgstr "شماره‌ی سطر مشخّص شده خارج از بازه‌ی (1-%d) است: %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
-msgstr ""
+msgstr "امکان استفاده از هر دوی %sو%s نیست"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
-msgstr ""
+msgstr "پرونده‌ی گنجانده شده %r یا پیدا نشد و یا خواندن آن شکست خورد"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
-msgstr ""
+msgstr "کدگذاری %r که باری خواندن پرونده‌ی گنجانده شده‌ی %r اسفتاده شده به نظر می رسد اشتباه باشد، استفاده از گزینه‌ی کدگذاری ( :encoding:) را امتحان کنید"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
-msgstr ""
+msgstr "شیئ با نام %r در پرونده‌ی %r پیدا نشد"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
-msgstr ""
+msgstr "امکان استفاده‌ی گزینه‌ی «هم‌خوان شماره‌ی سطر» (lineno-match) با مجموعه‌ی سطرهای گسیخته وجود ندارد"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
-msgstr ""
+msgstr "سطر مشخّص شده %r: هیچ سطری از پرونده‌ی گنجانده شده %r بیرون کشیده نشده"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
-msgstr ":نویسنده این بخش"
+msgstr "نویسنده این بخش: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
-msgstr "نویسنده این ماژول:"
+msgstr "نویسنده این ماژول: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
-msgstr ""
+msgstr "نویسنده ی کد: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
-msgstr ":نویسنده"
+msgstr "نویسنده: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr "گزینه‌ی \":file:\" برای دستورالمعل جدول داده‌های جداشده با کاما (csv-table) حالا دیگر مسیر ثابت را یک مسیر نسبی از شاخه‌ی منبع در نظر می گیرد. لطفاُ سندتان را به روز رسانی کنید."
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
-msgstr ""
+msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr "اعلان C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. c:%s:: %s' است."
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "پارامترها"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
-msgstr ""
+msgstr "بازگشت ها"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "نوع برگشتی"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C تابع)"
+msgid "%s (C %s)"
+msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C عضو)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "عضو"
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C ماکرو)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "متغیّر"
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C نوع)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
+msgstr "تابع"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C متغیر)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
+msgstr "ماکرو"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
-msgstr ""
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr "ساختار"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr ""
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "اجتماع"
 
-#: sphinx/domains/c.py:260
-msgid "macro"
-msgstr ""
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "شمارش"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
-msgstr ""
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "شمارنده"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr ""
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
+msgstr "گونه"
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
-msgstr ""
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr "مؤلّفه‌ی تابع"
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "جدید در نسخه %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "تغییر داده شده در نسخه %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "منسوخ شده از نسخه %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
-msgstr ""
+msgstr "نقل‌قول %s تکراری، مورد دیگر در %s قرار دارد"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
-msgstr ""
+msgstr "نقل [%s] قول ارجاع داده نشده."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr ""
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr "اعلان ++C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. cpp:%s:: %s' است."
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
-msgstr ""
+msgstr "پارامترهای قالب"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
-msgstr ""
+msgstr "ایجاد"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
-msgstr ""
+msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
-msgstr ""
+msgstr "کلاس"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
+msgstr "کانسپت"
 
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr ""
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr "مؤلّفه‌ی قالب"
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (توابع درونی)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s متد)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
-msgstr ""
+msgstr "%s (کلاس)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
-msgstr ""
+msgstr "%s (متغیّر عمومی یا مقدار ثابت)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s مشخصه)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
-msgstr ""
+msgstr "نشانوندها"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (ماژول)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
-msgstr ""
+msgstr "متد"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
-msgstr ""
+msgstr "داده"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
-msgstr ""
+msgstr "مشخّصه"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "ماژول"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
-msgstr ""
+msgstr "توضیح %s تکراری از %s، مورد دیگر%s در %s قرار دارد"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
-msgstr ""
+msgstr "بر چسب معادله ی %s تکرار است، مورد دیگر در %s قرار دارد"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
-msgstr ""
+msgstr "قالب مرجع معادله‌‌ی ریاضی (math_eqref_format) نامعتبر: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "کلمه کلیدی"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "عملگر"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "شیء"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
-msgstr "استثناء"
+msgstr "ایراد"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "گذاره"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "توابع درونی"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
-msgstr ""
+msgstr "متغیر ها"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "برانگیختن"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (در ماژول %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (متغیر درونی)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (در ماژول %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (متغیر درونی)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (کلاس درونی)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (کلاس در %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s متد)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s شگرد کلاس)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s متد استاتیک)"
+msgid "%s() (%s property)"
+msgstr "%s()(%s ویژگی)"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s متد استاتیک)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s مشخصه)"
-
-#: sphinx/domains/python.py:709
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s property)"
-msgstr ""
+msgid "%s (%s property)"
+msgstr "%s(%sویژگی)"
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
-msgstr ""
+msgstr "نمایه ی ماژول های پایتون"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "ماژول ها"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "منسوخ شده"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
-msgstr ""
+msgstr "class method"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
-msgstr ""
+msgstr "متد استاتیک"
+
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr "ویژگی"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
-msgstr ""
+msgstr "توضیح تکراری شیئ %s، نمونه‌ی دیگر در %s قرار دارد، برای یک مورد از :noindex: استفاده کنید"
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
-msgstr ""
+msgstr "برای ارجاع متقابل %r بیش از یک هدف پیدا شد: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
-msgstr ""
+msgstr " (منسوخ)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
-msgstr ""
+msgstr "%s (دستورالمعل)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
-msgstr ""
+msgstr "%s (گزینه‌ی دستورالمعل)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
-msgstr ""
+msgstr "%s (نقش)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
-msgstr ""
+msgstr "دستورالمعل"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
-msgstr ""
+msgstr "گزینه‌ی دستورالمعل"
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
-msgstr ""
+msgstr "نقش"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
-msgstr ""
+msgstr "توضیح تکراری از %s %s، مورد دیگر در %s قرار دارد"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
-msgstr "%s متغیرهای عمومی؛"
+msgstr "متغیرهای عمومی؛ %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
-msgstr ""
+msgstr "توضیح بدشکل برای گزینه‌ی %r، باید شبیه این‌ها باشد \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" یا \"+opt args\""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
-msgstr ""
+msgstr "%s گزینه‌ی خط فرمان"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
-msgstr ""
+msgstr "گزینه خط فرمان"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
-msgstr ""
+msgstr "یک خط خالی باید پیش از اصطلاح واژه‌نامه باشد"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
-msgstr ""
+msgstr "اصطلاحات واژه‌نامه نباید با خطوط خالی از هم جدا شوند"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
-msgstr ""
+msgstr "به نظر می رسد واژه‌نامه اشتباه شکل داده شده است، فاصله‌گذاری از ابتدای سطر را بررسی کنید"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
-msgstr ""
+msgstr "اصطلاح واژه‌نامه"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
-msgstr ""
+msgstr "نشانه ی گرامری"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
-msgstr ""
+msgstr "برچسب ارجاع"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
-msgstr ""
+msgstr "متغیّر عمومی"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
-msgstr ""
+msgstr "اختیارات برنامه"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
-msgstr ""
+msgstr "سند"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "فهرست ماژول ها"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "صفحه جستجو"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
-msgstr ""
+msgstr "بر چسب تکراری %s، مورد دیگر در %s قرار دارد"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
-msgstr ""
+msgstr "تکرار توضیح %s از %s، مورد دیگر در%s قرار دارد"
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
-msgstr ""
+msgstr "شماره‌ی شکل غیر فعّال است. گزینه‌ی :numref: نادیده گرفته می‌شود."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr ""
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr "شکست در ایجاد ارجاع متقابل. هیچ شماره انتساب داده نشده: %s"
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
-msgstr ""
+msgstr "پیوند هیچ برچسبی ندارد: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
-msgstr ""
+msgstr "قالب شماره‌ی شکل نامعتبر: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
-msgstr ""
+msgstr "قالب شماره‌ی شکل نامعتبر:  %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr "برچشب تعریف نشده:  %s"
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr "شکست در ایجاد ارجاع متقابل. عنوان یا زیرنویس پیدا نشد: %s"
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
-msgstr ""
+msgstr "پیکربندی جدید"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
-msgstr ""
+msgstr "پیکربندی تغییر داده شد"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
-msgstr ""
+msgstr "افزونه‌ها تغییر کردند"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
-msgstr ""
+msgstr "نسخه‌ی محیط ساخت به‌روز نیست"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
-msgstr ""
+msgstr "شاخه ی منبع تغییر کرد"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
-msgstr ""
+msgstr "این محیط با سازنده‌ی انتخاب شده سازگار نیست، لطفاً یک خوشه‌ی اسناد دیگری را انتخاب کنید."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
-msgstr ""
+msgstr "پویش اسناد %s: %r شکست خورد"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
-msgstr ""
+msgstr "دامنه ی %s ثبت نشده"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
-msgstr ""
+msgstr "درختواره‌ی فهرست مطالب با ارجاع به خود پیدا شده. نادیده گرفته می‌شود."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
-msgstr ""
+msgstr "سند در هیچ درختواره‌ی فهرست مطالبی گنجانده نشده"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
-msgstr ""
+msgstr "%s را ببینید"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
-msgstr ""
+msgstr "%s را هم ببینید"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
-msgstr ""
+msgstr "نوع ناشناخته مدخل نمایه %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
-msgstr ""
+msgstr "نماد ها"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
-msgstr ""
+msgstr "دور تسلسل در درختواره‌ی ارجاعات فهرست مطالب تشخیص داده شده، نادیده گرفته می‌شوند: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
-msgstr ""
+msgstr "فهرست مطالب دارای ارجاع به سند %r است که عنوانی ندارد: هیچ پیوندی تولید نخواهد شد"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
-msgstr ""
+msgstr "درختواره‌ی فهرست مطالب ارجاعی به سند کنار گذاشته شده %r را دارد"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
-msgstr ""
+msgstr "فهرست مطالب شامل ارجاع به سند ناموجود %r است"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
-msgstr ""
+msgstr "پرونده‌ی تصویر خوانا نیست: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
-msgstr ""
+msgstr "پرونده‌ی عکس  %s خوانا نیست:  %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
-msgstr ""
+msgstr "پرونده‌ی دریافت شده خوانا نیست: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
-msgstr ""
+msgstr "شماره‌ی قسمت‌ها پیش‌تر به %s نسبت داده شده ( آیا درختواره‌ی فهرست مطالب شماره‌گذاری تو در تو دارد؟)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
-msgstr ""
+msgstr "پرونده‌ی %s را می سازد."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2382,185 +2408,205 @@ msgid ""
 "excluded from generation.\n"
 "\n"
 "Note: By default this script will not overwrite already created files."
-msgstr ""
+msgstr "\nبه صورت بازگشتی در مسیر <MODULE_PATH> دنبال پیمانه‌هاو بسته‌های پایتون بگرد و \nبا به ازای دستورالمعل‌های خودکار پیمانه‌ی هر بسته در مسیر خروجی <OUTPUT_PATH> یک پرونده‌ی reST بساز.\n\nالگوی استثتاء های <EXCLUDE_PATTERN> می‌تواند الگوی پرونده‌ها و یا شاخه‌هایی باشد که از تولید کنار گذاشته شده‌اند.\n\nتوجّه: به صورت پیش فرض این اسکریپت روی پرونده‌های از پیش ساخته شده دوباره نویسی نمی‌کند."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
-msgstr ""
+msgstr "مسیر پیمانه به سند"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
-msgstr ""
+msgstr "الگوها‌ی به سبک fnmatch در پرونده و یا شاخه برای کنار گذاشتن از تولید"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
-msgstr ""
+msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
-msgstr ""
+msgstr "نهایت عمق زیر پیمانه‌ها برای نشان دادن در فهرست مطالب (پیش‌گزیده: ۴)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
-msgstr ""
+msgstr "بازنویسی پرونده‌های موجود"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
-msgstr ""
+msgstr "ردگیری پیوند نمادین. وقتی با collective.recipe.omelette ترکیب می‌شود توانمند است."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
-msgstr ""
+msgstr "اجرای اسکریپت بدون ساخت پرونده"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
-msgstr ""
+msgstr "قرار دادن مستندات هر پیمانه در صفحه‌ی خودش"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
-msgstr ""
+msgstr "در برداشتن پیمانه‌های «خصوصی»(_private)"
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
-msgstr ""
+msgstr "نام پرونده فهرست مطالب (پیش‌گزیده: پیمانه‌ها)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
-msgstr ""
+msgstr "پرونده‌ی فهرست مطالب را ایجاد نکن"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
-msgstr ""
+msgstr "برای بسته‌ها و پیمانه‌ها سربرگ نساز (مثلاً وقتی رشته‌متن‌های مستندات از قبل آن‌ها را داشته باشند)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
-msgstr ""
+msgstr "قرار دادن مستندات پیمانه پیش از مستندات پیمانه‌ی زیرمجموعه‌‌اش"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
-msgstr ""
+msgstr "تفسیر مسیرهای پیمانه بر اساس ویژگی‌های ضمنی فضای نام‌ها در PEP -0420"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
-msgstr ""
+msgstr "پسوند پرونده ( پیش فرض: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
-msgstr ""
+msgstr "تولید یک پروژه‌ی کامل با ابزار شروع سریع اسفینکس"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
-msgstr ""
+msgstr "پیوست مسیر پیمانه (module_path) به مسیر سیستم (sys.path)، هنگامی به کار می‌رود که گزینه‌ی full-- داده شود"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
-msgstr ""
+msgstr "نام پروژه (پیش‌گزیده: نام پیمانه‌ی ریشه)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
-msgstr ""
+msgstr "نویسنده(های) پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
-msgstr ""
+msgstr "نسخه‌ی پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
-msgstr ""
+msgstr "نگارش پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود، پیش‌گزیده همان شماره‌ی نسخه (--doc-version) است"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
-msgstr ""
+msgstr "گزینه های افزونه"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
-msgstr ""
+msgstr "%s شاخه نیست."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
-msgstr ""
+msgstr "عبارت باقاعده‌ی نامعتبر %r در %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
-msgstr ""
+msgstr "آزمودن پوشش  منابع پایان یافت، به نتایج در %(outdir)spython.txt نگاهی بیاندازید."
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
-msgstr ""
+msgstr "عبارات باقاعده‌ی نامعتبر %r در پوشش عبارت باقاعده‌ی زبان سی (coverage_c_regexes)"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr "رابط برنامه‌نویسی مستند نشده‌ی C: %s [%s] در پرونده‌ی %s"
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
-msgstr ""
+msgstr "امکان وارد کردن پیمانه‎ی %s نبود: %s"
+
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr "تابع پایتونی بدون مستندات: %s :: %s"
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr "کلاس مستندسازی نشده‌ی پایتون: %s :: %s"
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr "شگرد مستندسازی نشده‌ی پایتون: %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
-msgstr ""
+msgstr "فاقد «+» یا «-» در گزینه‌ی '%s'."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
-msgstr ""
+msgstr "\"%s\" یک گزینه‌ی معتبر نیست."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
-msgstr ""
+msgstr "'%s' یک گزینه‌ی معتبر نسخه‌ی پایتون (pyversion) نیست"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
-msgstr ""
+msgstr "نوع TestCode  نامعتبر"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
-msgstr ""
+msgstr "آزمایش مستندات منابع به پایان رسید، به نتایج در %(outdir)s/output.txt نگاهی بیاندازید."
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
-msgstr ""
+msgstr "بدون کد/خروجی در تکّه‌ی %s در %s:%s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
-msgstr ""
+msgstr "نادیده گرفتن کد پیمانه‌ی doctest : %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
-msgstr ""
+msgstr "====================== کند ترین زمان خواندن ======================="
 
 #: sphinx/ext/graphviz.py:132
 msgid "Graphviz directive cannot have both content and a filename argument"
-msgstr ""
+msgstr "دستورالعمل Graphviz نمی تواند هم نشانوند محتوا را داشته باشد و هم نام پرونده"
 
 #: sphinx/ext/graphviz.py:142
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
-msgstr ""
+msgstr "پرونده گنجانده شده‌ی خارجی Graphviz  %r یا پیدا نشد و یا خواندنش با شکست رو به رو شد"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
-msgstr ""
+msgstr "نادیده گرفتن دستورالعمل «graphviz» بدون محتوا."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2568,16 +2614,16 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "dot  هیچ پرونده‌ی برون‌دادی تولید نکرد:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
-msgstr ""
+msgstr "فرمان dot %r نمی‌تواند اجرا شود (زیرا نیازمند برون‌داد graphviz است)، تنظیمات graphviz_dot را بررسی کنید"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2585,32 +2631,33 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "dot  با خطایی از کار افتاد:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
-msgstr ""
+msgstr "قالب خروجی graphviz باید یکی از قالب های 'png' یا  'svg' باشد ولی %r است"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
-msgstr ""
+msgstr "کد دات: %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
-msgstr ""
+msgstr "[گراف:%s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
-msgstr ""
+msgstr "[گراف:%s]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr ""
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
+msgstr "فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter بررسی کنید: %s"
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
 #, python-format
@@ -2620,255 +2667,318 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "تبدیل با خطایی از کار افتاد:\n[stderr]\n%r\n[stdout]\n%r"
+
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter را بررسی کنید"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
-msgstr ""
+msgstr "فرمان لتکس %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_latex را بررسی کنید"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
-msgstr ""
+msgstr "%sفرمان %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_%s را بررسی کنید"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
-msgstr ""
+msgstr "نمایش لتکس: %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
-msgstr ""
+msgstr "لتکس بین سطری: %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
-msgstr ""
+msgstr "پیوند ثابت به این معادله"
 
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
-msgstr ""
+msgstr "سیاهه‌ی بین اسفینکس جا به جایی را انجام داد: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
-msgstr ""
+msgstr "بارگذاری سیاهه‌ی بین اسفینکس از %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 ""
+msgstr "مشکلاتی در برخی از سیاهه‌ها به وجود آمد،ولی این مشکلات راه‌های جایگزین های داشته‌اند:"
 
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
 msgid "failed to reach any of the inventories with the following issues:"
-msgstr ""
+msgstr "شکست در رسیدن به یکی از سیاهه‌ها به خاطر مشکلات زیر:"
 
-#: sphinx/ext/intersphinx.py:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
-msgstr ""
+msgstr "(در %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
-msgstr ""
+msgstr "(در %s )"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
-msgstr ""
+msgstr "شناساگر بین اسفینکس %r رشته‌متن نیست. نادیده گرفته شد"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
-msgstr ""
+msgstr "شکست در خواندن intersphinx_mapping[%s]، نادیده گرفته می‌شود: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
-msgstr ""
+msgstr "[منبع]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "در دست انجام"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
-msgstr ""
+msgstr "مدخل فهرست اقدام پیدا شد: %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
-msgstr ""
+msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
-msgstr ""
+msgstr "(<original entry> در%s و سطر %d جای گرفته است.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
-msgstr ""
+msgstr "مدخل اصلی"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
-msgstr ""
+msgstr "برجسته کردن کد پیمانه... "
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
-msgstr ""
+msgstr "[مستندات]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
-msgstr ""
+msgstr "کد ماژول"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
-msgstr ""
+msgstr "<h1>کد منبع برای %s </h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
-msgstr ""
+msgstr "بررسی اجمالی: کد ماژول"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
-msgstr ""
+msgstr "<h1> همه‌ی پیمانه‌هایی که برایشان کد در دسترس است</h1>"
+
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr "مقدار نامعتبر برای گزینه‌ی ترتیب اعضا (member-order): %s"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
-msgstr ""
+msgstr "امضای ناشناخته‌ برای %s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
-msgstr ""
+msgstr "خطا در قالب بندی نشانوند برای %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
-msgstr ""
+msgstr "ویژگی ناموجود %s در شیئ %s"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "مستندسازی خودکار: شکست در تشخیص %r برای مستندسازی، این ایراد به وجود آمد:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
 "\"module\" or \"currentmodule\" directive in the document, or giving an "
 "explicit module name)"
-msgstr ""
+msgstr "مشخّص نیست کدام پیمانه را برای مستندسازی خودکار فراخوان کند %r (سعی کنید دستورالعمل «module» یا «currentmodule» را در سند قرار دهید، یا یک نام واضح برای پیمانه ارائه دهید)"
+
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr "خطا در قالب بندی امضا برای %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
-msgstr ""
+msgstr "\"::\"  در پیمانه‌ی خودکار معنی نمی‌دهد"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
-msgstr ""
+msgstr "نشانوند‌های امضا یا یادداشت مقدار برگشتی داده شده برای پیمانه‌ی خودکار %s"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
-msgstr ""
+msgstr "__all__ باید لیستی از رشته‌متن ها باشد، نه %r (در پیمانه‌ی %s) -- __all__ نادیده گرفته می‌شود"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr ""
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr "ویژگی نایاب در گزینه‌ی :members: قید شده: پیمانه‌ی:%s، ویژگی %s"
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr "شکست در دریافت امضای تابع برای %r: مؤلّفه پیدا نشد: %s"
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr "شکست در دریافت امضای سازنده‌ی شیئ برای %r: مؤلّفه پیدا نشد: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
-msgstr ""
+msgstr "پایه ها:%s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr ""
+msgid "alias of %s"
+msgstr "نام جانشین %s"
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr "نام جانشین نوع متغیر(%s)"
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr "شکست در دریافت امضای شگرد برای %r: مؤلّفه پیدا نشد: %s"
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr "__slots__ نامعتبر در %sیدا شد و نادیده گرفته شد."
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr "اعضای مستندسازی خودکار (autodoc_member_order) حالا دیگر ترتیب الفبایی «alphabetical» را به جای حالت منتسب به الفبا «alphabetic» می‌پذیرد. لطفاً تنظیمات خود را به روز رسانی کنید."
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr "شکست در تحلیل مقدار پیش‌گزیده‌‌ی نشانوند برای %r: %s"
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr "شکست در به روز رسانی امضا برای %r: مؤلّفه پیدا نشد: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
-msgstr ""
+msgstr "شکست در تحلیل نوع یادداشت برای %r: %s"
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
-msgstr ""
+msgstr "ارجاعات خلاصه‌ی خودکار سند %r حذف کنار گذاشته. نادیده گرفته می‌شود."
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
-msgstr ""
+msgstr "خلاصه‌ی خودکار: خرده‌پرونده‌ی %r پیدا نشد. تنظیمات تولید خلاصه‌ی خودکار(autosummary_generate) را بررسی کنید."
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr "خلاصه‌ی خودکار عنوان‌ٔار نیازمند گزینه‌ی :toctree: است، نادیده گرفته می‌شود."
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr ""
+msgid "autosummary: failed to import %s"
+msgstr "خلاصه‌ی خودکار: فراخوان %s شکست خورد"
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
-msgstr ""
+msgstr "شکست در تجزیه تحلیل نام %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
-msgstr ""
+msgstr "شکست در وارد کردن شیئ %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
-msgstr ""
+msgstr "تولید خلاصه خودکار: پرونده پیدا نشد: %s"
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
-msgstr ""
+msgstr "خلاصه‌ی خودکار به طور داخلی پرونده‌های rst را ایجاد می‌کند. ولی پسوند منبع شما شامل rst نیست. نادیده گرفته می‌شود."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "خلاصه‌ی خودکار: شکست در تشخیص %r برای مستندسازی، این ایراد به وجود آمد:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
-msgstr ""
+msgstr "[خلاصه‌ی خودکار] تولید خلاصه‌ی خودکار برای: %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
-msgstr ""
+msgstr "[خلاصه‌ی خودکار] نوشتن در %s"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
-msgstr ""
+msgstr "[خلاصه‌ی خودکار]: فراخوان %r: %s شکست خورد"
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2881,300 +2991,324 @@ msgid ""
 "``sphinx.ext.autosummary`` Python module and can be read using::\n"
 "\n"
 "  pydoc sphinx.ext.autosummary\n"
-msgstr ""
+msgstr "\nتولید ReStructuredText با استفاده از دستورالعمل‌های خلاصه‌ی خودکار.\n\nخودکارساز اسفینکس رابط کابر پسندی برای sphinx.ext.autosummary.generate (پیمانه‌ی افزونه‌ی خلاصه‌ساز اسفنیکس) است.\nاین افزونه پرونده های متن reStructuredText را از دستورالعمل‌های خلاصه‌ی خودکاری تولید می‌کند که در پرونده‌های درون‌داد مشخّص شده قرار دارد.\n\nقالب دستورالعمل خلاصه‌ی خودکار درپیمانه‌ی افزونه‌ی خلاصه‌ی خودکار اسفنیکس (sphinx.ext.autosummary) مستند سازی شده می توان آن را با دستور زیر خواند::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
-msgstr ""
+msgstr "پرونده‌های منبع برای تولید پرونده‌های rST"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
-msgstr ""
+msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها در آن"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
-msgstr ""
+msgstr "پسوند پیش فرض برای پرونده‌ها (پیش‌فرض: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
-msgstr ""
+msgstr "شاخه‌ی سفارشی قالب (پیش‌گزیده: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
-msgstr ""
+msgstr "اجزای فراخوان شده‌ی سند (پیش‌گزیده: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
-msgstr ""
+msgstr "نشانوندهای کلیدی"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
-msgstr ""
+msgstr "مثال"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
-msgstr ""
+msgstr "نمونه‎ها"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
-msgstr ""
+msgstr "یادداشت‌ها"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
-msgstr ""
+msgstr "مؤلّفه‌های دیگر"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr "دریافت‌ها"
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
-msgstr ""
+msgstr "منابع"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
-msgstr ""
+msgstr "هشدارها"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
-msgstr ""
+msgstr "فرآورده"
+
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr "مقدار نامعتبر تعیین شده (بدون کمانک انتهایی): %s"
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr "مقدار نامعتبر تعیین شده (بدون کمانک ابتدایی): %s"
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول انتهایی): %s"
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول ابتدایی): %s"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "دقت"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "ملاحظه"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "خطر"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "خطا"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
-msgstr "تذکر"
+msgstr "راهنمایی"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "مهم"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "توجه"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "همچنین ملاحظه نمائید"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "نکته"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "هشدار"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
-msgstr ""
+msgstr "ادامه از صفحه‌ی قبل"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
-msgstr ""
+msgstr "ادامه در صفحه‌ی بعد"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:10
 msgid "Non-alphabetical"
-msgstr ""
+msgstr "غیر الفبایی"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:12
 msgid "Numbers"
-msgstr ""
+msgstr "شماره ها"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:13
 msgid "page"
-msgstr ""
+msgstr "صفحه"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
-msgstr ""
+msgstr "فهرست عناوین"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "جستجو"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
-msgstr "برو"
+msgstr "رفتن به"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "نمایش سورس"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "بررسی اجمالی"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
-msgstr ""
+msgstr "خوش آمدید! این"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
-msgstr ""
+msgstr "مستندات برای"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
-msgstr ""
+msgstr "آخرین بروزرسانی"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
-msgstr "ایندکس ها و جداول:"
+msgstr "نمایه‌ها و جدول‌ها:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "فهرست کامل مطالب"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "فهرست تمامی بخش ها و زیر مجموعه ها"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "جستجو در این اسناد"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "فهرست کلی ماژول ها"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "دسترسی سریع به تمامی متدها"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "تمامی توابع ، کلاس ها ، اصطلاحات"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "فهرست &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "فهرست کامل در یک صفحه"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "فهرست صفحات بر اساس حروف"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
-msgstr ""
+msgstr "ممکن است سترگ باشد"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "ناوبری"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "جستجو در %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "درباره این مستندات"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
-msgstr "کپی رایت"
+msgstr "حق انتشار"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
-msgstr ""
+msgstr "&#169; <a href=\"%(path)s\">حق نشر</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
-msgstr ""
+msgstr "&#169; حق نشر%(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
-msgstr ". %(last_updated)s  آخرین بروز رسانی در"
+msgstr "آخرین بروز رسانی در %(last_updated)s ."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr ". <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s ایجاد شده با"
+msgstr "ایجاد شده با<a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "جستجو %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "موضوع قبلی"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "فصل قبلی"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "موضوع  بعدی"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "فصل بعدی"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
-msgstr ""
+msgstr "لطفاً برای فعّال کردن کارکرد جستجو\nجاوا اسکریپت را فعّال کنید."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
-msgstr ""
+msgstr "در حال جستجو برای چندین واژه. فقط واژگانی را نشان می‌دهد که شامل این موارد باشد:\n    همه‌ی کلمه‌ها."
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "جستجو"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "نتایج جستجو"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
-msgstr ""
+msgstr "جستجوی شما با هیچ سندی هم خوانی نداشت. لطفاً اطمینان حاصل کنید که همه ی واژه ها املای درستی دارند و دسته بندی های کافی را انتخاب کرده اید."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "جستجو سریع"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "صفحه فعلی"
 
@@ -3182,12 +3316,12 @@ msgstr "صفحه فعلی"
 #: sphinx/themes/basic/changes/versionchanges.html:12
 #, python-format
 msgid "Changes in Version %(version)s &#8212; %(docstitle)s"
-msgstr ""
+msgstr "تغییرات در نسخه %(version)s &#8212; %(docstitle)s"
 
 #: sphinx/themes/basic/changes/rstsource.html:5
 #, python-format
 msgid "%(filename)s &#8212; %(docstitle)s"
-msgstr ""
+msgstr "%(filename)s &#8212; %(docstitle)s"
 
 #: sphinx/themes/basic/changes/versionchanges.html:17
 #, python-format
@@ -3206,260 +3340,268 @@ msgstr "C API تغییرات"
 msgid "Other changes"
 msgstr "دگر تغییرات"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
-msgstr "لینک ثابت به این سر مقاله"
+msgstr "پیوند ثابت به این سر مقاله"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
-msgstr "لینک ثابت به این تعریف"
+msgstr "پیوند ثابت به این تعریف"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "عدم نمایش نتایج یافت شده"
 
 #: sphinx/themes/basic/static/searchtools.js:136
 msgid "Searching"
-msgstr ""
+msgstr "در حال جست و جو"
 
 #: sphinx/themes/basic/static/searchtools.js:141
 msgid "Preparing search..."
-msgstr ""
+msgstr "آماده سازی جست و جو..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
+msgstr "جستجو پایان یافت و %sصفحه نتایج مطابق جستار پیدا شدن."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
-msgstr ""
+msgstr "، در "
 
 #: sphinx/themes/classic/static/sidebar.js_t:83
 msgid "Expand sidebar"
-msgstr ""
+msgstr "گسترش نوار کناره"
 
 #: sphinx/themes/classic/static/sidebar.js_t:96
 #: sphinx/themes/classic/static/sidebar.js_t:124
 msgid "Collapse sidebar"
-msgstr ""
+msgstr "تا کردن نوار کناره"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
-msgstr ""
+msgstr "محتوا ها"
 
 #: sphinx/transforms/__init__.py:224
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
-msgstr ""
+msgstr "نمایه‌ای بر پایه‌ی ۴ ستون پیدا شد. شاید یک اشکال برنامه‌نویسی از افزونه‌هایی که استفاده می‌کنید باشد: %r"
 
 #: sphinx/transforms/__init__.py:263
 #, python-format
 msgid "Footnote [%s] is not referenced."
-msgstr ""
+msgstr "پانویس [%s] ارجاع داده نشده است."
 
 #: sphinx/transforms/__init__.py:269
 msgid "Footnote [#] is not referenced."
-msgstr ""
+msgstr "پانویس [#] ارجاع داده نشده است."
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
-msgstr ""
+msgstr "ارجاعات پانویس ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
-msgstr ""
+msgstr "ارجاعات ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
-msgstr ""
+msgstr "ارجاعات نقل قول ادبی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
-msgstr ""
+msgstr "ارجاعات اصطلاحی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}"
+
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr "امکان تشخیص متن جایگزین برای ارجاع متقابل نبود. شاید یک اشکال برنامه نویسی باشد."
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
-msgstr ""
+msgstr "برای «هر» ارجاع متقابل بیشتر از یک هفد پیدا شد: %r شاید %s باشد"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr ""
+msgid "%s:%s reference target not found: %s"
+msgstr "%s:%s  مرجع هدف پیدا نشد: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr ""
+msgid "%r reference target not found: %s"
+msgstr "مقصد ارجاع %r پیدا نشد %s"
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
-msgstr ""
+msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
-msgstr ""
+msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
-msgstr ""
+msgstr "قالب تصویر ناشناخته: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
-msgstr ""
+msgstr "نویسه‌ی منبع غیرقابل رمزگشایی، جایگزین با «؟» : %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
-msgstr ""
+msgstr "رد شدن و نادیده انگاشتن"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
-msgstr ""
+msgstr "شکست خورد"
+
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr "نام نقش یا دستورالعمل ناشناخته: %s:%s"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
-msgstr ""
+msgstr "خطای خواندن: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
-msgstr ""
+msgstr "خطای نوشتن: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
-msgstr ""
+msgstr "قالب تاریخ ناشناخته. اگر می‌خواهید از رشته‌متن مستقیماً خروجی بگیرید، آن را با نقل قول رشته‌متنی محصور کنید: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
-msgstr ""
+msgstr "درختواره‌ی فهرست مطالب شامل ارجاع به پرونده ناموجود %r است"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
-msgstr ""
-
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
+msgstr "ایراد در هنگام ارزیابی تنها عبارت دستور العمل: %s"
 
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
-msgstr ""
+msgstr "نقش پیش‌فرض %s یافت نشد"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
-msgstr ""
+msgstr "قالب عدد شکل برای %s تعریف نشده"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
-msgstr ""
+msgstr "هر کدام از شناسه‌هایی که به بست %s اختصاص داده نشده"
+
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr "پیوند ثابت به این اصطلاح"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
-msgstr ""
+msgstr "پیوند ثابت به این جدول"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
-msgstr ""
+msgstr "پیوند ثابت به این کد"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
-msgstr ""
+msgstr "پیوند ثابت به این تصویر"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
-msgstr ""
+msgstr "پیوند ثابت به این فهرست عنوان ها"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
-msgstr ""
+msgstr "امکان دست یابی به اندازه‌ی عکس نبود. گزینه‌ی تغییر اندازه :scale: نادیده گرفته می‌شود."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
-msgstr ""
+msgstr "قسمت‌بندی رده‌بالای %r ناشناخته برای کلاس %r"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
-msgstr ""
+msgstr "مقدار بسیار بزرگ :maxdepth:، نادیده گرفته شد."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
-msgstr ""
+msgstr "عنوان سند یک بست متنی نیست"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
-msgstr ""
+msgstr "به بست عنوانی برخورد که در قسمت، موضوع، جدول، اندرز یا نوارکناری نبود"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
-msgstr ""
+msgstr "پانویس ها"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
-msgstr ""
+msgstr "هر دو مقدار tabularcolumns و :widths: داده شده، بنابراین :widths: حذف می شود."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
-msgstr ""
+msgstr "ابعاد واحد %sنامعتبر است و نادیده گرفته شد."
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
-msgstr ""
+msgstr "نوع ناشناخته مدخل نمایه%s پیدا شد"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
-msgstr ""
+msgstr "[تصویر%s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
-msgstr ""
+msgstr "[تصویر]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
-msgstr ""
+msgstr "عنوان درون شکل نیست."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
-msgstr ""
+msgstr "بست به کار نرفته: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
-msgstr ""
+msgstr "بست از نوع ناشناخته: %r"
diff --git a/sphinx/locale/fi/LC_MESSAGES/sphinx.po b/sphinx/locale/fi/LC_MESSAGES/sphinx.po
index 6e18d601af6..349631d4067 100644
--- a/sphinx/locale/fi/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/fi/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2009
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Finnish (http://www.transifex.com/sphinx-doc/sphinx-1/language/fi/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: fi\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Moduulitaso"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d.%m.%Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Yleinen sisällysluettelo"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "hakemisto"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr ">"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "<"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Sisällysluettelo"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Luvun kirjoittaja: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Moduulin kirjoittaja: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Tekijä: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Uusi versiossa %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Muutettu versiossa %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Poistettu versiosta %s alkaen"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (moduuli)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "moduuli"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduulit"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Poistettu"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (poistettu)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Moduuli sisällysluettelo"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Etsi sivu"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Tehtävä vielä"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Huom"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Varoitus"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Vaara"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Virhe"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Vihje"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Tärkeä"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Muista"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Katso myös"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Vihje"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Varoitus"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,124 +3131,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Etsi"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Siirry"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Näytä lähdekoodina"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Yhteenveto"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Yleinen moduulien sisällysluettelo"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Hakemisto yhtenä luettelona"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Hakemisto aakkostus sivuttain"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "voi olla iso"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navikointi"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Tietoja tästä documentistä"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3127,55 +3257,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "<<"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "<<"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ">>"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ">>"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Javascript pitää olla sallittu, jotta etsintä toimii."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "etsi"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Etsinnän tulos"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Pikahaku"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Tämä sivu"
 
@@ -3207,19 +3337,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Piilota löydetyt"
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/fr/LC_MESSAGES/sphinx.po b/sphinx/locale/fr/LC_MESSAGES/sphinx.po
index 740e9ba702c..3ed83abfb7d 100644
--- a/sphinx/locale/fr/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/fr/LC_MESSAGES/sphinx.po
@@ -1,168 +1,176 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
+# ABOU SAMRA Jean <jean@abou-samra.fr>, 2020
+# Adam Levine <adam.l.levine@gmail.com>, 2020
 # Christophe CHAUVET <christophe.chauvet@gmail.com>, 2017
 # Christophe CHAUVET <christophe.chauvet@gmail.com>, 2013,2015
 # cyrille gachot <cyrille.gachot@smile.fr>, 2019
 # Larlet David <david@larlet.fr>, 2008
+# Denis Bitouzé <dbitouze@wanadoo.fr>, 2020-2021
 # fgallaire <fgallaire@gmail.com>, 2010
 # fgallaire <fgallaire@gmail.com>, 2010
-# François Poirotte <clicky@erebot.net>, 2016-2017
+# François Poirotte <clicky@erebot.net>, 2016-2017,2020
 # Georg Brandl <g.brandl@gmx.net>, 2014
 # Jean-Daniel Browne <jeandaniel.browne@gmail.com>, 2010
 # Jean-François B. <jfbu@free.fr>, 2017-2019
 # Julien Palard <github@mandark.fr>, 2017
 # Julien Malard <julien.malard@mail.mcgill.ca>, 2019
-# Kim Sylvestre <kim.sylvestre@gmail.com>, 2019
+# Kim S. <kim.sylvestre@gmail.com>, 2019
 # Larlet David <david@larlet.fr>, 2008
 # LAURENT Raphaël <laurent@ined.fr>, 2018-2019
-# Lilian Besson <inactive+Naereen@transifex.com>, 2013-2014
+# 751bad527461b9b1a5628371fac587ce_51f5b30 <748bb51e7ee5d7c2fa68b9a5e88dc8fb_87395>, 2013-2014
 # Nikolaj van Omme <nikolaj.van.omme@gmail.com>, 2014-2015
 # Olivier Bonaventure <bonaventure@acm.org>, 2019
 # Pierre Grépon <pgrepon@yahoo.fr>, 2016
 # Sebastien Douche <sdouche@gmail.com>, 2008
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016,2020
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016,2020
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-22 14:28+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 17:14+0000\n"
+"Last-Translator: Denis Bitouzé <dbitouze@wanadoo.fr>\n"
 "Language-Team: French (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: fr\n"
 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
-msgstr "Le répertoire de configuration ne contient pas de fichier conf.py (%s)"
+msgstr "Le dossier de configuration ne contient pas de fichier conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Impossible de trouver le répertoire source (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr "Le répertoire de sortie (%s) n'est pas un répertoire"
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
-msgstr "Les répertoires source et destination ne doivent pas être identiques."
+msgstr "Les dossiers source et destination ne doivent pas être identiques"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s en cours d'exécution"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr ""
+msgstr "Pour des raisons de sécurité, le mode parallèle est désactivé sur macOS et python3.8 et plus. Pour plus de détails, veuillez lire https://github.com/sphinx-doc/sphinx/issues/6803"
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Ce projet nécessite au minimum Sphinx v%s et ne peut donc être construit avec cette version."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
-msgstr "création du répertoire de sortie"
+msgstr "création du dossier de destinataire"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "lors de l'initialisation de l'extension %s :"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' tel que défini dans conf.py n'est pas un objet Python appelable. Veuillez modifier sa définition pour en faire une fonction appelable. Ceci est nécessaire pour que conf.py se comporte comme une extension Sphinx."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
-msgstr "Chargement des traductions [%s]... "
+msgstr "chargement des traductions [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "fait"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "traductions indisponibles"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
-msgstr "chargement de l'environnement pickled"
+msgstr "Chargement de l'environnement pickled"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "échec : %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Aucun constructeur sélectionné, utilisation du défaut : html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "a réussi"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "s'est terminée avec des problèmes"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
-msgstr ""
+msgstr "La compilation %s, %s avertissement (avec les avertissements considérés comme des erreurs)."
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
-msgstr ""
+msgstr "La compilation %s, %s avertissements (avec les avertissements considérés comme des erreurs)."
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
-msgstr "la compilation %s, %s avertissement."
+msgstr "La compilation %s, %s avertissement."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
-msgstr ""
+msgstr "La compilation %s, %s avertissements."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
-msgstr "la compilation %s."
+msgstr "La compilation %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
-msgstr "La classe de nœud %r est déjà enregistrée, ses visiteurs seront écrasés"
+msgstr "la classe de nœud %r est déjà enregistrée, ses visiteurs seront écrasés"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
-msgstr "La directive %r est déjà enregistrée, elle sera écrasée"
+msgstr "la directive %r est déjà enregistrée, elle sera écrasée"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
-msgstr "Le rôle %r est déjà enregistré, il sera écrasé"
+msgstr "le rôle %r est déjà enregistré, il sera écrasé"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -170,12 +178,12 @@ msgid ""
 "explicit"
 msgstr "l’extension %s ne se déclare pas compatible à la lecture en parallèle, on supposera qu’elle ne l'est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
-msgstr ""
+msgstr "l'extension %s n'est pas compatible avec les lectures parallèles"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -183,117 +191,110 @@ msgid ""
 "explicit"
 msgstr "l’extension %s ne se déclare pas compatible à l’écriture en parallèle, on supposera qu’elle ne l’est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
-msgstr ""
+msgstr "l'extension %s n'est pas compatible avec les écritures parallèles"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
-msgstr "serialisation en cours %s"
+msgstr "sérialisation en cours %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "impossible d'écraser le dictionnaire de configuration %r ; ignoré (utilisez %r pour modifier les éléments individuellement)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "nombre non valide %r pour l'option de configuration %r ; ignoré"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "impossible de remplacer le paramètre de configuration %r par un type non-supporté ; ignoré"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "paramètre de configuration %r inconnu dans override ; ignoré"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Option de configuration inexistante : %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "L'option de configuration %r est déjà présente"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
-msgstr "Il y a une erreur de syntaxe dans votre fichier de configuration : %s\n"
+msgstr "Votre fichier de configuration comporte une erreur de syntaxe : %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Le fichier de configuration (ou un des modules qu'il utilise) génère un sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
 "\n"
 "%s"
-msgstr "Il y a une erreur de programmation dans votre fichier de configuration : 1%s"
+msgstr "Votre fichier de configuration comporte une erreur de programmation : \n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
-msgstr "Le paramètre `source_suffix` s'attend à recevoir une chaîne de caractères, une liste de chaînes de caractères ou un dictionnaire. Mais vous avez fourni un `%r`."
+msgstr "Le paramètre « source_suffix » s'attend à recevoir une chaîne de caractères, une liste de chaînes de caractères ou un dictionnaire. Mais vous avez fourni un « %r »."
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Section %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tableau %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Code source %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
-msgstr "La valeur saisie `{current}` est erronée, la valeur de configuration `{name}` doit figurer dans {candidates}, "
+msgstr "La valeur « {current} » du paramètre « {name} » ne figure pas dans la liste des possibilités valables « {candidates} »."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
-msgstr "Le paramètre de configuration `{name}' est de type `{current.__name__}'; le type attendu est {permitted}."
+msgstr "Le type du paramètre de configuration « {name} » doit être {permitted} et non « {current.__name__} »."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
-msgstr "Le paramètre de configuration `{name}' a pour type `{current.__name__}', tandis que le type par défaut est `{default.__name__}'. "
-
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "La valeur du paramètre %r est une chaîne de caractères non-ASCII. Cela peut conduire à des erreurs Unicode. Veuillez utiliser une chaîne Unicode, par exemple %r."
+msgstr "Le paramètre de configuration « {name} » a pour type « {current.__name__} », tandis que le type par défaut est « {default.__name__} »."
 
 #: sphinx/config.py:461
 #, python-format
@@ -302,405 +303,430 @@ msgstr "primary_domain %r non trouvé; ignoré."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "Depuis la v2.0, Sphinx utilise \"index\" en tant que master_doc par défault. Merci d'ajouter \"master_doc = 'contents'\" dans votre conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr "Depuis sa version 2.0, Sphinx utilise \"index\" comme root_doc par défaut. Veuillez ajouter \"root_doc = 'contents'\" à votre conf.py."
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Évènement %r déjà présent"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nom d'évènement inconnu : %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
-msgstr "L'extension %s est exigée par le paramètre needs_extensions, mais n'est pas chargée."
+msgstr "L'extension %s  est exigée par le paramètre needs_extensions, mais n'est pas chargée."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Ce projet nécessite que l'extension %s soit au minimum en version %s et par conséquent il ne peut pas être construit avec la version chargée (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
-msgstr "Le nom du lexeur Pygments %r est inconnu"
+msgstr "Le nom du l'analyseur Pygments %r est inconnu"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "Analyse lexicale de literal_bloc impossible en \"%s\". Mise en évidence annulée."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
-msgstr "document non lisible, il sera ignoré"
+msgstr "document illisible, il sera ignoré."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "La classe Builder %s n'a pas d'attribut « name »"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Le constructeur %r existe déjà (dans le module %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Le nom de Constructeur %s n'est ni enregistré ni accessible par point d'entrée"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
-msgstr "domaine %s non enregistré"
+msgstr "Constructeur %s non enregistré"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "domaine %s déjà enregistré"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
-msgstr "domaine 1%s non encore enregistré"
+msgstr "domaine 1%s pas encore enregistré"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "La directive %r est déjà enregistrée sur le domaine %s"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Le rôle %r est déjà enregistré sur le domaine %s"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "L'index %r est déjà enregistré sur le domaine %s"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "Le type de l'objet %r est déjà enregistré"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "Le type %r crossref_type est déjà enregistré"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "L'extension source %r est déjà enregistrée"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser pour %r est déjà enregistré"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "source_parser pour %s non enregistré"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Il existe déjà un traducteur pour %r"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "Les kwargs pour add_node() doivent être un tuple de fonction (visite, départ) : %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r est déjà enregistré"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "Le générateur de rendu mathématique %s est déjà enregistré"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "l'extension %r a été intégrée à Sphinx depuis la version %s ; cette extension est ignorée."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Exception initiale :\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
-msgstr "L'extension ne peut pas être importée %s"
+msgstr "L'extension %s ne peut pas être importée"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "l'extension %r n'a pas de fonction setup(); est-elle réellement un module d'extension de Sphinx ?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "L'extension %s utilisée par ce projet nécessite au moins Sphinx v%s ; il ne peut donc pas être construit avec la version courante."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "l'extension %r a renvoyé par sa fonction setup() un type d'objet non supporté ; elle devrait renvoyer None ou un dictionnaire de méta-données"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
-msgstr "Le thème %r n'a pas de paramètre \"theme\""
+msgstr "Le thème %r n'a pas de paramètre « theme »"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
-msgstr "Le thème %r n'a pas de paramètre \"inherit\""
+msgstr "Le thème %r n'a pas de paramètre « inherit »"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "Aucun thème nommé %r n'est trouvé, hérité de %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
-msgstr "paramètre %s.%s n'apparaît dans aucunes des configurations de thème recherchées"
+msgstr "le paramètre %s.%s n'apparaît dans aucune des configurations de thème recherchées"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "L'option %r n'est pas supportée pour ce thème"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
-msgstr "le fichier %r dans le répertoire des thèmes n'est pas valide ou ne contient aucun thème"
+msgstr "le fichier %r dans le dossier des thèmes n'est pas une archive zip valide ou ne contient aucun thème"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme n'est plus une dépendance stricte depuis la version 1.4.0. Veuillez l'installer manuellement (pip install sphinx_rtd_theme)."
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
-msgstr "Aucun thème nommé %r n'est trouvé (il manque le fichier theme.conf?)"
+msgstr "Le thème nommé %r n'a pas été trouvé (le fichier theme.conf est-il bien présent ?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
-msgstr "image appropriée pour le constructeur %s non trouvée : %s (%s)"
+msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
-msgstr "image appropriée pour le constructeur %s non trouvée : %s"
+msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
-msgstr "construction en cours [mo]:"
+msgstr "Construction en cours [mo] : "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
-msgstr "écriture... "
+msgstr "Écriture... "
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
-msgstr "tout les %d fichiers po"
+msgstr "tous les %d fichiers po"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
-msgstr "cibles pour les fichiers po %d qui sont spécifiées"
+msgstr "cibles spécifiées pour les fichiers po %d"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
-msgstr "cibles pour les fichiers po %d qui sont périmées"
+msgstr "cibles périmées pour les fichiers po %d"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "tous les fichiers source"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
-msgstr "le fichier %r saisi en ligne de commande n'est pas présent dans le répertoire source, il sera ignoré"
+msgstr "le fichier %r saisi en ligne de commande n'est pas présent dans le dossier source, il sera ignoré"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "le fichier %r saisi en ligne de commande n'existe pas, il sera ignoré"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
-msgstr "%d fichier source saisi en ligne de commande"
+msgstr "%d fichiers source saisis en ligne de commande"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
-msgstr "cibles pour les fichiers sources %d qui sont périmées"
+msgstr "cibles périmées pour les fichiers sources %d"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
-msgstr "construction [%s]:"
+msgstr "Construction [%s] : "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
-msgstr "recherche des fichiers périmés... "
+msgstr "Recherche des fichiers périmés... "
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "%d trouvé"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "aucun résultat"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
-msgstr "environnement de sérialisation"
+msgstr "Environnement de sérialisation"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
-msgstr "vérification de la cohérence"
+msgstr "Vérification de la cohérence"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
-msgstr "aucune cible n'est périmée."
+msgstr "Aucune cible n'est périmée."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
-msgstr "mise-à-jour de l'environnement :"
+msgstr "Mise à jour de l'environnement : "
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
-msgstr "%s ajouté, %s modifié, %s supprimé"
+msgstr "%s ajouté(s), %s modifié(s), %s supprimé(s)"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
-msgstr "lecture des sources... "
+msgstr "Lecture des sources... "
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "En attente des processus parallélisés..."
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "documents à écrire : %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
-msgstr "document en préparation"
+msgstr "Document en préparation"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
-msgstr "Entrée de la table des matières dupliquée trouvée: %s"
+msgstr "Entrées dupliquées de la table des matières trouvées : %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
-msgstr "copie des images... "
+msgstr "Copie des images... "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "impossible de lire le fichier image %r: il sera copié à la place"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "impossible de copier le fichier image %r: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "impossible d'écrire le fichier image %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
-msgstr "Pillow non trouvé - copie des fichiers image"
+msgstr "Pillow introuvable - copie des fichiers image"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "fichier %s en cours d'écriture..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "mimetype inconnu pour %s, il sera ignoré"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "fichier %s en cours d'écriture..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Le fichier d'aperçu se trouve dans %(outdir)s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "aucun changement dans la version %s"
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "écriture du fichier de résumé..."
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Fonctions de base"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Module"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
-msgstr "copie des fichiers sources..."
+msgstr "Copie des fichiers sources..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "impossible de lire %r pour la création du changelog"
@@ -709,160 +735,164 @@ msgstr "impossible de lire %r pour la création du changelog"
 msgid "The dummy builder generates no files."
 msgstr "Le constructeur factice ne génère aucun fichier."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Le fichier ePub se trouve dans %(outdir)s ."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "la variable de configuration \"epub_language\" (ou \"language\") ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "le paramètre de configuration \"epub_uid\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_title\" (ou \"html_title\") ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_author\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_contributor\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_description\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_publisher\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_copyright\" (ou \"copyright\") ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_identifier\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"version\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "fichier CSS invalide : %r, le fichier sera ignoré"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "La liste des messages se trouve dans %(outdir)s."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "cibles pour les modèles de fichiers %d"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "lecture des gabarits... "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "écriture des catalogues de messages... "
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Recherchez les éventuelles erreurs dans la sortie ci-dessus ou dans %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "Ancre '%s' non trouvée"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "lien mort: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "Ancre '%s' non trouvée"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Le manuel se trouve dans %(outdir)s."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "aucun valeur de configuration \"man_pages\" trouvée; aucun page du manuel ne sera enregistrée"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "enregistrement"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "le paramètre de configuration \"man_pages\" référence un document inconnu %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
-msgstr "Les pages HTML sont dans %(outdir)s ."
+msgstr "Les pages HTML sont dans %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "création du document unique"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
-msgstr "enregistrement des fichiers supplémentaires"
+msgstr "Enregistrement des fichiers supplémentaires"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Les fichiers Texinfo se trouvent dans %(outdir)s."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à makeinfo\n(ou 'make info' directement ici pour l'automatiser)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "aucun paramètre de configuration \"texinfo_documents\" trouvé: aucun document ne sera écrit"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "La valeur du paramètre \"texinfo_documents\" référence un document inconnu %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "traitement en cours %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "résolution des références..."
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(dans"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
-msgstr "copie des fichiers de support TeX"
+msgstr "Copie des fichiers de support Texinfo"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "erreur lors l'écriture du fichier Makefile : %s"
@@ -872,18 +902,18 @@ msgstr "erreur lors l'écriture du fichier Makefile : %s"
 msgid "The text files are in %(outdir)s."
 msgstr "Les fichiers texte se trouvent dans %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "erreur lors l'écriture du fichier %s : %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Les fichiers XML se trouvent dans %(outdir)s."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Le fichier pseudo-XML se trouve dans %(outdir)s."
@@ -896,292 +926,304 @@ msgstr "le fichier de configuration de construction est corrompu : %r"
 #: sphinx/builders/html/__init__.py:176
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
-msgstr "Les pages HTML sont dans %(outdir)s ."
+msgstr "Les pages HTML sont dans %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Échec de lecture du fichier de configuration de construction : %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "la variable de configuration html_use_opensearch doit maintenant être de type string"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Index général"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "suivant"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "précédent"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
-msgstr ""
+msgstr "Génération des index"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
-msgstr ""
+msgstr "écriture des pages additionnelles"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
-msgstr "copie des fichiers téléchargeables... "
+msgstr "Copie des fichiers téléchargeables... "
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "impossible de copier le fichier téléchargeable %r: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "copie des fichiers statiques... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "impossible de copier le fichier static %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
-msgstr ""
+msgstr "Copie des fichiers complémentaires"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "copie des fichiers supplémentaires impossible %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Échec d'écriture du fichier de configuration de construction : %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "L'index de recherche n'a pas pu être chargé, mais tous les documents ne seront pas construits: l'index sera incomplet."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "la page %s correspond à deux modèles dans html_sidebars: %r et %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "une erreur Unicode est survenue lors du rendu de la page %s. Veuillez vous assurer que toutes les valeurs de configuration comportant des caractères non-ASCII sont des chaînes Unicode."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Un erreur est survenue lors de la génération de la page: %s.\nLa raison est: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
-msgstr ""
+msgstr "Export de l'inventaire des objets"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
-msgstr ""
+msgstr "Export de l'index de recherche dans %s"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "le fichier js_file : %r est invalide, il sera ignoré"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Plusieurs math_renderers sont enregistrés. Mais aucun n'est sélectionné."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "math_renderer saisi %r inconnu."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "l'entrée html_extra_path %r n'existe pas"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "l'entrée html_extra_path %r se trouve à l'intérieur de outdir"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "l'entrée html_static_path %r n'existe pas"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "l'entrée html_static_path %r se trouve à l'intérieur de outdir"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "le fichier de logo %r n'existe pas"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "le fichier de favicon %r n'existe pas "
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "Documentation %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Les fichiers LaTex se trouvent dans %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à (pdf)latex\n(ou 'make latexpdf' directement ici pour l’automatiser)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "aucune valeur de configuration \"latex_documents\" trouvée; aucun document de sera généré"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "La valeur du paramètre \"latex_documents\" référence un document inconnu %s"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Version"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "Aucune option Babel disponible pour la langue %r"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
-msgstr "copie des fichiers de support TeX"
+msgstr "Copie des fichiers de support TeX"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
-msgstr "copie des fichiers de support TeX..."
+msgstr "Copie des fichiers de support TeX..."
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
-msgstr "copie de fichiers supplémentaires"
+msgstr "Copie de fichiers supplémentaires"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
+msgstr "Clé de configuration inconnue : latex_elements[%r]; ignorée."
+
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
-msgstr ""
+msgstr "%r n'a pas d'option « theme »"
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
-msgstr ""
+msgstr "%r n'a pas d'option « %s »"
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Une exception a été levée lors de la génération, démarrage du débogueur :"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
-msgstr ""
+msgstr "Interrompu !"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "Erreur de balise reST  :"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Erreur d'encodage :"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Le traceback complet a été sauvé dans %s, au cas où vous souhaiteriez signaler le problème aux développeurs."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Erreur de récursion :"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "Cela peut se produire avec des fichiers sources très volumineux ou profondément imbriqués. Vous pouvez soigneusement augmenter la limite de récursivité par défaut de Python de 1000 dans conf.py avec p. ex. :"
+msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "Une exception a été levée :"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Merci de rapporter ceci s'il s'agit d'une erreur utilisateur, afin d'améliorer le message d'erreur à l'avenir."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Un rapport d'erreur peut être déposé dans le système de tickets à <https://github.com/sphinx-doc/sphinx/issues>. Merci !"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "Le numéro du job doit être strictement positif"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Pour plus d'information : <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1198,279 +1240,273 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nCréation de la documentation à partir des fichiers sources.\n\nsphinx-build crée la documentation à partir des fichiers dans SOURCEDIR et la met\ndans OUTPUTDIR. Il prend en compte « conf.py » de SOURCEDIR pour les valeurs de\nconfiguration. L'outil « sphinx-quickstart » peut être utilisé pour créer des fichiers de\ngabarits (template), y-compris « conf.py » .\n\nsphinx-build peut créer la documentation sous différents formats. Un format est\nsélectionné par la spécification du nom du constructeur (builder) sur la ligne de commande ;\npar défault, HTML (constructeur « html »). Les constructeurs peuvent s'acquitter d'autres tâches\nrelatives à la production de la documentation.\n\nPar défaut, tout ce qui n’est pas à jour est construit. On peut restreindre le processus\nà certains fichiers spécifiques en précisant leurs noms.\n"
+msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "chemin des fichiers sources de la documentation"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "chemin du répertoire de sortie"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "une liste de fichiers spécifiques à reconstruire. Sera ignoré si l'option -a est spécifiée."
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "options générales"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "constructeur à utiliser (par defaut: HTML)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "enregistrement des tous les fichiers (par défaut : enregistrement des nouveaux fichiers et des fichiers qui ont été modifiés)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "ne pas utiliser un environnement sauvegardé, relire toujours tous les fichiers"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "chemin pour le cache d'environnement et de fichiers doctree (défaut : OUTPUTDIR/.doctrees) "
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "build parallèle avec N processus si possible (la valeur spéciale \"auto\" ajuste N à cpu-count)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "chemin dans lequel se trouve le fichier de configuration (conf.py). (valeur par défaut : identique à SOURCEDIR)."
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "n'utilisez aucun fichier de configuration, seulement l'option -D"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "outre passer un paramètre du fichier de configuration"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "passer une valeur aux templates HTML"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "définit une balise : seules les blocs \"only\" avec TAG seront inclus"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "mode sourcilleux, signale toute référence manquante"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "options de la console de sortie"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "augmenter la verbosité (peut être répété)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "aucune sortie vers stdout, seulement les avertissements vers stderr"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "aucune sortie du tout, même pas les avertissements"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "émettre une sortie de couleur (par défaut : auto-détection)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "ne pas émettre une sortie de couleur (par défaut : auto-détection)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "écrire les avertissements (et les erreurs) vers le fichier spécifié"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "modifier les avertissements en erreurs"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
-msgstr ""
+msgstr "avec -W, l'exécution se poursuit en cas d'avertissements"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "montrer le retraçage complet en cas d'exception"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "exécuter Pdb si une exception se produit."
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "fichier %r introuvable"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "impossible de combiner l'option -a avec le nom du fichier"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "impossible d'ouvrir le fichier des avertissements %r : %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "l'option -D doit être sous la forme nom=valeur"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "l'option -A doit être sous la forme nom=valeur"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "insère automatiquement les docstrings des modules"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "tester automatiquement des extraits de code dans des blocs doctest"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "lien entre la documentation Sphinx de différents projets"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "entrées \"todo\" pouvant être montrées ou cachées à la compilation"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "vérification de la couverture de la documentation"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "expressions mathématiques, traduites en images PNG ou SVG"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "expressions mathématiques, transmises dans le navigateur à MathJax"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "inclusion conditionnelle du contenu basé sur la valeur de configuration"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "inclure des liens vers le code source documenté des objets Python"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "crée un fichier .nojekyll pour publier le document sur GitHub pages"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "Merci de saisir un chemin valide."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Merci de saisir du texte."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Merci de saisir un des %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Merci de saisir 'y' ou 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Merci de saisir l'extension du fichier, par exemple '.rst' ou '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "* Note: caractères non-ASCII en entrée et l'encodage de terminal est inconnu -- UTF-8 ou Latin-1 présupposé"
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Bienvenue dans le kit de démarrage rapide de Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
-msgstr ""
+msgstr "Veuillez saisir des valeurs pour les paramètres suivants (tapez Entrée pour accepter la valeur par défaut, lorsque celle-ci est indiquée entre crochets)."
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
-msgstr ""
+msgstr "Chemin racine sélectionné : %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
-msgstr ""
+msgstr "Saisissez le répertoire racine de la documentation."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "racine de la documentation."
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Erreur : un fichier conf.py a été trouvé dans le répertoire racine."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart n'écrasera pas un projet Sphinx existant."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Merci de saisir un nouveau répertoire racine (ou tapez juste Entrée)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
-msgstr ""
+msgstr "Vous avez deux options pour l'emplacement du répertoire de construction de la sortie de Sphinx.\nSoit vous utilisez un répertoire \"_build\" dans le chemin racine, soit vous séparez les répertoires \"source\" et \"build\" dans le chemin racine."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Séparer les répertoires build et source (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
-msgstr ""
+msgstr "Dans le répertoire racine, deux autres répertoires seront créés : \"_templates\" pour les modèles HTML personnalisés et \"_static\" pour les feuilles de style personnalisées et autres fichiers statiques. Vous pouvez entrer un autre préfixe (p. ex. \".\") pour remplacer le tiret bas (\"_\")."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "Préfixe de nom pour les répertoires static et de gabarits (templates)"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
-msgstr ""
+msgstr "Le nom du projet apparaîtra à plusieurs endroits dans la documentation construite."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Nom du projet"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Nom(s) de l'auteur"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1479,15 +1515,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Version du projet"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "version du projet"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1495,115 +1531,115 @@ msgid ""
 "\n"
 "For a list of supported codes, see\n"
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
-msgstr ""
+msgstr "Si les documents doivent être rédigés dans une langue autre que l’anglais, vous pouvez sélectionner une langue ici grâce à son identifiant. Sphinx utilisera ensuite cette langue pour traduire les textes que lui-même génère.\n\nPour une liste des identifiants supportés, voir\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Langue du projet"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Extension des fichiers sources"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
 "of the documents. Normally, this is \"index\", but if your \"index\"\n"
 "document is a custom template, you can also set this to another filename."
-msgstr ""
+msgstr "Un document est particulier en ce sens qu'il est considéré comme le nœud supérieur de \"l'arbre des contenus\", c'est-à-dire la racine de la structure hiérarchique des documents. Normalement, il s'agit d'un \"index\", mais si votre \"index\" est un modèle personnalisé, vous pouvez également le définir sous un autre nom de fichier."
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Non du fichier principal (sans extension)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Erreur : le fichier principal %s est déjà présent dans le répertoire racine du projet."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart n'écrasera pas les fichiers existants."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Merci de saisir un nouveau nom de fichier, ou de renommer le fichier existant et valider avec Entrée"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Indiquer lesquelles de ces extensions Sphinx doivent être activées :"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Note : imgmath et mathjax ne peuvent pas être activés en même temps. imgmath a été désactivé."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
-msgstr ""
+msgstr "Un fichier Makefile et un fichier de commandes Windows peuvent être générés pour vous, afin que vous puissiez exécuter par exemple `make html' au lieu d'appeler directement sphinx-build."
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Création du Makefile ? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "Création du fichier de commandes Windows ? (y/n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Fichier en cours de création %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Le fichier %s existe déjà, il ne sera pas remplacé"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Terminé : la structure initiale a été créée."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
-msgstr ""
+msgstr "Vous devez maintenant compléter votre fichier principal %s et créer d'autres fichiers sources de documentation. "
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
-msgstr ""
+msgstr "Utilisez le Makefile pour construire la documentation comme ceci :\n   make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
-msgstr ""
+msgstr "Utilisez sphinx-build pour construire la documentation comme ceci : \n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
-msgstr ""
+msgstr "où « builder » est l'un des constructeurs disponibles, tel que html, latex, ou linkcheck."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1613,787 +1649,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nEngendre les fichiers requis pour un projet Sphinx.\n\nsphinx-quickstart est un outil interactif qui pose des questions à propos de votre projet et génère un répertoire avec la structure complète nécessaire ainsi qu'un Makefile qui peut être utilisé comme alternative à sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "mode silencieux"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
-msgstr ""
+msgstr "racine du projet"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "Options de structure"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "si spécifié, les répertoires source et build seront séparés"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "remplace le point dans _templates etc."
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "Options basiques du projet."
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "nom du projet"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "nom de l'auteur"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "version du projet"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "version du projet"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "langue du document"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "préfixe des fichiers source"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "nom du document principal"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "utilisé epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Options d'extension"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "autoriser l'extension %s"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "active l'emploi d'extensions quelconques"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Création des fichiers Batchfile et Makefile"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "créer un fichier makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "ne pas créer un fichier makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "créer un fichier batch"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "ne pas créer un fichier batch"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "utiliser make-mode pour Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "ne pas utiliser make-mode pour Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "Gabarits de projet"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "répertoire des templates"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "définissez une variable de template"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "vous avez spécifiez \"quit\" , mais \"project\" ou \"author\" ne sont pas spécifiés."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Erreur : le chemin spécifié n'est pas un répertoire, ou les fichiers Sphinx existent déjà."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart peut générer ces fichiers seulement dans un répertoire vide. Merci de spécifier un nouveau répertoire racine."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Variable de template invalide : %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "Contre-indentation excessive détectée"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Légende invalide: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "le numéro de ligne spécifiée est en dehors des limites (1-%d):%r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Impossible d'utiliser les options \"%s\" et \"%s\" en même temps."
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Le fichier d'include %r est introuvable ou sa lecture a échouée."
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "L’encodage %r utilisé pour lire le fichier inclus %r semble erroné, veuillez ajouter une option :encoding:"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "L'objet nommé %r est introuvable dans le fichier d'include %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "On ne peut pas utiliser \"lineno-match\" avec un \"lines\" non contigu "
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Spécification de lignes %r : aucune ligne extraite du fichier inclus %r"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Auteur de la section : "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Auteur du module : "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Auteur du code : "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Auteur : "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Paramètres"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Renvoie"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Type renvoyé"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (fonction C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (membre C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (macro C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (type C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "membre"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (variable C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variable"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "fonction"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "membre"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "union"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "énumération"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "énumérateur"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "type"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variable"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nouveau dans la version %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Modifié dans la version %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsolète depuis la version %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "citation dupliquée %s, une autre instance dans %s"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "La citation [%s] n'est pas référencée"
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "Déclaration dupliquée, également définie dans '%s'.\nLa déclaration est '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Paramètres du modèle"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Déclenche"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "classe"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "union"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "concept"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "énumération"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "énumérateur"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "déclaration dupliquée, également définie dans '%s'. Le nom de la déclaration est '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (fonction de base)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (méthode %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (classe)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variable globale ou constante)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (attribut %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Arguments"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (module)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "méthode"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "données"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "attribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "module"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
-msgstr ""
+msgstr "description de %s dupliquée pour%s; l'autre %s se trouve dans %s"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "Libellé dupliqué pour l'équation %s, autre instance dans %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "math_eqref_format invalide : %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "mot-clé"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "opérateur"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objet"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "exception"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "état"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "fonction de base"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variables"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Lève"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (dans le module %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (variable de base)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (dans le module %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (variable de base)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe de base)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (classe dans %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (méthode %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (méthode de la classe %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (méthode statique %s.%s)"
+msgid "%s() (%s property)"
+msgstr "%s() (propriété %s)"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (méthode statique %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (méthode de la classe %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (méthode de la classe %s)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (attribut %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Index des modules Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "modules"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Obsolète"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "méthode de classe"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "méthode statique"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
-msgstr ""
+msgstr "description dupliquée pour l'objet %s; l'autre instance se trouve dans %s, utilisez :noindex: sur l'une d'elles"
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "plusieurs cibles trouvées pour le renvoi %r : %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (obsolète)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directive)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
-msgstr ""
+msgstr ":%s: (option de directive)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "directive"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
-msgstr ""
+msgstr "option de directive"
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "role"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
-msgstr ""
+msgstr "description dupliquée pour %s %s; l'autre instance se trouve dans %s"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "variable d'environnement; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "description de l'option malformée, elle doit ressembler à \nMalformed option description %r, should look like \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" or \"+opt args\""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
-msgstr ""
+msgstr "option de ligne de commande %s"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
-msgstr ""
+msgstr "option de ligne de commande"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
-msgstr ""
+msgstr "le terme du glossaire doit être précédé d'une ligne vide"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
-msgstr ""
+msgstr "les termes du glossaire ne doivent pas être séparés par des lignes vides"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
-msgstr ""
+msgstr "le glossaire semble être mal formaté; vérifiez l'indentation"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "terme du glossaire"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "élément de grammaire"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "étiquette de référence"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "variable d'environnement"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "option du programme"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "document"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Index du module"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Page de recherche"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "libellé dupliqué %s, l'autre instance se trouve dans %s"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
-msgstr ""
+msgstr "description %s dupliquée pour %s; l'autre instance se trouve dans %s"
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "le paramètre numfig est désactivé : le paramètre :numref: est ignoré"
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "aucun numéro assigné pour %s : %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "le lien n'a pas de légende : %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "format de numfig_format invalide : %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "format de numfig_format invalide : %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "nouvelle configuration"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "la configuration a changé"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "les extensions ont changé"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "version non à jour de l’environnement de construction"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "le répertoire racine a changé"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Cet environnement est incompatible avec le constructeur sélectionné, veuillez choisir un autre répertoire doctree."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Échec du scan des documents dans %s : %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "le domaine %r n'est pas enregistré."
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr "une table des matières auto-référencée a été trouvée. Elle sera ignorée."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
-msgstr "Le document n'est inclut dans aucune table des matières de l'arborescence."
+msgstr "Le document n'est inclus dans aucune table des matières de l'arborescence."
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "voir %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "voir aussi %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "type d'index saisie inconnu %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symboles"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "table des matières avec une référence circulaire détectée, elle sera ignorée : %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "la table des matière contient une référence à un document %r qui n'a pas de titre : aucun lien ne sera généré"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "le toctree contient une référence à des documents exclus %r"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "la table des matière contient des références à des documents inexistants %r"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "fichier image %s illisible "
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "fichier image %s illisible : %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr "le fichier téléchargé n’est pas lisible: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s a déjà des numéros de section attribués (toctree numérotés emboîtés ?)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr "Créerait le fichier %s."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2405,168 +2430,188 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr "\nCherche récursivement dans <MODULE_PATH> des modules et packages Python et crée\ndans <OUTPUT_PATH> un fichier reST par package avec des directives automodule.\n\nLes <EXCLUDE_PATTERN>s peuvent être tout pattern de fichiers et/ou de répertoires à exclure.\n\nNote : par défaut ce script n'écrasera pas des fichiers déjà créés."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr "chemin vers le module à documenter"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "patterns de fichier fnmatch-style et/ou répertoire à exclure"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr "répertoire où placer toutes les sorties"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "Nombre maximum de sous-modules visibles dans la table des matières (par défaut : 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "remplacer les fichiers existants"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "suivre les liens symboliques. Très utile en combinaison avec collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "exécuter le script sans créer les fichiers"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr "afficher la documentation de chaque module sur sa propre page"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr "inclure le module \"_private\""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr "nom du fichier de table des matières (défaut : modules)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "ne pas créer de fichier de table des matières"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "ne pas créer de titres pour le module ou package (e.g. lorsque les doctrings en fournissent déjà)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr "mettre la documentation du module avant celle du sous-module"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interprète les chemins de module selon la spécification PEP-0420 des espaces implicites de noms"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "extension du fichier (par défaut : rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr "générer un projet complet avec sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "ajoute module_path à la fin de sys.path, utilisé lorsque --full est présent"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr "nom du projet (par défaut : nom du module principal)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr "auteur(s) du projet, utilisé quand l'option -full est précisée"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr "version du projet, utilisé quand l'option -full est précisée"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "révision du projet, utilisé lorsque --full est présent, par défaut reprend --doc-version"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "options relatives aux extensions"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s n'est pas un répertoire"
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "regex invalide %r dans %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Vérification du taux de couverture documentaire dans les sources achevée, voir les résultats dans %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "regex invalide %r dans coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "le module %s ne pas être importé : %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "option '+' ou '-' manquante dans %s."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' n'est pas une option valide."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "%s n'est pas une option pyversion valide"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "type TestCode invalide"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Exécution des doctests des sources achevée, voir les résultats dans %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "pas de code ou sortie dans le bloc %s en %s : %s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "code doctest invalide ignoré : %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
-msgstr ""
+msgstr "====================== durées de lecture les plus lentes ======================="
 
 #: sphinx/ext/graphviz.py:132
 msgid "Graphviz directive cannot have both content and a filename argument"
@@ -2577,11 +2622,11 @@ msgstr "La directive Graphviz ne peut pas avoir simultanément du contenu et un
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Fichier externe Graphviz %r non trouvé ou échec de sa lecture"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Directive « graphviz » sans contenu ignorée."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2591,14 +2636,14 @@ msgid ""
 "%r"
 msgstr "dot n'a pas produit de fichier de sortie : \n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "la commande dot %r ne peut pas être exécutée (nécessaire pour le rendu graphviz). Vérifiez le paramètre graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2608,29 +2653,30 @@ msgid ""
 "%r"
 msgstr "dot a terminé avec une erreur :\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
-msgstr "graphviz_output_format doit être « png » ou « svg », mais est %r"
+msgstr "graphviz_output_format doit être « png » ou « svg »,  mais est %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr "dot code %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graphe: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graphe]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2643,148 +2689,158 @@ msgid ""
 "%r"
 msgstr "convert a terminé avec une erreur :\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "la commande convert %r ne peut pas être exécutée; vérifiez le paramètre image_converter"
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "La commande LaTeX %r (nécessaire pour le rendu des équations mathématiques), ne peut pas être exécutée, vérifier le paramètre imgmath_latex"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "La commande de %s, %r, ne pas être exécuté (nécessaire pour display mathématique), vérifier la configuration imgmath_%s"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr "latex de type display %r : %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "latex en ligne %r : %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Lien permanent vers cette équation"
 
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "l’inventaire intersphinx a bougé : %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "chargement de l'inventaire intersphinx de %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 "quelques problèmes ont été rencontrés avec quelques uns des inventaires, mais ils disposaient d'alternatives fonctionnelles :"
 
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "échec d'accès à un quelconque inventaire, messages de contexte suivants :"
 
-#: sphinx/ext/intersphinx.py:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(disponible dans %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(dans %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "l’identifiant intersphinx %r n'est pas une chaîne. Il sera ignoré"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
-msgstr ""
+msgstr "Échec de la lecture de intersphinx_mapping[%s]; ignoré : %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[source]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "À faire"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Entrée TODO trouvée : %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<entrée originale>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(l'<<entrée originale>> se trouve dans %s, à la ligne %d)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "entrée originale"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr "coloration syntaxique du code du module..."
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Code du module"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Code source de %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Vue d'ensemble : code du module"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Modules pour lesquels le code est disponible</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "signature invalide pour auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "erreur pendant la mise en forme de l'argument %s:%s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "attribut manquant %s dans l'objet %s"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autodoc : impossible de déterminer si %r est documenté; l'exception suivante a été levée :\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2792,104 +2848,157 @@ msgid ""
 "explicit module name)"
 msgstr "module à importer pour auto-documenter %r est inconnu (essayer de placer une directive \"module\" ou \"currentmodule\" dans le document, ou de donner un nom de module explicite)"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" dans le nom d'automodule n'a pas de sens"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "arguments de signature ou annotation de return donnés pour l’automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ devrait être une liste de chaînes, pas %r (dans module %s) -- __all__ sera ignoré"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr "attribut mentionné dans :members: ou _all_:module %s est manquant, attribut %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Bases : %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias de :class:`%s`"
+msgid "alias of %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:1832
 #, python-format
-msgid "Failed to parse type_comment for %r: %s"
+msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "autosummary references excluded document %r. Ignored."
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
+#, python-format
+msgid "Failed to parse type_comment for %r: %s"
+msgstr "Échec de l'analyse de type_comment pour %r : %s"
+
+#: sphinx/ext/autosummary/__init__.py:259
+#, python-format
+msgid "autosummary references excluded document %r. Ignored."
+msgstr "autosummary fait référence au document exclu %r. Ignoré"
+
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
+msgstr "autosummary : fichier stub non trouvé %r. Vérifiez votre paramètre autosummary_generate."
+
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "échec d'importation de %s"
+msgid "autosummary: failed to import %s"
+msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr "échec de l’analyse du nom %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "échec d’importation de l'object %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
-msgstr ""
+msgstr "autosummary_generate : fichier nontrouvé : %s"
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary engendre les fichiers .rst de manière interne. Mais votre source_suffix ne contient pas .rst. Ignoré."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autosummary : impossible de déterminer si %r est documenté; l'exception suivante a été levée :\n%s"
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr "[autosummary] engendrement d’un auto-sommaire pour : %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[autosummary] écriture dans %s"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
-msgstr ""
+msgstr "[autosummary] échec de l'import de %r : %s"
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2904,107 +3013,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nEngendre du ReStructuredText par les directives autosummary.\n\nsphinx-autogen est une interface à sphinx.ext.autosummary.generate. Il\nengendre les fichiers reStructuredText à partir des directives autosummary\ncontenues dans les fichiers donnés en entrée.\n\nLe format de la directive autosummary est documentée dans le module\nPython \"sphinx.ext.autosummary\" et peut être lu via : ::\n\npydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "fichiers sources pour lesquels il faut produire des fichiers rST"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "répertoire où placer toutes les sorties"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "extension par défaut pour les fichiers (par défaut : %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "répertoire des templates spécifiques (par défaut : %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "membres importés du document (défaut : %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Arguments de mots-clés"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Exemple"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Exemples"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Notes"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Autres paramètres"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "Références"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "Avertissements"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr "Yields"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Attention"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Prudence"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Danger"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Erreur"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Indication"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Important"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Note"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Voir aussi"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Astuce"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Avertissement"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "suite de la page précédente"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "suite sur la page suivante"
@@ -3021,181 +3154,181 @@ msgstr "Chiffres"
 msgid "page"
 msgstr "page"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Table des matières"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Recherche"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Go"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Montrer le code source"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Résumé"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Bienvenue ! Ceci est"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "la documentation pour"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "dernière modification"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indices et tables :"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Table des matières complète"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "lister l'ensemble des sections et sous-sections"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "rechercher dans cette documentation"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Index général des modules"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "accès rapide à l'ensemble des modules"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "toutes les fonctions, classes, termes"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Index &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Index complet sur une seule page"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indexer les pages par lettre"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "peut être énorme"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigation"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Recherchez dans %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "À propos de ces documents"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Mis à jour le %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Créé avec <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Rechercher %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Sujet précédent"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "Chapitre précédent"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Sujet suivant"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "Chapitre suivant"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Veuillez activer le JavaScript pour que la recherche fonctionne."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
-msgstr ""
+msgstr "Une recherche sur plusieurs mots ne retourne que les résultats contenant tous les mots."
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "rechercher"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Résultats de la recherche"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Votre recherche ne correspond à aucun document. Veuillez vérifier que les mots sont correctement orthographiés et que vous avez sélectionné assez de catégories."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Recherche rapide"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Cette page"
 
@@ -3227,19 +3360,19 @@ msgstr "Modifications de l'API C"
 msgid "Other changes"
 msgstr "Autres modifications"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Lien permanent vers ce titre"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Lien permanent vers cette définition"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Cacher les résultats de la recherche"
 
@@ -3251,12 +3384,12 @@ msgstr "Recherche en cours"
 msgid "Preparing search..."
 msgstr "Préparation de la recherche..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "La recherche est finie, %s page(s) trouvée(s) qui corresponde(nt) à la recherche."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", dans"
 
@@ -3269,7 +3402,7 @@ msgstr "Agrandir la barre latérale"
 msgid "Collapse sidebar"
 msgstr "Réduire la barre latérale"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Contenu"
 
@@ -3288,199 +3421,207 @@ msgstr "La note de bas de page [%s] n'est pas référencée."
 msgid "Footnote [#] is not referenced."
 msgstr "La note de bas de page [#] n'est pas référencée."
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "incohérences de références de notes de bas de page dans le message traduit. Original : {0}, traduit : {1} "
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "incohérences de références dans le message traduit. Original : {0}, traduit : {1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "incohérences de références de citation dans le message traduit. Original : {0}, traduit : {1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ncohérences de références de terme dans le message traduit. Original : {0}, traduit : {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "plus d'une cible trouvée pour la référence %r de type 'any' : pourrait être %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s référence cible non trouvée : %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "%r référence cible non trouvée %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "impossible d'atteindre l'image distante %s[%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr "impossible d'atteindre l'image distante %s[%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Format d'image inconnu : %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "le caractère source est indécodable, il sera remplacé par \"?\" : %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr "ignoré"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr "échoué"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "erreur de lecture : %s,%s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "erreur d'écriture : %s,%s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Format de date invalide. Insérez la chaîne de caractères entre des guillemets simples si vous voulez l'afficher telle quelle : %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "la table des matières contient des références à des fichiers inexistants %r"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "exception pendant l’évaluation de l'expression de la directive only : %s"
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr "Le support pour l’évaluation de la syntaxe de Python 2 est dépréciée et sera expurgé dans Sphinx 4.0. Convertissez %s à la syntaxe Python 3."
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "rôle par défaut %s introuvable"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format n'est pas défini %s"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Aucun ID assigné au node %s"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Lien permanent vers ce tableau"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Lien permanent vers ce code"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Lien permanent vers cette image"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Lien permanent vers cette table des matières"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "impossible d'obtenir la taille de l'image. L'option :scale: est ignorée."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "toplevel_sectioning %r inconnu pour la classe %r"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: trop grand, ignoré."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr "le titre du document n'est pas un unique node de type Text"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "le titre de node rencontré n'est apparenté à aucun parmi section, topic, table, admonition ou sidebar"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Notes de bas de page"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "options tabularcolumns et :widths: simultanément présentes. :widths: sera ignoré."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "%s est invalide comme unité de dimension. Ignoré."
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "le type inconnu d’entrée d’index %s a été trouvé"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[image: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[image]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "la légende n'est pas à l'intérieur de la figure."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "type de node non-implémenté : %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr "type de node inconnu : %r"
diff --git a/sphinx/locale/he/LC_MESSAGES/sphinx.po b/sphinx/locale/he/LC_MESSAGES/sphinx.po
index 1f8d45480b4..041ba79bb0e 100644
--- a/sphinx/locale/he/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/he/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2011
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Hebrew (http://www.transifex.com/sphinx-doc/sphinx-1/language/he/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: he\n"
 "Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n == 2 && n % 1 == 0) ? 1: (n % 10 == 0 && n % 1 == 0 && n > 10) ? 2 : 3;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "רמת המודול"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(בתוך"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "אינדקס"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "הבא"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "הקודם"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "תיעוד %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "אינדקס"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "מהדורה"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "מחבר הקטע:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "מחבר המודול:"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "מחבר הקוד:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "מחבר:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "פרמטרים"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr ""
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "משתנה"
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr ""
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
+msgstr "פונקציה"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
+msgstr "מאקרו"
+
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
-msgstr "פונקציה"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
-msgstr "מאקרו"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "משתנה"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "חדש בגרסה %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "השתנה בגרסה %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr " לא מומלץ לשימוש מגרסה %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "מחלקה"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr ""
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "מודול"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "מילת מפתח"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "משתנים"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "משתנה סביבה; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "משתנה סביבה"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "מודול אינדקס"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "דף חיפוש"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "ראה %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "ראה גם %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[מקור]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "לעשות"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "הטקסט המקורי"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[תיעוד]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>הראה קוד מקור ל %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>כל המודולים שיש להם קוד זמין</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "תשומת לב"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "זהירות"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "סכנה"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "שגיאה"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "רמז"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "חשוב"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "הערה"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "ראה גם"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "טיפ"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "אזהרה"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "המשך מעמוד קודם"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,124 +3131,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "חיפוש"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "לך"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "הצג מקור"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "סקירה כללית"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "תוכן עניינים מלא"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "חפש בתיעוד זה"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "אינדקס מודולים גלובלי"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "גישה מהירה לכל המודולים"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "כל הפונקציות, המחלקות, המושגים"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "אינדקס מלא בעמוד אחד"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "עמודי אינדקס לפי אותיות"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "עשוי להיות עצום"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "ניווט"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "חפש בתוך %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "על מסמכים אלו"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "זכויות שמורות"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "עודכן לאחרונה ב %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3127,55 +3257,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr "חפש %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "נושא קודם"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "פרק קודם"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "נושא הבא"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "פרק הבא"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "אנא הפעל ג'אואסקריפט ע\"מ לאפשר את\n    החיפוש."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "חיפוש"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "תוצאות החיפוש"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "חיפוש מהיר"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "עמוד זה"
 
@@ -3207,19 +3337,19 @@ msgstr ""
 msgid "Other changes"
 msgstr "שינויים אחרים"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "קישור קבוע לכותרת זו"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "קישור קבוע להגדרה זו"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "הסתר תוצאות חיפוש"
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr "הרחב סרגל צד"
 msgid "Collapse sidebar"
 msgstr "כווץ סרגל צד"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "תוכן"
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "הערות שוליים"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[תמונה]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/hi/LC_MESSAGES/sphinx.po b/sphinx/locale/hi/LC_MESSAGES/sphinx.po
index 5effb078cc4..6313e64697a 100644
--- a/sphinx/locale/hi/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/hi/LC_MESSAGES/sphinx.po
@@ -1,151 +1,156 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Ajay Singh <ajaysajay@gmail.com>, 2019
 # Purnank H. Ghumalia <me@purnank.in>, 2015-2016
 # Sumanjali Damarla <damarlasumanjali@gmail.com>, 2020
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2019
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2019
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Hindi (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: hi\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "विन्यास निर्देशिका में कोन्फ़.पाय #conf.py# फाइल (%s) नहीं है "
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "स्रोत निर्देशिका (%s) नहीं मिली"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "स्रोत निर्देशिका और गंतव्य निर्देशिका समरूप नहीं हो सकतीं"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "स्फिंक्स %s संस्करण चल रहा है"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr "सुरक्षा कारण वर्ष macOS तथा python 3.8 और अधिक, के साथ समानांतर कार्य शैली कि सुविधा उपलब्ध नहीं हैं | अधिक जानकारी के लिए, कृपया \"https://github.com/sphinx-doc/sphinx/issues/6803\" पढ़े |"
+msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "इस परियोजना में स्फिंक्स का कम से कम %s संस्करण चाहिए और इसलिए इस संस्करण से बनाना संभव नहीं है."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "परिणाम निर्देशिका बनाई जा रही है"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "%s आयाम को स्थापित करते हुए:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'स्थापना' को जैसा कि अभी कोन्फ़.पाई में परिभाषित किया गया है, पाइथन से निर्देशित नहीं है. कृपया इसकी परिभाषा में परिवर्तन करके इसे निर्देश योग्य कर्म बनाएं. कोन्फ़.पाई को स्फिंक्स के आयाम की तरह व्यवहार के लिए इसकी आवश्कयता है."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "[%s] अनुवाद पढ़ा जा रहा है..."
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "संपन्न"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "अंतर्निर्मित संदेशों में उपलब्ध नहीं है"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr "रक्षित स्थिति को लागू किया जा रहा है"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "असफल: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "किसी निर्माता को नहीं चुना गया, मानक उपयोग: एच्.टी.ऍम.एल."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "सफल हुआ"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "समस्याओं के साथ समाप्त हुआ"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "%s निर्माण, चेतावनी %s (चेतावनी को गलती माने)| "
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "%s सम्पूर्ण, %s चेतावनी."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "%s निर्मित."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "निर्देशक कक्षा #node class# %r पहले से पंजीकृत है, इसके अभ्यागत निरस्त हो जाएंगे "
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "निर्देश %r पहले से पंजीकृत है, यह निरस्त हो जाएगा"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "भूमिका %r पहले से पंजीकृत है, यह निरस्त हो जाएगी"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -153,12 +158,12 @@ msgid ""
 "explicit"
 msgstr "%s आयाम यह घोषित नहीं करता कि यह समानांतर पाठन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें."
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "समानांतर पठन के लिए यह %s विस्तार अथवा आयाम सुरक्षित नहीं है | "
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -166,59 +171,59 @@ msgid ""
 "explicit"
 msgstr "%s आयाम यह घोषित नहीं करता कि यह समानांतर लेखन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें."
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "समानांतर लेखन के लिए  %s विस्तार अथवा आयाम सुरक्षित नहीं है | "
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "%s पर काम कर रहे हैं"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "शब्दकोष विन्यास मान %r की उल्लंघन नहीं किया जा सकता, अनदेखा किया गया (प्रत्येक अवयव का मान रखने के लिए %r का उपयोग करें)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "विन्यास मान %r के लिए अमान्य संख्या %r, अनदेखा किया गया"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "असमर्थित प्रकार के साथ विन्यास मान %r का उल्लंघन नहीं किया जा सकता, अनदेखा किया गया"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "आरोहण में अज्ञात विन्यास मान %r, अनदेखा किया गया"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "ऐसा कोई विन्यास मान नहीं है: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "विन्यास मान %r पहले से विद्यमान है"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "आपकी विन्यास फाइल में रचनाक्रम की त्रुटि है: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "विन्यास फाइल (अथवा इसके द्वारा आयातित प्रभागों) द्वारा sys.exit() का आह्वान किया गया"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -226,58 +231,51 @@ msgid ""
 "%s"
 msgstr "विन्यास फाइल में प्रोग्राम के योग्य त्रुटि है:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, 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:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "भाग %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "चित्र %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "सारणी %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "सूची %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "`{name}` विन्यास मान, {candidates} में से एक होना चाहिए, परन्तु `{current}` दिया गया है."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "विन्यास मान `{name}' का प्रकार `{current.__name__}' है; अपेक्षित {permitted}."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "विन्यास मान `{name}' का प्रकार `{current.__name__}' है; मानक `{default.__name__}' का प्रयोग किया गया."
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "विन्यास मान %r एक बिना-असकी #non-ASCII# अक्षरों के अक्षर-समूह है; यह यूनिकोड त्रुटियां करवा सकता है. कृपया यूनिकोड अक्षर-समूह का प्रयोग करें, जैसे कि %r."
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -285,405 +283,430 @@ msgstr "primary_domain %r नहीं मिला, अनदेखा कि
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "संस्करण 2.0 से, स्फिंक्स इंडेक्स #\"index\"# का मास्टर-डॉक् #master_doc# की तरह स्वतः उपयोग करता है. कृपया अपनी conf.py में \"master_doc = 'contents'\" जोड़ें."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "%r घटना पहले से विद्यमान है"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "अज्ञात घटना नाम: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "आयाम %s की needs_extensions मान में आवश्कता है, पर यह नहीं चढ़ाया गया है."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "इस परियोजना में आयाम %s का कम से कम %s संस्करण चाहिए इसलिए उपलब्ध संस्करण (%s) से बनाना संभव नहीं है."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "पिगमेंटस लेक्सर नाम %r अज्ञात है"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "literal_block का \"%s\" नियमन नहीं हो सका. विशेषअंकन छोड़ दिया गया."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "लेखपत्र पठनीय नहीं है. उपेक्षित."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "निर्माण वर्ग %s का कोई \"नाम\" भाव नहीं है"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "निर्माता %r पहले से (%s प्रभाग में) उपलब्ध है"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "निर्माता नाम %s पंजीकृत नहीं है अथवा प्रवेश स्थान पर उपलब्ध नहीं है."
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "निर्माता नाम %s पंजीकृत नहीं है"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "अधिकारक्षेत्र %s पहले से पंजीकृत है"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "अधिकारक्षेत्र %s अभी पंजीकृत नहीं है"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "%r निर्देश पहले से अधिकार-क्षेत्र %s में पंजीकृत है, "
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "%r भूमिका पहले से अधिकार-क्षेत्र %s में पंजीकृत है, "
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "%r अनुक्रमणिका  पहले से अधिकार-क्षेत्र %s में पंजीकृत है"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "%r object_type पहले से पंजीकृत है"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "%r crossref_type पहले से पंजीकृत है"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r पहले से पंजीकृत है"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "%r का source_parser पहले से पंजीकृत है"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "%s का स्रोत व्याख्याता पंजीकृत नहीं है"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "%r के लिए अनुवादक पहले से विद्यमान है"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node() के kwargs एक (visit, depart) फंक्शन टपल #function tuple# होने चाहिए: %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r पहले से पंजीकृत है"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "गणित प्रस्तोता %s पहले से पंजीकृत है"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "%r आयाम को %sसंस्करण से स्फिंक्स में सम्मिलित किया जा चुका है; आयाम की उपेक्षा की गयी."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "मौलिक अपवाद:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "%s आयाम का आयात नहीं किया जा सका"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "आयाम %r में कोई सेटअप #setup()# कारक नहीं है; क्या यह वास्तव में स्फिंक्स का परिवर्धक प्रभाग है?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "इस परियोजना में प्रयुक्त %s परिवर्धक को स्फिंक्स का कम से कम %s संस्करण चाहिए; इसलिए इस संस्करण से बनाना संभव नहीं है."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "परिवर्धक %r के सेटअप() कर्म से एक असहाय वस्तु वापस मिली है; इसको 'कुछ नहीं' अथवा मेटाडाटा कोश भेजना चाहिए था"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "पाइथन अभिवृद्धि प्रस्ताव; पी.ई.पी. %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "रुपविन्यास %r में कोई \"रूप\" मान नहीं है"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "रुपविन्यास %r में कोई अनुगत मान नहीं है"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "%r नाम से कोई रूप नहीं मिला, %r द्वारा अनुगत"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "विन्यास मान %s.%s खोजे गए किसी भी रूप विन्यास में नहीं दिखा"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "विन्यास का असमर्थित रूप विकल्प %r दिया गया"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "रुपविन्यास के पथ में फाइल %r कोई प्रमाणिक ज़िप फाइल नहीं है या इसमें कोई रुपविन्यास नहीं सहेजा गया है"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "संस्करण 1.4.0 से sphinx_rtd_theme पर कोई दृढ निर्भरता नहीं है. कृपया इसे स्वयं स्थापित करें. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "%r नामक कोई रूप विन्यास नहीं मिला (theme.conf अनुपस्थित?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s.(%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "निर्माणाधीन [mo]: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "परिणाम लिखा जा रहा है..."
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "सभी %d पी.ओ. फाइलें"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "निर्दिष्ट %d पी.ओ. फाइलों के लक्ष्य"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "%d पी.ओ. फाइलों के लक्ष्य कालातीत है"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "सभी स्रोत फाइलें"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "आदेश स्थान में दी गयी फाइल %r स्रोत निर्देशिका में नहीं है, उपेक्षा की जा रही है"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "आदेश स्थान में दी गयी फाइल %r का  नहीं है, उपेक्षा कर दी गई"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d स्रोत फाइलें आदेश स्थान में दी "
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "%d  फाइलों के लक्ष्य कालातीत है"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "निर्माणाधीन [%s]: "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "अप्रचलित फाइलों को चिन्हित किया जा रहा है..."
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "%d मिला"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "एक भी नहीं मिला"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr "स्थिति को परिरक्षित किया जा रहा है"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr "संगतता की जांच की जा रही है"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "कोई प्रयोजन कालातीत नहीं है"
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "स्थिति का नवीनीकरण किया जा रहा है"
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s जोड़ा गया, %s बदला गया, %s हटाया गया"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "स्रोतों को पढ़ा जा रहा है..."
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "कर्मियों की प्रतीक्षा हो रही है"
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "लेखन के लिए शेष लेखपत्र: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "लेखपत्र बनाए जा रहे हैं"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "विषय-सूची प्रविष्टि की प्रतिलिपि पायी गई: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "चित्रों की प्रतिलिपि बनाई जा रही है..."
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "चित्रलेख फाइल %r नहीं पढ़ा जा सका: इसकी प्रतिलिपि बनाई जा रही है"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "चित्रलेख फाइल %r की प्रतिलिपि नहीं की जा सकी:%s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "चित्रलेख फाइल %r नहीं लिखा जा सका:%s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr "पिलो नहीं मिला - चित्र फाइलों की प्रतिलिपि बनाई जा रही है"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "%s फाइल को लिखा जा रहा है..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "%s के लिए अज्ञात लेख प्रकार, छोड़ा गया"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "%s फाइल को लिखा जा रहा है..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "संक्षिप्त विवरण फाइल %(outdir)s में है."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "%s संस्करण में कोई परिवर्तन नहीं हैं."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "सार फाइल को लिखा जा रहा है..."
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "अंतर्निर्मित"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "प्रभाग स्तर"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "स्रोत फाइलों की प्रतिलिपि बनाई जा रही है..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "परिवर्तन सूची बनाने के लिए %r को नहीं पढ़ा जा सका"
@@ -692,160 +715,164 @@ msgstr "परिवर्तन सूची बनाने के लिए %
 msgid "The dummy builder generates no files."
 msgstr "मूक निर्माता से किसी फाइलों की उत्पत्ति नहीं होती."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "ई-पब फाइल %(outdir)s में है."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_language\" (अथवा \"language\") खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_uid\" एक्स.एम्.एल. नाम होना चाहिए"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_title\" (अथवा \"html_title\") खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_author\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_contributor\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_description\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_publisher\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_copyright\" (अथवा \"copyright\") खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_identifier\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"version\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "अमान्य css_file: %r, उपेक्षित"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "सन्देश सूचीपत्र %(outdir)s में हैं."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "%d नमूना फाइलों के लक्ष्य"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "नमूनों को पढ़ा जा रहा है..."
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "सन्देश सूचीपत्रों को लिखा जा रहा है..."
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "उपरोक्त परिणाम में अथवा %(outdir)s /output.txt में त्रुटियाँ ढूँढने का प्रयास "
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "लक्ष्य '%s' नहीं मिला"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "खंडित कड़ी: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "लक्ष्य '%s' नहीं मिला"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "पुस्तिका पृष्ठ %(outdir)sमें हैं."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "कोई \"man_pages\" विन्यास मान नहीं मिला; कोई नियमावली पृष्ठ नहीं लिखे जाएंगे"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "लिखा जा रहा है"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "\"man_pages\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें है."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "एकल लेखपत्र संकलन किया जा रहा है"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "अतिरिक्त फाइलों को लिखा जा रहा है"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "टेक्सइन्फो पृष्ठ %(outdir)sमें हैं."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nइन्हें मेकइन्फो से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'मेक इन्फो' आदेश का उपयोग करें)"
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "कोई \"texinfo_documents\" विन्यास मान नहीं मिला; कोई लेखपत्र नहीं लिखे जाएंगे"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "\"texinfo_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "%s की प्रक्रिया जारी"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "सन्दर्भों का विश्लेषण किया जा रहा है..."
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (में"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "टेक्सइन्फो सहायक फाइलों की प्रतिलिपि की जा रही है..."
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "मेकफाइल लिखने में त्रुटि: %s"
@@ -855,18 +882,18 @@ msgstr "मेकफाइल लिखने में त्रुटि: %s"
 msgid "The text files are in %(outdir)s."
 msgstr "पाठ फाइल %(outdir)s में हैं."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "%s फाइल लिखने में व्यवधान: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "छद्म-एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं."
@@ -881,290 +908,302 @@ msgstr "निर्माण सूचनापत्र फाइल खंड
 msgid "The HTML pages are in %(outdir)s."
 msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें हैं."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "निर्माण सूचनापत्र फाइल को नहीं पढ़ा जा सका: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "html_use_opensearch विन्यास मान अब वर्णाक्षरों में होना आवश्यक है"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "सामान्य अनुक्रमाणिका"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "अनुक्रमणिका"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "आगामी"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "पूर्ववर्ती"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr "अनुक्रमाणिका निर्मित की जा रही है"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr "अतिरिक्त पृष्ठ लिखे जा रहे हैं"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "उतारी गई फाइलों की प्रतिलिपि बनाई जा रही है..."
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "उतारी गई फाइलों %r की प्रतिलिपि नहीं की जा सकी: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "अपरिवर्ती फाइलों की प्रतिलिपि बनाई जा रही है..."
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "स्थैतिक फाइल %r की प्रतिलिपि नहीं की जा सकी"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr "अतिरिक्त फाइलों की प्रतिलिपियां बनाये जा रहे है| "
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "अतिरिक्त फाइल %r की प्रतिलिपि नहीं की जा सकी"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "निर्माण फाइल को नहीं लिखा जा सका: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "खोज अनुक्रमाणिका नहीं चढाई जा सकी, लेकिन सभी लेखपत्र नहीं बनाए जाएंगे: अनुक्रमणिका अपूर्ण रहेगी."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "पृष्ठ %s html_sidebars में दो आकृतियों से मिलता है: %r  %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "पृष्ठ %s की प्रस्तुति करते समय यूनिकोड त्रुटि हुई. कृपया यह सुनिश्चित कर लें कि सभी नॉन-असकी #non-ASCII# विहित विन्यास मान यूनिकोड अक्षरों में हैं."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "पृष्ठ %s की प्रस्तुति करते समय एक त्रुटि हुई.\nकारण: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr "विषयवस्तुओं का भंडार बनाया जा रहा है"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr "%s में खोज अनुक्रमाणिका भंडार बनाया जा रहा है"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "अमान्य js_file: %r, उपेक्षित"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "कई math_renderers पंजीकृत हैं. लेकिन कोई math_renderers नहीं चुना गया है."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "अज्ञात math_renderer %r दिया गया."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path प्रविष्टि %r का अस्तित्व नहीं है"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "html_extra_path का प्रविष्टि %r outdir में है|  "
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "html_static_path प्रविष्टि %r का अस्तित्व नहीं है"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "html_static_path का  प्रविष्टि %r outdir में है|  "
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "प्रतीकचिन्ह फाइल %r का अस्तित्व नहीं है"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "इष्ट चिन्ह फाइल %r का अस्तित्व नहीं है"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s दिग्दर्शिका"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "लाटेक्स लेखपत्र %(outdir)s में हैं."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nइन्हें (pdf)latex से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'make latexpdf' आदेश का उपयोग करें)"
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "कोई \"latex_documents\" विन्यास मान नहीं मिला; कोई  नहीं लिखे जाएंगे"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "\"latex_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "अनुक्रमणिका"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "आवृत्ति"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "%r भाषा के लिए कोई बाबेल विकल्प नहीं "
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है..."
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है..."
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "अतिरिक्त फाइलों की प्रतिकृति बनाई जा रही है"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r में कोई \"रूप\" मान नहीं है"
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r में कोई \"%s \" मान नहीं है"
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "निर्माण के दौरान अपवाद घटित हुआ है, दोष-मुक्तक चालू किया जा रहा "
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr "कार्य खंडित "
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "रेस्ट सुसज्जा त्रुटि:"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "कूटलेखन त्रुटि:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "यदि आप इस विषय को कूटलिपिकारों के संज्ञान में लाना चाहते है तो   पिछला पूरा विवरण %s में सहेज दिया गया है"
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "पुनरावर्तन त्रुटि:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "ऐसा बहुत बड़ी अथवा गहरे स्तर तक गई स्रोत फाइलों से संभव है. आप स्वतः मानक पाइथन पुनरावर्तन सीमा 1000 को conf.py में बाधा सकते हैं. जैसे कि:"
+msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "अपवाद घटित:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "यदि यह प्रयोक्ता की गलती थी तो कृपया इसको भी रिपोर्ट करें ताकि अगली बार गलती होने पर अधिक अर्थपूर्ण सन्देश दिया जा सके."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "त्रुटि की सूचना <https://github.com/sphinx-doc/sphinx/issues> पर उपस्थित पंजिका में दर्ज की जा सकती है. धन्यवाद!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "कार्य संख्या एक धनात्मक संख्या होनी चाहिए"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "अधिक जानकारी के लिए <http://sphinx-doc.org/> देखें."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1181,296 +1220,290 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nस्रोत फाइलों से अभिलेख बनाएं.\n\nस्फिंक्स-बिल्ड #sphinx-build# सोर्स डायरेक्टरी #SOURCEDIR# की फाइलों से अभिलेख बनाता है और आउटपुट डायरेक्टरी #OUTPUTDIR# में सहेजता है. यह सोर्स डायरेक्टरी #SOURCEDIR# में कोन्फ.पाई से विन्यास मानों को उठाता है. स्फिंक्स-क्विक-स्टार्ट उपकरण का उपयोग कोन्फ.पाई सहित नमूना फाइलों को बनाने में किया जा सकता है.\n\nस्फिंक्स-बिल्ड भिन्न प्रारूपों में अभिलेख तैयार कर सकता है. प्रारूप का चुनाव आदेश देते समय निर्माता का नाम देकर किया जाता है - एच.टी.एम्.एल. इसका मानक प्रारूप है. ये निर्माता अभिलेखों के बनाने की प्रक्रिया में अन्य कार्य भी सम्पादित कर सकते हैं.\n\nमानक पद्धति के अनुसार सभी कालातीत अवयवों का नवनिर्माण होता है. चुनी हुई फाइलों नाम देकर केवल उन्ही फाइलों का नवनिर्माण किया जा सकता है.\n"
+msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "अभिलेख की स्रोत फाइलों का पथ"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "परिणाम निर्देशिका का पथ"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "पुनर्निर्माण के लिए निश्चित फाइलों की सूची. यदि -a निर्दिष्ट है तो उपेक्षा कर दी जाएगी"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "सामान्य विकल्प"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "प्रयोग के लिए निर्माता (मानक: एच.टी.एम्.एल. #html#)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "सभी फाइलें लिखें (मानक: केवल नई और परिवर्तित फाइलें लिखें)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "सहेजी गयी परिस्थिति का प्रयोग न करें, सदैव सभी फाइलों को पढ़ें"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "संचित परिस्थिति और डॉक-ट्री फाइलों का पथ (मानक: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "यदि संभव हो तो समानांतर N प्रक्रियाओं में निर्माण करें (ऑटो #auto# विशेष मान द्वारा cpu-count को N पर लगा दिया जाएगा)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "पथ जहाँ पर विन्यास फाइल (conf.py) स्थित है (मानक: SOURCEDIR के समरूप)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "किसी भी विन्यास फाइल का उपयोग ही न करें, मात्र -D विकल्प"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "विन्यास फाइल के एक मान का उल्लंघन करें "
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "एच.टी.एम्.एल. के नमूने में राशि प्रेषित करें"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "नाम-पत्र परिभाषित करें: केवल नाम-पत्र वाले खण्डों का समावेश करें"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "गहन जांच का पालन करें, सभी अनुपस्थित संदर्भों के बारे में सचेत करें"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "प्रदर्शित परिणामों के विकल्प"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "शब्द-प्रयोग बढ़ाएं (पुनरावृत्ति की जा सकती है) "
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "एस.टी.डी आउट #stdout# पर कोई परिणाम नहीं, एस.टी.डी एरर #stderr# पर चेतावनियाँ "
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "कुछ भी निर्गमित नहीं, यहाँ तक कि चेतावनी भी नहीं"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "रंगीन परिणाम ही दिखाएँ (मानक: स्वतः अनुमानित)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "रंगीन परिणाम नहीं दिखाएँ (मानक: स्वतः अनुमानित)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "चेतावनियाँ (और त्रुटियाँ) दी गई फाइल में लिखें"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "चेतावनियों को अशुद्धि मानें"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "अपवाद होने पर पूरा विलोम-अनुगमन देखें"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "अपवाद होने पर पी.डी.बी. चलाएं"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "%r फाइलों को नहीं ढूँढा जा सका"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "-a विकल्प और फाइल के नामों को सम्मिलित नहीं किया जा सकता"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "चेतावनी फाइल %r नहीं खोली जा सकी: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "-D विकल्प का मान नाम = मान के रूप में होना आवश्यक है"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "-A विकल्प का मान नाम = मान के रूप में होना आवश्यक है"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "प्रभागों में से डॉक्-स्ट्रिंग स्वतःसम्मिलित करें"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "डॉक्-टेस्ट अंशों के निर्देश भाग की स्वतः जाँच करें"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "भिन्न परियोजनाओं के स्फिंक्स प्रलेखों का पारस्परिक सम्बन्ध करने दें"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "वह \"शेष\" प्रविष्टियाँ लिख लें, जिन्हें निर्माण के समय दिखाया या छिपाया जा सकता है"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "प्रलेखों की व्याप्ति की जाँच करें"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "गणित को सम्मिलित करें, पी.एन.जी. अथवा एस.वी.जी. में चित्रित"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "गणित को सम्मिलित करें, दिग्दर्शक में मैथजाक्स #MathJax# द्वारा प्रदर्शित"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "विन्यास मान के आधार पर सामिग्री का सशर्त समावेश"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "पाइथन विषयवस्तुओं के प्रलेखों के स्रोत निर्देश की कड़ी जोड़ें"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "गिटहब GitHub पर लेखपत्र प्रकाशित करने के लिए .nojekyll फाइल बनाएं"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "कृपया एक मान्य पथ का नाम दें"
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "कृपया कुछ वाक्यांश लिखें"
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "%s में से एक चुनें"
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "कृपया हाँ के लिए 'y' अथवा नहीं के लिए 'n' मात्र दें. "
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "कृपया एक फाइल प्रत्यय दें, जैसे कि '.rst' अथवा '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "* टिपण्णी: नॉन-असकी #non-ASCII# अक्षर और सीमावर्ती कूटलेख अज्ञात हैं -- यू.टी.एफ.-8 अथवा लैटिन-1 माने गए."
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "स्फिंक्स %s त्वरित-आरंभ #sphinx-quickstart# उपकरण के लिए अभिनन्दन"
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "कृपया निम्न विन्यासों के लिए मान प्रदान करें (मानक मान, यदि कोष्ठक में हो तो, स्वीकार करने के लिए एन्टर दबाएँ)"
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr "चुना हुआ बुनियादी तथा मूल स्थान: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr "आलेख का बुनियादी स्थान बताएं."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "आलेख का बुनियादी पथ"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "त्रुटि: एक मौजूदा conf.py फाइल दिए गए मूल पथ में प्राप्त हुई है."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "स्फिंक्स-त्वरित-आरम्भ #sphinx-quickstart# मौजूदा स्फिंक्स परियोजनाओं पर पुनर्लेखन नहीं करेगा."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "कृपया एक नया मूल पथ दें (अथवा निकलने हेतु सिर्फ एन्टर #Enter# कर दें)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "आपके पास Sphinx द्वारा बनाई गई फाइलों को सहेजने के लिए दो विकल्प हैं.\nया तो आप मूल स्थान में ही \"_build\" निर्देशिका प्रयोग करें, अथवा\nमूल पथ में भिन्न \"स्रोत\" और \"build\" निर्देशिका प्रयोग करें."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "विभिन्न स्रोत और निर्माण डायरेक्टरी (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "मूल निर्देशिका के अन्दर, दो और निर्देशिका बनाई जाएँगी;\nपरिवर्धित एच.टी.एम्.एल. नमूनों के लिए \"_templates\" और परिवर्धित रुपपत्रों और अन्य स्थैतिक फाइलों के लिए \"_static\"\nआप अधोरेखा के स्थान पर अन्य पूर्व-प्रत्यय (जैसे कि \".\") का प्रयोग कर सकते हैं."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "नमूने और स्थैतिक डायरेक्टरी के लिए पूर्व-प्रत्यय"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "परियोजना का नाम बनाये गए प्रपत्रों में बहुत से स्थानों पर प्रयुक्त होगा."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "परियोजना का नाम"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "लेखक(कों) का नाम"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr "स्फिंक्स सॉफ्टवेयर के लिए संस्करण और आवृत्ति को मान्यता देता है.\nहर संस्करण की कई आवृत्तियाँ हो सकती हैं. उदाहरण के लिए,\nपाइथन संस्करण 2.5 अथवा 3.0 आदि हैं, और आवृत्ति\n2.5.1 अथवा 3.0a1 आदि हैं. यदि आपको इसे दो स्तर पर रखना नहीं चाहिए\nतो दोनों मान एक ही रख दें."
+msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "परियोजना संस्करण"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "परियोजना आवृत्ति"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1480,21 +1513,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "यदि प्रलेखों को अंग्रेजी के अलावा अन्य किसी भाषा में लिखा जाना है,\nतो यहाँ पर आप भाषा का कूटशब्द दे सकते हैं. स्फिंक्स तदपुरांत,\nजो वाक्यांश बनाता है उसे उस भाषा में अनुवादित करेगा.\n\nमान्य भाषा कूटशब्द सूची यहाँ पर देखें\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "परियोजना की भाषा"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "स्रोत फाइल का प्रत्यय"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1502,91 +1535,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "आपने मुख्य लेखपत्र का नाम दें (प्रत्यय रहित)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "त्रुटि: मुख्य फाइल %s चुने हुए मूल पथ में पहले से उपलब्ध है."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "स्फिंक्स-त्वरित-आरम्भ मौजूदा फाइलों पर पुनर्लेखन नहीं करेगा."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "कृपया एक नया फाइल नाम दें, अथवा मौजूदा फाइल का पुनर्नामकरण करें और एन्टर दबाएँ"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "इनमें से कौन सा स्फिंक्स आयाम प्रयोग करना है, इंगित करें:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "टिप्पणी: imgmath और mathjax एक साथ समर्थ नहीं हो सकते. imgmath को अचिन्हित कर दिया गया है."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "मेकफाइल बनाएं? (हाँ के लिए y/ ना के लिए n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "विंडोज़ कमांड फाइल बनाएं? (हाँ के लिए y/ ना के लिए n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "फाइल बनाई जा रही है ...%s"
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "फाइल %s पहले से उपस्थित है, छोड़ दी गई."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "समाप्त: एक प्रारंभिक निर्देशिका का ढांचा बना दिया गया है."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1596,787 +1629,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nस्फिंक्स परियोजना के लिए आवश्यक फाइल बनाएं.\n\nस्फिंक्स-त्वरित-आरम्भ एक संवादपूर्ण उपकरण है जो आपकी परियोजना के \nबारे में कुछ प्रश्न पूछकर पूरी प्रलेखों की निर्देशिका और नमूना मेकफाइल \nबना देता है जिसे स्फिंक्स-बिल्ड में प्रयोग किया जा सकता है.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "शांत ढंग "
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "ढांचे के विकल्प"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "यदि निर्दिष्ट हो तो विभिन्न स्रोत और निर्माण पथ"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "_templates आदि में बिंदु का बदलाव"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "परोयोजना के मूलभूत विकल्प"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "परियोजना का नाम"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "लेखकों के नाम"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "परियोजना का संस्करण"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "परियोजना की आवृत्ति"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "लेखपत्र की भाषा"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "स्रोत फाइल का प्रत्यय"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "मुख्य लेखपत्र का नाम"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "ई-पब प्रयोग करें"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "आयाम के विकल्प"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "आयाम %s सक्षम करें"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "स्वेच्छित आयाम सक्षम करें"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "मेकफाइल और बैचफाइल का सर्जन"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "मेकफाइल बनाएं"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "मेकफाइल नहीं बनाएं"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "बैचफाइल बनाएं"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "बैचफाइल नहीं बनाएं"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat के लिए make-mode का प्रयोग करें"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat के लिए make-mode का प्रयोग नहीं करें"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "परियोजना नमूनावृत्ति"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "नमूना फाइलों के लिए नमूना निर्देशिका"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "नमूना चर-पद का निरूपण करें"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"शांत\" निर्दिष्ट है, परन्तु कोई भी \"परियोजना\" अथवा \"लेखक\" निर्दिष्ट नहीं है."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "त्रुटि: दिया गया पथ निर्देशिका नहीं है, अथवा स्फिंक्स फाइलें पहले से उपस्थित हैं."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "स्फिंक्स-त्वरित-आरम्भ केवल एक खाली निर्देशिका में कार्यशील हो सकती है. कृपया एक नया मूल पथ निर्दिष्ट करें."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "अमान्य नमूना चर-पद: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "अधिक बाहरी-हाशिया पाया गया"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "अमान्य शीर्षक: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "पंक्ति संख्या का ब्यौरा सीमा से बाहर है (1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "दोनों \"%s\" और \"%s\" विकल्पों का प्रयोग नहीं किया जा सकता"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "समावेशित फाइल %r नहीं मिली अथवा पढने में असफलता मिली"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "कूटलेखन %r जो कि सम्मिलित फाइल %r में प्रयुक्त है, अशुद्ध प्रतीत हो रही है, एक :encoding: विकल्प देकर प्रयत्न करें"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "%r नामक विषयवस्तु सम्मिलित फाइल %r में नहीं मिली"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "\"lineno-match\" का प्रयोग बिना जुडी \"lines\" के युग्म के साथ नहीं हो सकता"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "लाइन ब्यौरा %r: सम्मिलित फाइल %r से कोई लाइन नहीं ली जा सकीं"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "भाग के लेखक:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "प्रभाग लेखक:"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "निर्देश लेखक:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "लेखक:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "मापदण्ड"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "प्रदत्त "
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "प्रदत्त प्रकार "
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (C फंक्शन)"
-
-#: sphinx/domains/c.py:189
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C member)"
-msgstr "%s (C सदस्य)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C मैक्रो)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C प्रकार)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "सदस्य"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C चरपद)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "चर पद"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "फंक्शन"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "सदस्य"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "मैक्रो"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "युग्म"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "गणक"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "प्रगणक "
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "प्रकार"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "चर पद"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "संस्करण %s से नया "
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "संस्करण %s से अलग "
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "संस्करण %s से प्रतिबंधित "
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "प्रतिरूप उद्धरण %s, दूसरी प्रतिकृति %s में है "
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "उद्धरण [%s] सन्दर्भ कहीं नहीं है"
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "घोषणा की पुनरावृत्ति, '%s' में भी घोषित.\n'%s' घोषित है.  "
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "नमूना मानदण्ड "
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "देता है "
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "वर्ग"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "युग्म"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "अवधारणा "
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "गणक"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "प्रगणक "
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "घोषणा की पुनरावृत्ति, '%s' में भी घोषित.\nघोषणा का नाम '%s' है. "
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (अंतर्निर्मित फंक्शन)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s विधि)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (वर्ग)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (वैश्विक चरपद अथवा अचर) "
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s लक्षण)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "चर "
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (प्रभाग)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "पद्धति"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "आंकड़े "
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "लक्षण"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "प्रभाग"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "समीकरण का प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है "
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "अमान्य math_eqref_format: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "मुख्य-शब्द "
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "चालक"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "वस्तु"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "अपवाद "
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "वक्तव्य "
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "अंतर्निर्मित कर्म"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "चर पद "
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "उभारता है "
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s प्रभाग में )"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (अंतर्निर्मित चर पद)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s प्रभाग में )"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (अंतर्निर्मित चर पद)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (अंतर्निर्मित वर्ग)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s वर्ग में)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s विधि)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s वर्ग विधि) "
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s स्थैतिक विधि)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s स्थैतिक विधि)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s वर्ग विधि)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s वर्ग विधि) "
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s लक्षण)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "पाइथन प्रभाग सूची"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "प्रभाग"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "अवमानित "
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "वर्ग विधि"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "स्थैतिक पद्धति"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "पारस्परिक-सन्दर्भों के लिए एक से अधिक लक्ष्य मिले %r: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr "(अवमानित)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (निर्देश)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (भूमिका)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "निर्देश"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "भूमिका"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "परिस्थिति चर पद; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "अशुद्ध रूप विकल्प विवरण %r, अपेक्षित प्रारूप \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" अथवा \"+opt args\""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "पारिभाषिक पद"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "व्याकरण संकेत "
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "सन्दर्भ शीर्षक"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "परिस्थिति चर पद "
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "प्रोग्राम विकल्प "
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "लेखपत्र"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "प्रभाग सूची"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "खोज पृष्ठ"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है "
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig असमर्थ है. :numref: उपेक्षित है."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "%s के लिए कोई संख्या नहीं दी गई है: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "कड़ी का कोई शीर्षक नहीं है: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "अमान्य numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "अमान्य numfig_format: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "नव विन्यास"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "विन्यास परिवर्तित"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "आयाम परिवर्तित"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "निर्मित परिस्थिति वर्तमान संस्करण नहीं है "
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "स्रोत निर्देशिका परिवर्तित हो चुकी है "
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "यह परिस्थिति चुने गए निर्माता से मेल नहीं खाती, कृपया दूसरी डॉक-ट्री निर्देशिका चुनें. "
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "लेखपत्रों के पर्यवेक्षण में असफलता %s: %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "अधिकारक्षेत्र %r पंजीकृत नहीं है"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr "स्वयं-संदर्भित विषय-सूची-संरचना मिली है. उपेक्षा की गई."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "लेखपत्र किसी भी विषय-सूची-संरचना में सम्मिलित नहीं है"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "%s देखिए"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "%s भी देखिए"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार अज्ञात %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "संकेत "
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "पारस्परिक संदर्भित विषय-सूची-संरचना सन्दर्भ पाए गए, उपेक्षा की जा रही है: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "विषय-सूची-संरचना में लेखपत्र %r, जिसका कोई शीर्षक नहीं है, का सन्दर्भ है: कोई सम्बन्ध नहीं बनाया जा सकेगा"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "विषय-सूची-संरचना में छोड़े गए लेखपत्र %r का सन्दर्भ है"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "विषय-सूची-संरचना में अविद्यमान लेखपत्र %r का सन्दर्भ है"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "चित्र फाइल पठनीय नहीं है: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "चित्र फाइल %s पठनीय नहीं है: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr "उतारी गई फाइल पठनीय नहीं है: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s में पहले से भाग संख्या नियत है (एक के अन्दर दूसरा अंकित विषय-सूची-संरचना)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr "%s फाइल बन जाएगी."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2388,165 +2410,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr "\n<MODULE_PATH> में पाइथन प्रभाग और पैकेज की पुनरावर्तित खोज करें और\nस्वतःप्रभाग निर्देश द्वारा <OUTPUT_PATH> में प्रति पैकेज एक रेस्ट #reST# फाइल बनाएं.\n\n<EXCLUDE_PATTERN> फाइल और/ अथवा निर्देशिका स्वरुप हो सकते हैं\nजो निर्माण प्रकिया में छोड़ दिए जाएंगे.\n\nनोट: सामान्यतया यह स्क्रिप्ट किसी पहले से बनाई गई फाइल पर पुनर्लेखन नहीं करती."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr "प्रभाग से लेखपत्र का पथ"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "fnmatch-style फाइल और/ अथवा निर्देशिका स्वरुप जो निर्माण प्रक्रिया से छोड़ने हैं"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr "सभी परिणामों को सहेजने के लिए निर्देशिका"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "विषय-सूची में दिखाए जाने वाले उपप्रभागों की अधिकतम गहराई (मानक: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "मौजूदा फाइलों पर पुनर्लेखन करें"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "सांकेतिक कड़ियों का अनुसरण करें. कलेक्टिव.रेसिपी.ऑमलेट के साथ प्रभावशाली. "
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "फाइलों को बनाए बिना स्क्रिप्ट चलाएं "
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr "प्रत्येक प्रभाग के आलेख उसके अपने पृष्ठ में रखें"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr "\"_private\" प्रभाग को सम्मिलित करें "
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr "विषय-सूची की फाइल का नाम (मानक: प्रभाग) "
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "विषय-सूची की फाइल न बनाएं "
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "प्रभाग/पैकेज पैकेजों का शीर्षक न बनाएं (उदाहरणार्थ, जब डॉकस्ट्रिंग्स में यह पहले से हों) "
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr " मुख्य प्रभाग के आलेख को उपप्रभाग के आलेख से पहले रखें"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "प्रभाग पथ की व्याख्या 'पी.ई.पी.-0420 निहित नामराशि विवरण' के आधार पर करें "
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "फाइल प्रत्यय (मानक: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr "स्फिंक्स-त्वरित-आरम्भ के साथ पूर्ण परियोजना उत्पन्न करें "
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "मोड्यूल_पाथ #module_path# को सिस.पाथ #sys.path# में जोड़ें, जब --full दिया जाता है तब इसका प्रयोग होता है "
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr "परियोजना का नाम (मानक: मूल प्रभाग का नाम) "
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr "परियोजना लेखक(गण), जब --full दिया जाता है तब इसका प्रयोग होता है "
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr "परियोजना संस्करण, जब --full दिया जाता है तब इसका प्रयोग होता है "
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "परियोजना आवृत्ति, जब --full दिया जाता है तब इसका प्रयोग होता है "
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "आयाम विकल्प "
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s एक निर्देशिका नहीं है. "
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "अमान्य रेगएक्स #regex# %r, %s में "
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "स्रोतों की व्यापकता की जांच पूरी, परिणाम %(outdir)spython.txt में देखें. "
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "अमान्य रेगएक्स #regex# %r, coverage_c_regexes में "
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "प्रभाग %s का आयत नहीं किया जा सका: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "'%s' विकल्प में अनुपस्थित '+' या '-'."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' एक मान्य विकल्प नहीं है."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' एक मान्य पाईवर्शन #pyversion# विकल्प नहीं है. "
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "अमान्य टेस्टकोड का प्रकार "
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "स्रोतों में डॉकटेस्ट्स की जांच पूरी, परिणाम %(outdir)s/output.txt में देखें. "
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "%s भाग में %s पर कोई निर्देश / परिणाम नहीं: %s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "अमान्य डॉकटेस्ट निर्देश की उपेक्षा की जा रही है: %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2560,11 +2602,11 @@ msgstr "ग्राफविज़ निर्देश में दोनों
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "बाहरी ग्राफविज़ फाइल %r नहीं मिली अथवा पढने में असफलता मिली"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "विषय-वस्तु के बिना ग्राफविज़ निर्देश की उपेक्षा की जा रही है. "
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2574,14 +2616,14 @@ msgid ""
 "%r"
 msgstr "डॉट ने किसी परिणाम फाइल का नहीं बनाया:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "डॉट निर्देश %r नहीं चलाया जा सकता (ग्राफविज़ परिणाम के लिए आवश्यक), ग्राफविज़_डॉट मान की जांच करें"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2591,29 +2633,30 @@ msgid ""
 "%r"
 msgstr "डॉट त्रुटि के साथ बहार आ गया:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "ग्राफविज़_आउटपुट_फॉर्मेट का 'पी.एन.जी', 'एस.वी.जी.', होना आवश्यक है, पर यह %r है"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr "डॉट निर्देश %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graph: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graph]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2626,148 +2669,158 @@ msgid ""
 "%r"
 msgstr "परिवर्तक त्रुटि के साथ बहार आ गया:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "लाटेक्स आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). आई.एम्.जी.मैथ_लाटेक्स मान की जाँच करें"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). imgmath_%s मान की जाँच करें"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr "लाटेक्स दिखाएँ %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "पंक्तिबद्ध लाटेक्स %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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 "इन्टरस्फिंक्स सामान स्थानांतरित हो चुका है: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "इन्टरस्फिंक्स सामान को %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 "कुछ चीजों के साथ कुछ समस्या है, लेकिन काम के दूसरे विकल्प उपलब्ध हैं: "
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(%s v%s में)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(%s में)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "इन्टरस्फिंक्स निर्धारक %r अक्षरमाला नहीं है. उपेक्षित"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[स्रोत]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "अपूर्ण "
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "अपूर्ण प्रविष्टि मिली: %s "
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<मूल प्रविष्टि>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<मूल प्रविष्टि>> %s, पंक्ति %d में उपस्थित है.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "मौलिक प्रविष्टि"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr "प्रभाग निर्देश विशिष्ट रूप से दर्शाया जा रहा है..."
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "प्रभाग निर्देश"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s का स्रोत निर्देश </h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "सिंहावलोकन: प्रभाग निर्देश"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>सभी प्रभाग जिनके लिए निर्देश उपलब्ध है</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "स्वतः %s (%r) के लिए अमान्य हस्ताक्षर"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "%s के पदों का प्रारूप बनाने में व्यवधान: %s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "%s गुण %s वस्तु में अनुपस्थित"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2775,104 +2828,157 @@ msgid ""
 "explicit module name)"
 msgstr "पता नहीं है कि कौन सा प्रभाग स्वतःप्रलेखन %r के लिए आयात करना है (लेखपत्र में \"प्रभाग\" या \"वर्तमान-प्रभाग\" निर्देश रख कर देखें; अथवा स्पष्ट प्रभाग नाम देकर देखें)"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "स्वतः प्रभाग नाम में \"::\"  विवेकहीन है"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "स्वतः-प्रभाग %s के लिए हस्ताक्षर पद अथवा प्रत्युत्तरित टिप्पणी प्रदान की गई"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
-msgstr "__all__ अंतिम अक्षरमाला होनी चाहिए, न कि %r (%s प्रभाग में) -- __all__ की उपेक्षा की जाएगी"
+msgstr "__all__ अंतिम अक्षरमाला होनी चाहिए, न कि %r (%s प्रभाग में) --  __all__ की उपेक्षा की जाएगी"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr "अनुपस्थित गुण का :members: में उल्लेख है अथवा __all__: प्रभाग %s, गुण %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "आधार: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr ":class:`%s` का उपनाम"
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "आयात में असफलता: %s"
+msgid "autosummary: failed to import %s"
+msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr "पद-विच्छेदन में असफलता: %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "विषय-वस्तु के आयात में असफलता: %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "ऑटोसमरी आतंरिक रूप से आर.एस.टी. फाइलें बनाता है. आपके सोर्स_सफिक्स में आर.एस.टी. सम्मिलित नहीं है. छोड़ा गया."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr "[ऑटोसमरी] अब इसका स्वतःसारांश बना रहा है: %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[ऑटोसमरी] %s पर लिख रहा है"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2887,107 +2993,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nस्वतः सारांश #autosummary# निर्देश का प्रयोग करते हुए पुर्नसरंचितपाठ बनाता है.\n\nस्फिंक्स-ऑटोजेन स्फिंक्स.एक्स्ट.ऑटोसमरी.जेनेरेट का मुखड़ा है.\nयह प्रदत्त फाइलों में सम्मिलित ऑटो समरी निर्देशों के अनुसार पुर्नसरंचितपाठ बनाता है\n\nस्वतः सारांश #autosummary# निर्देश का प्रारूप स्फिंक्स.एक्स्ट.ऑटोसमरी \nपाइथन प्रभाग में निबंधित है और इसे आप निम्नलिखित माध्यम से पढ़ सकते हैं:\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "आर.एस.टी. फाइलें बनाने के लिए स्रोत फाइलें"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "सभी परिणाम रखने के लिए निर्देशिका"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "फाइलों के लिए मानक प्रत्यय (मानक: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "पारंपरिक प्रारूप निर्देशिका (मानक: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "लेखपत्र आयातित सदस्य (मानक: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "मुख्य शब्दों के चर-पद"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "उदाहरण"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "कुछ उदाहरण"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "टिप्पणियाँ"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "अन्य मापदण्ड"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "सन्दर्भ"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "चेतावनी देता है"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr "मिलता है"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "सावधानी"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "चेतावनी"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "खतरा"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "गलती"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "संकेत"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "महत्त्वपूर्ण"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "टिप्पणी "
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "यह भी देखिए"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "सलाह"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "चेतावनी"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "पिछले पृष्ठ से जारी"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "अगले पृष्ठ पर जारी"
@@ -3004,181 +3134,181 @@ msgstr "संख्याएं "
 msgid "page"
 msgstr "पृष्ठ"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "विषय-सूची"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "खोज"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "चलिए"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "स्रोत दिखाएँ"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "सिंहावलोकन"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "नमस्ते! यह है"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "आलेख विषय"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "अंतिम परिवर्धन"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "सूचियाँ और सारणियाँ:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "विस्तृत विषय-सूची"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "सभी अनुभागों एवं उप-अनुभागों की सूची"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "इस आलेख में खोजें"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "सार्वभौमिक प्रभाग सूची"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "सभी प्रभाग तक तुरंत पहुँच"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "सभी कार्ययुक्तियां, वर्ग, शब्द"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "अनुक्रमणिका &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "एक पृष्ठ पर पूरी अनुक्रमणिका"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "अक्षर द्वारा अनुक्रमित पृष्ठ"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "बृहदाकार हो सकता है"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "संचालन"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s में खोजें"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "इन लेखपत्रों के बारे में"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "सर्वाधिकार"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">सर्वाधिकार</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; सर्वाधिकार %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "अंतिम बार सम्पादित %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "<a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s  से निर्मित."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr " %(docstitle)s में खोजें"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "पिछला प्रकरण"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "पिछला अध्याय"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "अगला प्रकरण"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "अगला अध्याय"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "खोज कार्य के लिए जावा स्क्रिप्ट का होना आवश्यक है. कृपया जावा स्क्रिप्ट को शुरू करें."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "खोज"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "खोज परीणाम "
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "आपके खोज परिणामों में कोई प्रलेख नहीं मिला. कृपया सुनिश्चित करें कि सभी शब्दों की वर्तनी शुद्ध है और आपने यथेष्ट श्रेणियां चुनी हैं."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "त्वरित खोज"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "यह पृष्ठ "
 
@@ -3210,19 +3340,19 @@ msgstr "सी ऐ.पी.आई. परिवर्तन"
 msgid "Other changes"
 msgstr "अन्य परिवर्तन"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "इस शीर्ष-पंक्ति की स्थायी कड़ी"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "इस परिभाषा की स्थायी कड़ी"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "खोजे गए जोड़े छिपाएं"
 
@@ -3234,12 +3364,12 @@ msgstr "खोज जारी"
 msgid "Preparing search..."
 msgstr "खोज की तैयारी"
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "खोज पूर्ण, खोज विषय के अनुकूल %s पृष्ठ मिला (मिले)."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", में "
 
@@ -3252,7 +3382,7 @@ msgstr "किनारे का स्थान बढ़ाएं"
 msgid "Collapse sidebar"
 msgstr "किनारे का स्थान घटाएं"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "विषय सामिग्री"
 
@@ -3271,199 +3401,207 @@ msgstr "पाद-टिप्पणी [%s] का कोई सन्दर्
 msgid "Footnote [#] is not referenced."
 msgstr "पाद-टिप्पणी [#] सन्दर्भ कहीं नहीं है"
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "अनुवादित संदेश में असंगत पाद-टिप्पणी के प्रसंग. मूल: {0}, अनुवादित: {1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "अनुवादित संदेश में असंगत प्रसंग. मूल: {0}, अनुवादित: {1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "अनुवादित संदेश में असंगत उद्धरण के प्रसंग. मूल: {0}, अनुवादित: {1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "अनुवादित संदेश में असंगत शब्द के प्रसंग. मूल: {0}, अनुवादित: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "किसी भी पारस्परिक-सन्दर्भ के लिए एक से अधिक लक्ष्य मिले %r: %s संभव"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s संदर्भित लक्ष्य नहीं मिले: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "%r संदर्भित लक्ष्य नहीं मिले: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "अज्ञात चित्र प्रारूप: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "असाधनीय स्रोत अक्षर, \"?\" द्वारा बदले जा रहे हैं: %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr "छोड़ा "
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr "असफल"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "अशुद्धि पाठन: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "अशुद्धि लेखन: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "अमान्य तिथि प्रारूप. यदि आप सीधे परिणाम में दर्शाना चाहते हैं तो अक्षरमाला को एकाकी उद्धरण चिन्ह द्वारा चिन्हित करें: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "विषय-सूची-संरचना में अविद्यमान फाइल %r का सन्दर्भ है"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "केवल निर्देशक भाव का मूल्यांकन करते समय अपवाद: %s"
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr "पाइथन 2 निर्देश-विन्यास के मूल्यांकन में सहायता भविष्य में सुसंगत नहीं रहेगी और स्फिंक्स 4.0 में हटा दी जाएगी. कृपया %s को पाइथन 3 निर्देश-विन्यास में परिवर्तित कर लें."
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "मानक भूमिका '%s' नहीं मिली"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "%s के लिए नमफिग_फॉर्मेट नहीं बताया गया है"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "%s बिंदु के लिए कोई पहचान-चिन्ह नहीं दिया गया"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "इस सारणी की स्थायी कड़ी"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "इस निर्देश की स्थायी कड़ी"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "इस चित्र की स्थायी कड़ी"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "इस विषय-सूची-संरचना की स्थायी कड़ी"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "चित्र का आकार नहीं मिल सका. :scale: विकल्प की उपेक्षा की जा रही है."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "अज्ञात %r उच्चतमस्तर_विभाजन #toplevel_sectioning# %r वर्ग के लिए"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr "अत्याधिक अधिकतम गहराई # :maxdepth: #, उपेक्षित किया गया."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr "लेखपत्र का शीर्षक एकल पाठ बिंदु नहीं है"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "पाया गया शीर्ष बिंदु किसी भाग, प्रसंग, तालिका, विषय-प्रबोध अथवा पार्श्व-स्थान में नहीं है"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "पाद टिप्पणियां"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "दोनों तालिका-स्तंभ और :चौड़ाई: विकल्प दिए गए हैं. :चौड़ाई:  मान की उपेक्षा की जाएगी."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "परिमाण मात्रक %s अमान्य है. उपेक्षा की जाएगी."
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार %s मिला"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[चित्र: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[चित्र]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "शीर्षक रेखाचित्र के भीतर नहीं है"
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "अकार्यान्वित बिंदु प्रकार: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr "अज्ञात बिंदु प्रकार: %r"
diff --git a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po
index b1047a51f4c..ce9082a0fed 100644
--- a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Hindi (India) (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi_IN/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: hi_IN\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,124 +3130,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3126,55 +3256,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3206,19 +3336,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/hr/LC_MESSAGES/sphinx.po b/sphinx/locale/hr/LC_MESSAGES/sphinx.po
index bd809f38165..8152500fea3 100644
--- a/sphinx/locale/hr/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/hr/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Mario Šarić, 2015-2020
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Croatian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hr/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: hr\n"
 "Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "u konfiguracijskom direktoriju ne postoji datoteka conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Nema izvornog direktorija (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Izvorni i odredišni direktorij ne smiju biti jednaki"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Izrada pomoću Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Ovaj projekt se ne može izgraditi s instaliranom verzijom, potrebno je instalirati Sphinx v%s ili višu verziju."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "izrada izlazne mape"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' koji je postavljen u conf.py nije moguće pozvati. Molimo izmijenite definiciju 'setup' funkcije kako bi ju mogli izvršiti iz Pythona. Ovo je potrebno kako bi conf.py imao karakter Sphinx proširenja. "
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "učitavanje prijevoda [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "napravljeno"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "neuspješno: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Nije odabran format, koristi se zadani: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "uspješno"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "završeno uz probleme"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "build %s, %s upozorenje."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "build %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr "%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr "%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "ne može se nadjačati osnovna konf. postavka %r, zanemarena je (koristite %r za postavljanje pojedinačnih elemenata)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "nepravilan broj %r za konf. vrijednost %r, zanemaruje se"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "ne može se nadjačati konf. vrijednost %r zbog nepodržanog tipa, zanemareno"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "nepoznata konfiguracijska vrijednost %r, zanemaruje se"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Ne postoji konfiguracijska vrijednost: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Konfiguracijska vrijednost %r već postoji"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Postoji sintaksna greška u konfiguracijskoj datoteci: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Poglavlje %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Slika %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tablica %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Ispis %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr "primary_domain %r nije pronađen, zanemareno je."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Događaj %r već postoji"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nepoznato ime događaja: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Ovaj projekt treba proširenje %s najmanje u verziji %si stoga se ne može izraditi s postojećom verzijom (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Klasa %s nema \"name\" svojstvo"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r već postoji (u modulu %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Builder imena %s nije registriran ili dostupan pomoću poziva"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Builder %s nije registriran"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "domena %s je već registrirana"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domena %s nije još registrirana"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser za %r je već registriran"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "proširenje %r se već nalazi u Sphinxu od verzije %s; ovo proširenje se zanemaruje."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Izvorna iznimka:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Proširenje %s ne može biti uvezena"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "proširenje %r nema funkciju setup(); radi li se o ispravnom Sphinx modulu proširenja?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "%s proširenje traži Sphinx verzije v%s; stoga projekt ne može biti izgrađen s ovom verzijom."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
-msgstr "proširenje %r vratio je nepodržan objekt iz setup() funkcije; rezultat treba biti None ili riječnik metapodataka"
+msgstr "proširenje %r vratio je nepodržan objekt iz setup() funkcije;  rezultat treba biti None ili riječnik metapodataka"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "tema %r nema postavku \"theme\""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "tema %r nema postavku \"inherit\""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "tema %r nije pronađena, nasljeđuje ju %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "postavka %s.%s ne pojavljuje se u pretraženim konfiguracijama tema"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "datoteka %r iz teme nije ispravna (zip) arhiva ili ne sadrži temu"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme više nije čvrsta zavisnost od verzija 1.4.0. Molimo instalirajte ručno. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "nema teme %r (nedostaje theme.conf?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Ugrađeni dijelovi"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Nivo modula"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (u "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Opceniti abecedni indeks"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "abecedni indeks"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "naprijed"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "nazad"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentacija"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Abecedni popis"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Distribucija"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "Detektirano je prekobrojno izvlačenje koda"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Neispravan navod: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Ne mogu se istovremeno koristiti *%s* i *%s* opcije"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Include datoteka %r nije pronađena ili se ne može pročitati"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Encoding %r za čitanje import datoteke %r nije ispravan, pokušajte dodati :encoding: opciju"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objekt %r nije pronađen u include datoteci %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Ne može se koristiti \"lineno-match\" sa nespojivom grupom \"lines\""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Specifikacija retka %r: nema redaka preuzetih iz include datoteke %r"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor sekcije: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor modula: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autor koda:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametri"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Vraća"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Vraća tip"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C funkcija)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C član)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C makro)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C tip)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "član"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C varijabla)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "varijabla"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funkcija"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "član"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerator"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tip"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "varijabla"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Novo u verziji %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Promijenjeno u verziji %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Zastarijelo od verzije %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Parametri predloška"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Baca (iznimke)"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "razred"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "koncept"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerator"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (ugrađene funkcije)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metoda)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (razred)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globalna varijabla ili konstanta)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atribut)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumenti"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metoda"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "podaci"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "dvostruka oznaka jednakosti %s, drugo pojavljivanje u %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "ključna riječ"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "izuzetak"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "izjava"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "ugrađen funkcije"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Varijable"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Podiže"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (u modulu %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (ugrađene variable)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (u modulu %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (ugrađene variable)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (ugrađen razred)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (razred u %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metoda)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s metoda klase)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s statična metoda)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statična metoda)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s metoda klase)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s metoda klase)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s atribut)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python indeks modula"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "Moduli"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Zastarjelo"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "metoda klase"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statična metoda"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (zastarjelo)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directive)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "Direktive"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "uloga"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "varijabla okruženja; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "termin rječnika"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "token gramatike"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "referentna oznaka"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "varijabla okruženja"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "programske mogućnosti"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Popis modula"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Tražilica"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "pogledajte %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "Dodatne informacije: %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simboli"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "nedostaje '+' ili '-' u '%s' opciji."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' nije valjana opcija."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' nije valjana pyversion opcija"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr "Graphviz direktiva ne može imati i sadržaj i ime datoteke za argumente
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Vanjska Graphviz datoteka %r ne postoji ili se ne može čitati"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignoriranje \"graphviz\" direktive bez sadržaja."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot naredba %r ne može se pokrenuti (potrebna za graphviz izlaz), provjerite postavku graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format mora biti 'png' ili 'svg', ali je %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graph: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graph]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Link na tu definiciju"
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(u %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[source]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> se nalazi u %s, redak %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "izvorna stavka"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Kod modula"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Izvorni kod za %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Pregled: kod modula"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Svi moduli za koje je dostupan kod</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Osnovice: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "nadimak za :class:`%s`"
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Argumenti"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Primjeri"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Pozor"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Pažnja"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Opasnost"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Greška"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Savjet"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Važno"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Napomena"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Više informacija"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Savjet"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Upozorenje"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "nastavak sa prethodne stranice"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,181 +3131,181 @@ msgstr ""
 msgid "page"
 msgstr "stranica"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Traži"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Traži"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Prikaži izvorni kod"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Pregled"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Dobro došli! Ovo je"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "dokumentacija za"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "posljednja promjena"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Kazala i tablice:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Detaljni sadržaj"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "prikaži sve sekcije i podsekcije"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "traži po dokumentaciji"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Općeniti popis modula"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "brz dostup do svih modula"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "sve funkcije, razredi, izrazi"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Index &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Potpun indeks na jednoj stranici"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indeksiraj stranice po slovu"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "može biti ogromno"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigacija"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Traži između %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "O ovim dokumentima"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Sva prava zadržana"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Sva prava zadržana</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Sva prava zadržana %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Zadnji put ažurirano %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Izrađeno sa <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Traži %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Prijašnja tema"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "Prijašnje poglavlje"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Sljedeća tema"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "sljedeće poglavlje"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Molimo omogućite JavaScript\n    za djelovanje tražilice."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "traži"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Rezultati pretrage"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Zadanim uvjetima nije pronađen dokument. Molim provjerite točnost upisanih riječi i odabir označenih kategija."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Brzo pretraživanje"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Trenutna stranica"
 
@@ -3207,19 +3337,19 @@ msgstr "C API promjene"
 msgid "Other changes"
 msgstr "Ostale promjene"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Link na taj naslov"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Link na tu definiciju"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Sakrij rezultate pretrage"
 
@@ -3231,12 +3361,12 @@ msgstr "Pretraživanje"
 msgid "Preparing search..."
 msgstr "Priprema pretrage..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Pretraga završena, pronađeno %s stranica."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", u "
 
@@ -3249,7 +3379,7 @@ msgstr "Pokaži pomoćnu traku"
 msgid "Collapse sidebar"
 msgstr "Sakrij pomoćnu traku"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Sadržaj"
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "više od jednog targeta za 'any' referencu %r: može biti %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s reference target nije pronađen: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "%r referenca target nije pronađena: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Permalink na ovu tablicu"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Permalink na ovaj kod"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Permalink na ovu sliku"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Permalink na ovaj sadržaj"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Fusnote"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[slika: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[slika]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/hu/LC_MESSAGES/sphinx.po b/sphinx/locale/hu/LC_MESSAGES/sphinx.po
index ecf147f1f62..b9613ffabf8 100644
--- a/sphinx/locale/hu/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/hu/LC_MESSAGES/sphinx.po
@@ -1,8 +1,9 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
+# Balázs Úr, 2020
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2011
 # Molnár Dénes <denes.molnar2@stud.uni-corvinus.hu>, 2017
 # Peter Schön <slapec@gmail.com>, 2018
@@ -12,141 +13,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Hungarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hu/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: hu\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
-msgstr "a konfigurációs mappa nem tartalmazza a conf.py állományt (%s)"
+msgstr "a beállítási könyvtár nem tartalmaz conf.py fájlt (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
-msgstr "A forrás mappa nem található (%s)"
+msgstr "Nem található a forráskönyvtár (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
-msgstr "A forrás és cél mappa nem lehet azonos"
+msgstr "A forráskönyvtár és célkönyvtár nem lehet azonos"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx %s verzió futtatása"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
-msgstr ""
+msgstr "Ez a projekt legalább a Sphinx %s verzióját igényli, és emiatt nem állítható össze ezzel a verzióval."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
-msgstr ""
+msgstr "kimeneti könyvtár elkészítése"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
-msgstr ""
+msgstr "a(z) %s kiterjesztés beállításakor:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
-msgstr ""
+msgstr "A „setup”, ahogy jelenleg a conf.py fájlban meg van határozva, nem meghívható Python függvény. Módosítsa a meghatározását, hogy meghívható függvénnyé tegye. Ez ahhoz szükséges, hogy a conf.py Sphinx kiterjesztésként viselkedjen."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
-msgstr "fordítások betöltése [%s]..."
+msgstr "fordítások betöltése [%s]…"
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "kész"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
-msgstr ""
+msgstr "nem érhető el beépített üzenetekhez"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
-msgstr ""
+msgstr "pickle-t környezet betöltése"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "sikertelen: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
-msgstr ""
+msgstr "Nincs összeállító kiválasztva, az alapértelmezett használata: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "sikerült"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "problémákkal befejeződött"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
-msgstr ""
+msgstr "%s összeállítás, %s figyelmeztetés (a figyelmeztetések hibákként való kezelésével)"
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
-msgstr ""
+msgstr "%s összeállítás, %s figyelmeztetés (a figyelmeztetések hibákként való kezelésével)"
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
-msgstr ""
+msgstr "%s összeállítás, %s figyelmeztetés."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
-msgstr ""
+msgstr "%s összeállítás, %s figyelmeztetés."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
-msgstr ""
+msgstr "%s összeállítás."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
-msgstr ""
+msgstr "a(z) %r csomópontosztály már regisztrálva van, a látogatói felül lesznek bírálva"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
-msgstr ""
+msgstr "a(z) %r direktíva már regisztrálva van, felül lesz bírálva"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -154,12 +160,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -167,59 +173,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -227,58 +233,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "%s. bekezdés"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "%s. ábra"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "%s. táblázat"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "%s. felsorlás"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -286,405 +285,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Fejlesztési Javaslatok; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Beépített"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Modul szint"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -693,160 +717,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " ("
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -856,18 +884,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -882,290 +910,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Általános tárgymutató"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "nyitóoldal"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "következő"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "előző"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentáció"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Tárgymutató"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Kiadás"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1184,277 +1224,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1463,15 +1497,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1481,21 +1515,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1503,91 +1537,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1597,787 +1631,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "A megadott útvonal nem egy mappa vagy a sphinx állományok már léteznek."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Fejezet szerző: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Modul szerző: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Kód szerző: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Szerző: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Paraméterek"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Visszatérési érték"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Visszatérés típusa"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (C függvény)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C tagváltozó)"
-
-#: sphinx/domains/c.py:191
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C macro)"
-msgstr "%s (C makró)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C típus)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "tag"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C változó)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "változó"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "függvény"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "tag"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makró"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enumeráció"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerátor"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "típus"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "változó"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Új a(z) %s verzióban"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "A %s verzióban változott"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Elavult a(z) %s verzió óta"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Sablonparaméterek"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Dob"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "osztály"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enumeráció"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerátor"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (beépített függvény)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metódus)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (osztály)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globális változó vagy konstans)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribútum)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumentum"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metódus"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "adat"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "attribútum"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "kulcsszó"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operátor"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objektum"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "kivétel"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "utasítás"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "beépített függvény"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Változók"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Kivétel"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s modulban)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (beépített változó)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s modulban)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (beépített változó)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (beépített osztály)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (osztály %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metódus)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s osztály metódus)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s statikus metódus)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statikus metódus)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s osztály metódus)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s osztály metódus)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s attribútum)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python Modul Mutató"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "modulok"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Elavult"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "osztály szintű metódus"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statikus metódus"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (elavult)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktíva)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (szerepkör)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktíva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "szerepkör"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "környezeti változó; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "szójegyzék"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "nyelvtani jel"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "referencia cimke"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "környezeti változó"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "program opció"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Modulok"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Keresés"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "forrás mappa megváltozott"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "lásd %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "lásd még %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Szimbólumok"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2389,165 +2412,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s nem mappa"
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2561,11 +2604,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2575,14 +2618,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2592,29 +2635,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graph: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graph]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2627,148 +2671,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
-msgstr ""
+msgstr "Állandó hivatkozás erre az egyenletre"
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(%s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[source]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Tennivaló"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "eredeti bejegyzés"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Modul forráskód"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s forráskódja</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Áttekintés: modul forráskód"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Az összes modul, melynek forrása elérhető</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2776,104 +2830,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "álneve :class:`%s`"
+msgid "alias of %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2888,107 +2995,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Figyelem"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Figyelem"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Veszély"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Hiba"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Tipp"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Fontos"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Megjegyzés"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Lásd még"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Javaslat"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Figyelem"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "folytatás az előző oldalról"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3005,181 +3136,181 @@ msgstr ""
 msgid "page"
 msgstr "oldal"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Keresés"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Ok"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Forrás megtekintése"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Áttekintés"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Üdvözöljük! Ez a"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "dokumentáció"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "utoljára frissítve"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Tárgymutató és táblázatok"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Teljes tartalomjegyzék"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "kilistázza az összes fejezetet és alfejezetet"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "keresés ebben a dokumentációban"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Teljes modul tárgymutató"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "gyors hozzáférés az összes modulhoz"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "összes funkció, osztály és kifejezés"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Tárgymutató &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Teljes tárgymutató egy oldalon"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Oldalak ABC sorrendben"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "nagy lehet"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigáció"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Keresés köztük: %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Névjegy ezekről a dokumentumokról"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Minden jog fenntartva"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Utolsó frissítés %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "<a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s használatával készült."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Keresés %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Előző témakör"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "előző fejezet"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Következő témakör"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "következő fejezet"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Kérem engedélyezze a JavaScriptet a kereső funkció\n    használatához."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "keresés"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Keresési Eredmények"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "A keresése nem hozott eredményt. Ellenőrizze, a megadott kulcsszavakat és azt, hogy megfelelő számú kategória van-e kiválasztva."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Gyorskeresés"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Ez az Oldal"
 
@@ -3211,19 +3342,19 @@ msgstr "C API változások"
 msgid "Other changes"
 msgstr "Egyéb változások"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Hivatkozás erre a fejezetcímre"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Hivatkozás erre a definícióra"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Keresési Találatok Elrejtése"
 
@@ -3235,12 +3366,12 @@ msgstr "Keresés folyamatban"
 msgid "Preparing search..."
 msgstr "Felkészülés a keresésre..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "A keresés befejeződött, %s oldal egyezik a keresési felételeknek."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", "
 
@@ -3253,7 +3384,7 @@ msgstr "Oldalsáv kinyitása"
 msgid "Collapse sidebar"
 msgstr "Oldalsáv összezárása"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Tartalom"
 
@@ -3272,199 +3403,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Permalink erre a táblázatra"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Permalink erre a kódrészletre"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Permalink erre a képre"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Lábjegyzetek"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[image: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[image]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/id/LC_MESSAGES/sphinx.po b/sphinx/locale/id/LC_MESSAGES/sphinx.po
index d1ff01f3414..2107fef5e1a 100644
--- a/sphinx/locale/id/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/id/LC_MESSAGES/sphinx.po
@@ -1,7 +1,7 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Arif Budiman <arifpedia@gmail.com>, 2016-2017
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2009
@@ -12,141 +12,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Indonesian (http://www.transifex.com/sphinx-doc/sphinx-1/language/id/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: id\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "direktori konfigurasi tidak berisi berkas conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Tidak dapat menemukan direktori sumber (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Direktori sumber dan direktori tujuan tidak boleh sama"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Menjalankan Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr "Untuk alasan keamanan, mode paralel dinonaktifkan di macOS dan python3.8 dan di atasnya. Untuk detail lebih lanjut, silakan baca https://github.com/sphinx-doc/sphinx/issues/6803"
+msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Proyek ini memerlukan sedikitnya Sphinx v%s dan maka itu tidak bisa dibangun dengan versi ini."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "membuat direktori keluaran"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "saat menyiapkan ekstensi %s:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' yang saat ini didefinisikan pada conf.py bukanlah sebuah Python callable. Silakan modifikasi definisinya untuk membuatnya menjadi fungsi callable. Hal ini diperlukan guna conf.py berjalan sebagai ekstensi Sphinx."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "memuat terjemahan [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "selesai"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "tidak tersedia untuk built-in messages"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr "memuat lingkungan yang diawetkan"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "gagal: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Tidak ada builder yang dipilih, menggunakan default: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "berhasil"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "selesai with masalah"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "bangun %s, %s peringatan (dengan peringatan dianggap sebagai kesalahan)."
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "build %s, %s peringatan."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "build %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "kelas simpul %r sudah terdaftar, pengunjungnya akan diganti"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "pengarahan %r sudah terdaftar, itu akan diganti"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "peran %r sudah terdaftar, itu akan diganti"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -154,12 +159,12 @@ msgid ""
 "explicit"
 msgstr "ekstensi %s tidak akan dinyatakan jika itu aman untuk pembacaan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "ekstensi %s tidak aman untuk pembacaan paralel"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -167,59 +172,59 @@ msgid ""
 "explicit"
 msgstr " \nekstensi %s tidak akan dinyatakan jika itu aman untuk penulisan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "ekstensi %s tidak aman untuk penulisan paralel"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "mengerjakan serial %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "tidak dapat menulis ulang pengaturan direktori konfigurasi %r, mengabaikan (gunakan %r untuk mengatur elemen-elemen satuan)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "nomor %r yang salah untuk konfigurasi nilai %r, mengabaikan"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "tidak dapat menulis ulang pengaturan konfigurasi %r dengan tipe yang tidak didukung, mengabaikan"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "nilai konfigurasi %r yang tidak dikenal pada penulisan ulang, mengabaikan"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Tidak terdapat nilai konfigurasi demikian: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Nilai konfigurasi %r sudah ada"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Ada kesalahan sintaksis dalam file konfigurasi Anda: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Berkas konfigurasi (atau salah satu dari modul terimpor) disebut sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -227,58 +232,51 @@ msgid ""
 "%s"
 msgstr "Terdapat kesalahan programmable dalam berkas konfigurasi anda:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "Nilai konfigurasi `source_suffix 'mengharapkan sebuah string, daftar string, atau kamus. Tetapi `%r' diberikan."
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Bab %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Gambar. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabel %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Daftar %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "Nilai konfigurasi `{name}` harus salah satu dari {candidates}, tapi `{current}` diberikan."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "Nilai konfigurasi `{name}' memiliki tipe `{current.__name__}'; diharapkan {permitted}."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "Nilai konfigurasi `{name}` bertipe `{current.__name__}', default menjadi `{default.__name__}'."
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "nilai konfigurasi %r diatur sebagai string dengan karakter non-ASCII; hal ini dapat berpotensi terjadinya galat Unicode. Silakan pakai string Unicode, sebagai contoh %r."
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -286,405 +284,430 @@ msgstr "primary_domain %r tidak ditemukan, diabaikan."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "Sejak v2.0, Sphinx menggunakan \"index\" sebagai master_doc secara bawaan. Silakan tambahkan \"master_doc = 'contents'\" ke conf.py Anda"
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Event %r sudah ada"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nama event tidak dikenal: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "Ekstensi %s diperlukan oleh pengaturan needs_extensions, tapi itu tidak dimuat."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Proyek ini memerlukan ekstensi %s sedikitnya pada versi %s dan maka itu tidak bisa dibangun dengan versi yang dimuat (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Nama Pygments lexer %r tidak diketahui"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "Tidak dapat menjalankan lex literal_block sebagai \"%s\". Menyoroti yang terlewat."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "dokumen tidak dapat dibaca. Diabaikan."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Class Builder %s tidak punya atribut \"name\""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r sudah ada (di modul %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Nama Builder %s todal terdaftar atau tersedia melalui entry point"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Nama Builder %s tidak terdaftar"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "domain %s telah terdaftar"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domain %s belum didaftarkan"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "Pengarahan %r sudah terdaftar di domain %s"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Peran %r sudah terdaftar di domain %s"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "Indeks %r sudah terdaftar ke domain %s"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "object_type %r telah didaftarkan"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "crossref_type %r telah didaftarkan"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r telah didaftarkan"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser untuk %r telah didaftarkan"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Parser sumber untuk %s tidak terdaftar"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Penerjemah untuk %r sudah ada"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "kwargs untuk add_node() harus berupa (visit, depart) function tuple: %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r telah terdaftar"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "math renderer %s telah terdaftar"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "ekstensi %r telah digabungkan dengan Sphinx sejak versi %s; ekstensi diabaikan."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Eksepsi orisinal:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Tidak dapat mengimpor ekstensi %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "ekstensi %r tidak memiliki fungsi setup(); apa itu benar-benar sebuah modul ekstensi Sphinx?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Ekstensi %s yang digunakan proyek ini memerlukan sedikitnya Sphinx v%s; maka itu tidak bisa dibangun dengan versi ini."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "ekstensi %r mengembalikan objek yang tidak didukung dari fungsi setup() nya; seharusnya mengembalikan None atau dictionary metadata"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "tema %r tidak memiliki pengaturan \"tema\""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "tema %r tidak memiliki pengaturan \"inherit\""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "tema berjudul %r tidak ditemukan, inherited oleh %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "pengaturan %s.%s terjadi pada tak satupun konfigurasi tema yang dicari"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "opsi tema yang tidak didukung %r diberikan"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "berkas %r pada path tema merupakan berkas zip yang tidak valid atau tidak berisi tema"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme bukan lagi merupakan dependensi bawaan sejak versi 1.4.0. Silakan memasangnya secara manual.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "tema bernama %r tidak ditemukan (kehilangan theme.conf?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "membangun [mo]: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "menulis keluaran... "
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "semua dari %d berkas po"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "target untuk %d berkas po yang telah ditetapkan"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "target untuk %d berkas po telah usang"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "semua berkas sumber"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "berkas %r yang diberikan di command line tidak berada dalam direktori sumber, mengabaikan"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "berkas %r yang diberikan di command line tidak tersedia, mengabaikan"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d berkas sumber diberikan di command line"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "target untuk %d berkas sumber yang telah usang"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "membangun [%s]: "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "mencari berkas yang kini-usang... "
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "%d ditemukan"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "tidak ditemukan apapun"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr "lingkungan pengawetan"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr "memeriksa konsistensi"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "tidak ada target yang usang."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "memperbarui lingkungan:"
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s ditambahkan, %s diubah, %s dihapus"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "membaca sumber... "
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "menunggu workers..."
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "docnames yang akan ditulis: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "menyiapkan dokumen"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "entri ToC ganda ditemukan: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "menyalin gambar... "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "tidak dapat membaca berkas gambar %r: menyalin gambar sebagai gantinya"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "tidak dapat menyalin berkas gambar %r: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "tidak dapat menulis berkas gambar %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr "Pillow tidak ditemukan - menyalin berkas gambar"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "menulis %s berkas..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "mimetype yang tidak dikenal untuk %s, mengabaikan"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "menulis %s berkas..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Berkas tinjauan berada di %(outdir)s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "tidak ada pengubahan dalam versi %s."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "menulis berkas ringkasan..."
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Modul Internal"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Level Modul"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "menyalin berkas sumber..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "tidak dapat membaca %r untuk pembuatan changelog"
@@ -693,160 +716,164 @@ msgstr "tidak dapat membaca %r untuk pembuatan changelog"
 msgid "The dummy builder generates no files."
 msgstr "Builder contoh tidak menghasilkan berkas apapun."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Berkas ePub berada di %(outdir)s."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "nilai conf \"epub_language\" (atau \"language\") tidak seharsunya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "nilai conf \"epub_uid\" harus berupa XML NAME untuk EPUB3"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "nilai conf \"epub_title\" (atau \"html_title\") tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_author\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_contributor\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_description\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_publisher\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "nilai conf \"epub_copyright\" (atau \"copyright\") tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_identifier\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "bilai conf \"version\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "css_file yang salah: %r, mengabaikan"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Katalog pesan berada di %(outdir)s."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "target untuk %d berkas templat"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "membaca templat... "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "menulis katalog pesan... "
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Mencari kesalahan sembarang dalam keluaran di atas atau di %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "Anchor '%s' tidak ditemukan"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "tautan rusak: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "Anchor '%s' tidak ditemukan"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Halaman manual berada di %(outdir)s."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "tidak ditemukan nilai konfigurasi \"man_pages\"; halaman manual tidak akan ditulis"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "penulisan"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "\"man_pages\" nilai konfigurasi mengacu pada dokumen tidak diketahui %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Halaman HTML berada di %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "merakit dokumen tunggal"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "menulis file tambahan"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Berkas Texinfo berada di %(outdir)s."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui makeinfo\n(gunakan 'make info' di sini untuk melakukannya secara otomatis)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "tidak ditemukan nilai konfigurasi \"texinfo_documents\"; dokumen tidak akan ditulis"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "nilai konfigurasi \"texinfo_documents\" mereferensikan dokumen yang tidak dikenal %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "memroses %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "memecahkan referensi..."
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (dalam "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "menyalin berkas pendukung Texinfo"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "kesalahan menulis berkas Makefile: %s"
@@ -856,18 +883,18 @@ msgstr "kesalahan menulis berkas Makefile: %s"
 msgid "The text files are in %(outdir)s."
 msgstr "Berkas teks berada di %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "kesalahan menulis berkas %s: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Berkas XML berada di %(outdir)s."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Berkas pseudo-XML berada di %(outdir)s."
@@ -882,290 +909,302 @@ msgstr "berkas info build rusak: %r"
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Halaman HTML berada di %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Gagal membaca berkas info build: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "nilai konfigurasi html_use_opensearch harus berupa sebuah string"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indeks Umum"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "berikut"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "sebelum"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr "menghasilkan indeks"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr "menulis halaman tambahan"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "menyalin berkas yang dapat diunduh... "
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "tidak dapat menyalin berkas yang dapat diunduh %r: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "menyalin berkas statik... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "tidak dapat menyalin berkas statik %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr "menyalin berkas tambahan"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "tidak dapat menyalin berkas ekstra %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Gagal menulis berkas info build: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "indeks pencarian tidak dapat dimuat, tapi tidak semua dokumen akan dibangun: indeks akan jadi tidak lengkap."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "halaman %s sebanding dengan dua pola dalam html_sidebars: %r dan %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "kesalahan Unicode terjadi saat render halaman %s. Silakan pastikan semua nilai konfigurasi yang berisi konten non-ASCII adalah string Unicode."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Kesalahan terjadi saat render halaman %s.\nAlasan: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr "menyisihkan persediaan obyek"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "js_file yang salah: %r, mengabaikan"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Banyak math_renderers teregistrasi. Namun tidak satu pun math_renderer yang dipilih."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "math_renderer %r yang tidak diketahui diberikan."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "entri html_extra_path %r tidak ada"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "entri html_static_path %r tidak ada"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "berkas logo %r tidak ada"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "berkas favicon %r tidak ada"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dokumentasi %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Berkas LaTeX berada di %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui (pdf)latex\n(gunakan 'make latexpdf' di sini untuk melakukannya secara otomatis)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "tidak ditemukan nilai konfigurasi \"latex_documents\"; dokumen tidak akan ditulis"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "nilai konfigurasi \"latex_documents\" mereferensikan dokumen yang tidak dikenal %s"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Indeks"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Rilis"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "tidak ada opsi Babel yang dikenal untuk bahasa %r"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "menyalin berkas pendukung TeX"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "menyalin berkas pendukung TeX... "
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "menyalin berkas tambahan"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Eksepsi terjadi saat membangun, memulai debugger:"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr "Diinterupsi"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "markup reST salah:"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Kesalahan encoding:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Traceback lengkap telah disimpan di %s, bila ingin melaporkan masalah ini kepada developer."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Kesalahan rekursi:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "Hal ini dapat terjadi dengan berkas sumber yang besar atau sangat dalam bertingkat. Anda dapat secara hati-hati meningkatkan batas standar recursi Python dari 1000 di conf.py contohnya:"
+msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "Terjadi eksepsi:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Mohon juga melaporkan hal ini jika sebuah kesalahan pengguna sehingga lain kali perintah salah yang lebih baik dapat disediakan."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Laporan bug dapat diisi pada tracker di <https://github.com/sphinx-doc/sphinx/issues>. Terima kasih!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "job number seharusnya sebuah bilangan positif"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Untuk informasi lebih banyak, kunjungi <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1182,279 +1221,273 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nMenghasilkan dokumentasi ari berkas sumber.\n\nsphinx-build menghasilkan dokumentasi dari berkas-berkas di SOURCEDIR dan menyimpannya\ndi OUTPUTDIR. Program tersebut mencari berkas 'conf.py' di SOURCEDIR untuk pengaturan\nkonfigurasinya. Alat 'sphinx-quickstart' dapat digunakan untuk menghasilkan berkas templat,\ntermasuk 'conf.py'\n\nsphinx-build dapat membuat dokumentasi dalam beragam format. Sebuah format\ndipilih berdasarkan nama builder pada command line; standarnya\nHTML. Builders pun dapat menjalankan tugas lainnya berhubungan dengan pemrosesan\ndocumentasi.\n\nSecara umum, semua yang usang akan dibuat. Output hanya untuk berkas\npilihan dapat dibuat dengan menentukan berkas satuan.\n"
+msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "path ke berkas sumber"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "path ke direktori output"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "daftar berkas spesifik yang dibuat ulang. Diabaikan jika -a ditentukan"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "opsi umum"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "builder yang digunakan (default: html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "tulis semua berkas (default: hanya tulis berkas yang baru dan diubah)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "jangan pakai saved environment, selalu baca semua berkas"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "path untuk the cached environment dan berkas doctree (default: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "build secara parallel dengan N processes jika memungkinkan (nilai spesial \"auto\" akan menetapkan N ke cpu-count)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "path tempat berkas konfigurasi (conf.py) berada (default: sama seperti SOURCEDIR)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "jalankan tanpa berkas sama sekali, hanya opsi -D"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "override sebuah aturan di berkas konfigurasi"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "masukkan sebuah nilai ke templat HTML"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "define tag: masukkan blok \"only\" dengan TAG"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "mode nit-picky, ingatkan tentang semua referensi yang hilang"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "opsi output konsol"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "tingkatkan verbosity (dapat diulang)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "tanpa output pada stdout, hanya peringatan pada stderr"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "tanpa output sama sekali, peringatan sekalipun"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "siarkan output berwarna (default: auto-detect)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "jangan siarkan output berwarna (default: auto-detect)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "tulis peringatan (dan galat) pada berkas terpilih"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "ubah peringatan menjadi galat"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "tampilkan traceback penuh pada eksepsi"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "jalankan Pdb pada eksepsi"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "tidak dapat mencari berkas %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "tidak dapat menggabungkan opsi -a dan nama berkas"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "tidak dapat membuka berkas peringatan %r: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "argumen opsi -D harus dalam bentuk name=value"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "argumen opsi -A harus dalam bentuk name=value"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "masukkan docstrings secara otomatis dari modules"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "uji snippet kode secara otomatis pada blok doctest"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "tautkan antara dokumentasi Sphinx dari berbagai proyek"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "tulis entri \"todo\" yang dapat ditampilan atau disembunyikan dalam build"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "periksa coverage dokumentasi"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "masukkan math, yang dirender sebagai gambar PNG atau SVG"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "masukkan math, yang dirender di perambah sebagai gambar PNG atau SVG"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "inklusi bersyarat untuk isi berdasarkan nilai konfig"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "masukkan tautan ke sumber kode untuk objek Python yang terdokumentasi"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "buat berkas .nojekyll untuk menerbitkannya di halaman GitHub"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "Mohon masukkan nama path yang sah."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Mohon masukan teks."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Mohon masukkan satu dari %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Mohon ketik salah satu dari 'y' atau 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Mohon masukkan satu suffiks berkas, contohnya '.rst' atau '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "* Perhatian: karakter non-ASCII yang dimasukkan dan encoding terminal tidak diketahui -- menganggap UTF-8 atau Latin-1."
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Selamat datang ke alat quickstart Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Silakan masukkan nilai untuk pengaturan berikut (cukup tekan Enter to\nmenerima nilai bawaan, jika diberikan dalam tanda kurung)."
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr "Masukkan jalur root untuk dokumentasi."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "Root path dokumentasi"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Galat: berkas conf.py telah ditemukan dalam root path terpilih."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart tidak akan menulis ulang proyek Sphinx yang ada."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Silakan masukkan root path baru (atau tekan Enter untuk keluar)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Pisahkan direktori source dan build (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "Nama prefiks untuk dir templat dan static"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "Nama proyek akan muncul di beberapa tempat dalam dokumentasi yang dibuat."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Nama proyek"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Nama(-nama) pembuat"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1463,15 +1496,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Versi proyek"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Rilis proyek"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1481,21 +1514,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Bahasa proyek"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Akhiran berkas sumber"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1503,91 +1536,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Nama dokumen master Anda (tanpa akhiran)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Kesalahan: file master %s telah ditemukan di jalur utama yang dipilih."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart tidak akan menimpa berkas yang sudah ada."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Silakan masukkan nama file baru, atau ganti nama file yang ada dan tekan Enter"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Tunjukkan ekstensi Sphinx berikut mana yang harus diaktifkan:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Catatan: imgmath dan mathjax tidak dapat diaktifkan secara bersamaan. imgmath telah diubah tidak pilih."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Buat Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "Buat berkas perintah Windows? (y/n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Membuat file %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "File %s sudah ada, lewati."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Selesai: Struktur direktori awal telah dibuat."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "di mana \"pembangun\" adalah salah satu pembangun yang didukung, mis. html, lateks, atau periksa tautan."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1597,787 +1630,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nHasilkan file yang diperlukan untuk proyek Sphinx. \n\nsphinx-quickstart adalah alat interaktif yang menanyakan beberapa pertanyaan tentang proyek Anda \ndan kemudian menghasilkan direktori dokumentasi lengkap dan contoh \nMakefile untuk digunakan dengan sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "mode diam"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr "root proyek"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "Opsi struktur"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "jika ditentukan, pisahkan direktori sumber dan pembangunan"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "pengganti dot di _templates dll."
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "Opsi dasar proyek"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "nama proyek"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "nama penulis"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "versi proyek"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "rilis proyek"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "bahasa dokumen"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "akhiran berkas sumber"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "nama dokumen utama"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "gunakan epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Opsi ekstensi"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "aktifkan ekstensi %s"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "aktifkan ekstensi berubah-ubah"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Pembuatan Makefile dan Batchfile"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "buat makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "jangan membuat makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "buat batchfile"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "jangan membuat batchfile"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "gunakan mode-make untuk Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "jangan gunakan make-mode untuk Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "Membuat templat proyek"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "direktori templat untuk berkas templat"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "mendefinisikan variabel templat"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"quiet\" ditentukan, tetapi tidak ada \"project\" atau \"author\" yang ditentukan."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Kesalahan: jalur yang ditentukan bukan direktori, atau file sphinx sudah ada."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart hanya menghasilkan direktori kosong. Silakan tentukan jalur utama baru."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Variabel templat tidak valid: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "Pendeteksian kelebihan telah terdeteksi"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Keterangan tidak valid: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "spesifikasi nomor baris di luar kisaran (1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Tidak dapat menggunakan kedua opsi \"%s\" dan \"%s\""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Berkas yang disertakan %r tidak ditemukan atau gagal membacanya"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Pengkodean %r yang digunakan untuk membaca file yang disertakan %r tampaknya salah, mencoba berikan opsi :encoding:"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objek bernama %r tidak ditemukan disertakan di berkas %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Tidak dapat menggunakan \"lineno-match\" dengan rangkaian \"baris\" yang terpisah"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Spesifikasi baris %r: tidak ada baris yang ditarik dari berkas %r"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Penyusun bagian:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Penyusun modul: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Penulis kode:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Penyusun: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parameter"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Kembali"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Return type"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (fungsi C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (anggota C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (macro C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (tipe C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "anggota"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (variabel C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variabel"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "fungsi"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "anggota"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "union"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerator"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tipe"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variabel"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Baru pada versi %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Berubah pada versi %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Ditinggalkan sejak versi %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "kutipan rangkap %s, contoh lain dalam %s"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "Kutipan [%s] tidak dirujuk."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "Deklarasi rangkap, juga didefinisikan dalam '%s'.\nDeklarasi adalah '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Parameter Templat"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Throws"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "class"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "union"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "konsep"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerator"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "Deklarasi rangkap, juga didefinisikan dalam '%s'.\nNama deklarasi adalah '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (fungsi built-in)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (method %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (class)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variabel global atau konstan)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumen"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (module)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "method"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "duplikasi label persamaan %s, misalnya di %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Math_eqref_format tidak valid: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "keyword"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "object"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "eksepsi"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "statement"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "fungsi built-in"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variabel"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Raises"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (di modul %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (variabel built-in)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (di modul %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (variabel built-in)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (class built-in)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (class di %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (method %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (method class %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (method static %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (method static %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (method class %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (method class %s)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atribut %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Indeks Modul Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "modul"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Akan ditinggalkan"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "method class"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "method static"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "lebih dari satu target ditemukan untuk referensi silang %r: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (obsolet)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktif)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktif"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr "opsi-direktif"
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "role"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "variabel environment; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Deskripsi opsi salah bentuk %r, seharusnya terlihat seperti \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" atau \"+opt args\""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr "opsi baris perintah"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr "Daftar Istilah kata sulit harus didahului dengan baris kosong"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr "Daftar istilah kata sulit tidak boleh dipisahkan oleh garis kosong"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "Daftar istilah kata sulit tampaknya salah format, periksa indentasi"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "daftar istilah"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "token grammar"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "label referensi"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "variabel environment"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "opsi program"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "dokumen"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Indeks Modul"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Pencarian Halaman"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "label rangkap %s, contoh lain dalam %s"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig dinonaktifkan. :numref: diabaikan."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "tidak ada nomor yang ditetapkan untuk %s:%s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "tautan tidak memiliki teks: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "numfig_format tidak valid: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "numfig_format tidak valid: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "konfigurasi baru"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "konfigurasi berubah"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "ekstensi berubah"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "membangun lingkungan bukan versi saat ini"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "direktori sumber telah berubah"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Lingkungan ini tidak kompatibel dengan pembangun yang dipilih, silakan pilih direktori doctree lain."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Gagal memindai dokumen dalam %s: %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Domain %r tidak terdaftar"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr "totree referensikan sendiri ditemukan. Diabaikan"
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "dokumen tidak termasuk dalam toctree"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "lihat %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "lihat juga %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "tipe entri indeks tidak dikenal %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simbol"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "referensi toctree melingkar terdeteksi, mengabaikan: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree berisi referensi ke dokumen %r yang tidak memiliki judul: tidak ada tautan yang akan dihasilkan"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree berisi referensi ke dokumen yang dikecualikan %r"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree berisi referensi ke dokumen yang tidak ada %r"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "berkas gambar tidak dapat dibaca: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "berkas gambar %s tidak dapat dibaca: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr "berkas unduhan tidak dapat dibaca: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s sudah diberi nomor bagian (penomoran bersarang toctree?)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr "Akan membuat berkas %s."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2389,165 +2411,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr "\nLihat secara rekursif dalam <MODULE_PATH> untuk modul dan paket Python dan buat \nsatu berkas reST dengan arahan automodule per paket di <OUTPUT_PATH>. \n\n<EXCLUDE_PATTERN> dapat berupa pola berkas dan/atau direktori yang akan \ndikecualikan dari pembuatan. \n\nCatatan: Secara bawaan skrip ini tidak akan menimpa berkas yang sudah dibuat."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr "jalur ke modul ke dokumen"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "Berkas gaya-fnmatch dan/atau pola direktori untuk dikecualikan dari pembuatan"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr "direktori untuk menempatkan semua keluaran"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "kedalaman maksimum submodul untuk ditampilkan di TOC (bawaan: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "menimpa file yang ada"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "ikuti tautan simbolik. Berdaya bila digabungkan dengan collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "operasikan skrip tanpa membuat file"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr "letakkan dokumentasi untuk setiap modul di halamannya sendiri"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr "termasuk modul \"_private\""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr "nama file daftar isi (bawaan: modul)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "jangan membuat berkas daftar isi"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "jangan membuat judul untuk paket modul/paket (mis. ketika docstrings sudah berisi hal tersebut)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr "letakkan dokumentasi modul sebelum dokumentasi submodul"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "menafsirkan jalur modul sesuai dengan spesifikasi namespaces implisit PEP-0420"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "akhiran berkas (bawaan: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr "menghasilkan proyek penuh dengan sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "menambahkan module_path ke sys.path, digunakan ketika --full diberikan"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr "nama proyek (bawaan: nama modul utama)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr "penulis-(penulis) proyek, digunakan ketika --full diberikan"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr "versi proyek, digunakan ketika --full diberikan"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "rilis proyek, digunakan ketika --full diberikan, bawaan ke --doc-version"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "opsi ekstensi"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s bukan direktori."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "regex tidak valid %r dalam %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Pengujian cakupan di sumber selesai, lihat hasilnya dalam %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "%r regex tidak valid di coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "modul %s tidak dapat diimpor: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "tidak ada '+' atau '-' dalam opsi '%s'."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' bukan opsi yang valid."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' bukan opsi pyversion yang valid"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "tipe TestCode tidak valid"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Pengujian dokumen di sumber selesai, lihat hasil dalam %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "tidak ada kode/keluaran dalam blok %s pada %s:%s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "mengabaikan kode dokumen yang tidak valid: %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2561,11 +2603,11 @@ msgstr "Pengarahan Graphviz tidak dapat memiliki konten dan argumen nama berkas
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Berkas Graphviz eksternal %r tidak ditemukan atau gagal dibaca"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Mengabaikan pengarahan \"graphviz\" tanpa konten."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2575,14 +2617,14 @@ msgid ""
 "%r"
 msgstr "dot tidak menghasilkan berkas output: \n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "perintah dot %r tidak dapat dioperasikan (diperlukan untuk keluaran graphviz), periksa pengaturan graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2592,29 +2634,30 @@ msgid ""
 "%r"
 msgstr "dot keluar dengan kesalahan: \n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format harus salah satu dari 'png', 'svg', tetapi %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr "kode dot %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graph: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graph]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2627,148 +2670,158 @@ msgid ""
 "%r"
 msgstr "convert keluar dengan kesalahan: \n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "Perintah LaTeX %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_latex"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s perintah %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_%s"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr "tampilkan latex %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "inline latex %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Tautan untuk persamaan ini"
 
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "pengimpanan intersphinx telah dipindahkan: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "memuat penyimpanan intersphinx dari %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 "mengalami beberapa masalah dengan beberapa inventaris, tetapi mereka memiliki alternatif berfungsi:"
 
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "gagal mencapai salah satu inventaris dengan masalah berikut:"
 
-#: sphinx/ext/intersphinx.py:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(di %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(dalam %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "pengenal intersphinx %r bukan string. Diabaikan"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[sumber]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Entri TODO ditemukan: %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> terletak di %s, baris %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "entri asli"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr "menyoroti kode modul..."
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Kode modul"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kode sumber untuk %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Tinjauan: kode modul"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Semua modul dimana kode tersedia</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "tanda tangan tidak valid untuk outo %s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "kesalahan saat memformat argumen untuk %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "atribut hilang %s dalam objek %s"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2776,104 +2829,157 @@ msgid ""
 "explicit module name)"
 msgstr "tidak tahu modul mana yang akan diimpor untuk autodocumenting %r (coba letakkan pengarahan \"module\" atau \"currentmodule\" dalam dokumen, atau berikan nama modul yang eksplisit)"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" dalam nama automodule tidak masuk akal"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "argumen tanda tangan atau anotasi kembalian diberikan untuk automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ harus berupa daftar string, bukan %r (dalam modul %s) -- mengabaikan __all__"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr "atribut yang hilang disebutkan dalam :members: atau __all__: modul %s, atribut %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Basis: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias dari :class:`%s`"
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "gagal mengimpor %s"
+msgid "autosummary: failed to import %s"
+msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr "gagal mengurai nama %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "gagal mengimpor objek %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary menghasilkan file .rst secara internal. Tapi source_suffix Anda tidak mengandung .rst. Dilewati."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr "[autosummary] menghasilkan autosummary untuk: %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[autosummary] menulis ke %s"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2888,107 +2994,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nHasilkan ReStructuredText menggunakan pengarahan autosummary.\n\nsphinx-autogen adalah tampilan depan ke sphinx.ext.autosummary.generate. Ini menghasilkan \nfile reStructuredText dari pengarahan autosummary yang terkandung dalam \nfile input yang diberikan.\n\nFormat pengarahan autosummary didokumentasikan dalam \nmodul ``sphinx.ext.autosummary`` dan dapat dibaca menggunakan::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "berkas sumber untuk menghasilkan file rST untuk"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "direktori untuk menempatkan semua keluaran dalam"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "akhiran bawaan untuk berkas (bawaan: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "direktori templat ubahsuai (bawaan: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "mendokumentasikan anggota yang diimpor (bawaan: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Argumen Kata Kunci"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Contoh"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Contoh-contoh"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Catatan"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Parameter lainnya"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "Referensi"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "Peringatkan"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr "Hasil"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Pehatian"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Hati-hati"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Bahaya"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Kesalahan"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Petunjuk"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Penting"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Catatan"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Lihat juga"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Peringatan"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "lanjutan dari halaman sebelumnya"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "berlanjut ke halaman berikutnya"
@@ -3005,181 +3135,181 @@ msgstr "Angka"
 msgid "page"
 msgstr "laman"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Daftar Isi"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Pencarian"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Go"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Lihat Sumber"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Tinjauan"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Selamat Datang! Ini adalah"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "dokumentasi untuk"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "terakhir diperbarui"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indeks dan tabel:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Daftar Isi Lengkap"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "daftar semua seksi dan subseksi"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "pencarian pada dokumentasi ini"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Index Modul Global"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "akses cepat semua modul"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "semua fungsi, class, term"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Index &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Index penuh dalam satu halaman"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Index halaman berdasarkan huruf"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "dapat menjadi besar"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigasi"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Pencarian dalam %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Tentang dokumen ini"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Hak Cipta"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Hak cipta</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Hak cipta %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Terakhir diperbarui pada %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Dibuat menggunakan <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Pencarian %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Topik sebelumnya"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "bab sebelum"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Topik berikutnya"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "bab berikutnya"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Tolong aktifkan JavaScript untuk melakukan pencarian.\n "
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr "Mencari beberapa kata hanya menunjukkan kecocokan yang mengandung\n    semua kata."
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "pencarian"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Hasil Pencarian"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Tidak ada dokumen yang cocok dengan pencarian anda. Pastikan semua kata ditulis dengan benar dan sudah memilih cukup kategori."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Pencarian cepat"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Halaman Ini"
 
@@ -3211,19 +3341,19 @@ msgstr "Perubahan API C"
 msgid "Other changes"
 msgstr "Perubahan lain"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Link permanen untuk headline ini"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Link permanen untuk definisi ini"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Sembunyikan Hasil Pencarian"
 
@@ -3235,12 +3365,12 @@ msgstr "Pencarian"
 msgid "Preparing search..."
 msgstr "Penyiapkan pencarian..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Pencarian selesai, menemukan %s halaman yang cocok dengan kueri pencarian."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", di"
 
@@ -3253,7 +3383,7 @@ msgstr "Buka sidebar"
 msgid "Collapse sidebar"
 msgstr "Tutup sidebar"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Konten"
 
@@ -3272,199 +3402,207 @@ msgstr "Catatan kaki [%s] tidak dirujuk."
 msgid "Footnote [#] is not referenced."
 msgstr "Catatan kaki [#] tidak dirujuk."
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referensi catatan kaki yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "referensi yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referensi kutipan tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referensi istilah yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "lebih dari satu target ditemukan untuk referensi silang 'any' %r: bisa %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s target referensi tidak ditemukan: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "%r target referensi tidak ditemukan: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "Tidak dapat mengambil gambar jarak jauh: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr "Tidak dapat mengambil gambar jarak jauh: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Format gambar tidak dikenal: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "karakter sumber undecodable, menggantinya dengan \"?\": %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr "dilewati"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr "gagal"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "kesalahan membaca: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "kesalahan menulis: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Format tanggal tidak valid. Kutip string dengan kutipan tunggal jika Anda ingin menampilkannya secara langsung: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree berisi ref ke berkas yang tidak ada %r"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "pengecualian saat mengevaluasi hanya ekspresi pengarahan: %s"
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr "Dukungan untuk mengevaluasi sintaks Python 2 sudah usang dan akan dihapus di Sphinx 4.0. Konversi %s ke sintaksis Python 3."
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "peran bawaan %s tidak ditemukan"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format tidak didefinisikan untuk %s"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Tidak ada ID apa pun yang ditugaskan untuk simpul %s"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Link permanen untuk table ini"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Link permanen untuk kode ini"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Link permanen untuk gambar ini"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Tautan ke daftar isi ini"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "Tidak dapat memperoleh ukuran gambar. :scale: option diabaikan."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "%r toplevel_sectioning tidak diketahui untuk kelas %r"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: terlalu besar, diabaikan."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr "judul dokumen bukan simpul Text tunggal"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "simpul judul tidak ditemui dalam bagian, topik, tabel, peringatan atau sisi bilah"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Catatan kaki"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "opsi tabularcolumns dan :widths: opsi diberikan bersamaan. :widths: diabaikan."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "unit dimensi %s tidak valid. Diabaikan"
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "entri indeks tidak diketahui ditemukan tipe %s"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[gambar: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[gambar]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "keterangan tidak di dalam gambar."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "tipe simpul tidak diterapkan: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr "tipe simpul tidak dikenal: %r"
diff --git a/sphinx/locale/it/LC_MESSAGES/sphinx.po b/sphinx/locale/it/LC_MESSAGES/sphinx.po
index c0aeb2e0647..c1d4b705737 100644
--- a/sphinx/locale/it/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/it/LC_MESSAGES/sphinx.po
@@ -1,152 +1,157 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Denis Cappellin <denis@cappell.in>, 2018
 # Paolo Cavallini <cavallini@faunalia.it>, 2013-2017
 # Roland Puntaier <roland.puntaier@chello.at>, 2013
 # Sandro Dentella <sandro@e-den.it>, 2008
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Italian (http://www.transifex.com/sphinx-doc/sphinx-1/language/it/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: it\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "fatto"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "terminato con problemi"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -154,12 +159,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -167,59 +172,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -227,58 +232,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Sezione %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabella %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Listato %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -286,405 +284,430 @@ msgstr "il primary_domain %r non  è stato trovato, tralasciato."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Builtins"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Al livello del modulo"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -693,160 +716,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (in "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -856,18 +883,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -882,290 +909,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indice generale"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "indice"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "successivo"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "precedente"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s documentazione"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Indice"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Release"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1184,277 +1223,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1463,15 +1496,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1481,21 +1514,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1503,91 +1536,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1597,787 +1630,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Didascalia non valida: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Impossibile usare contemporaneamente le opzioni  \"%s\" e \"%s\""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autore della sezione: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autore del modulo: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autore del codice: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autore: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametri"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Ritorna"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Tipo di ritorno"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (funzione C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (membro C )"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (macro C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (tipo C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "membro"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (variabile C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variabile"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funzione"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "membro"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumeratore"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tipo"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variabile"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nuovo nella versione %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Cambiato nella versione %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Deprecato dalla versione %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Parametri del modello"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Solleva"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "classe"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "concetto"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumeratore"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funzione built-in)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metodo)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (classe)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variabile globale o costante)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attributo)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Parametri"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modulo)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metodo"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "dati"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "attributo"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modulo"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "etichetta dell'equazione %s duplicata, altra istanza in %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "keyword"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operatore"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "oggetto"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "eccezione"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "statement"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "funzione built-in"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variabili"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Solleva"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (nel modulo %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (variabile built-in)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (nel modulo %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (variabile built-in)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe built-in)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (classe in %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metodo)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s metodo della classe)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s metodo statico)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s metodo statico)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s metodo della classe)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s metodo della classe)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s attributo)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Indice del modulo Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduli"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Deprecato"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "metodo della classe"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "metodo statico"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (deprecato)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direttiva)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (ruolo)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direttiva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "ruolo"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "variabile d'ambiente, %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "voce del glossario"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "elemento grammaticale"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "etichetta di riferimento"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "variabile d'ambiente"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "opzione del programma"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "documento"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Indice dei moduli"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Cerca"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "vedi %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "vedi anche %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simboli"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2389,165 +2411,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "manca  '+' or'-' nell'opzione '%s'."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' non è un'opzione valida."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2561,11 +2603,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2575,14 +2617,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2592,29 +2634,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[grafico: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[grafico]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2627,148 +2670,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Permalink a questa equazione"
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(in %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[sorgente]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Da fare"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<elemento originale>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(L'<<elemento originale>> si trova in %s, linea %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "riga originale"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[documenti]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Codice del modulo"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Codice sorgente per %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Vista generale: codice del modulo"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Tutti i moduli di cui è disponibile il codice</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2776,104 +2829,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "   Basi: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias per :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2888,107 +2994,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Argomenti parole chiave"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Esempi"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Attenzione"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Attenzione"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Pericolo"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Errore"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Suggerimento"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Importante"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Vedi anche"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Suggerimento"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Avvertimento"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "continua dalla pagina precedente"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3005,181 +3135,181 @@ msgstr ""
 msgid "page"
 msgstr "pagina"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Cerca"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Vai"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Mostra sorgente"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Sintesi"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Benvenuto! Questa è"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "la documentazione per"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "ultimo aggiornamento"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indici e tabelle:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Tabella dei contenuti completa"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "elenca l'insieme delle sezioni e sottosezioni"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "cerca in questa documentazione"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Indice dei moduli"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "accesso veloce ai moduli"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "tutte le funzioni, classi e moduli"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Indice &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Indice completo in una pagina"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indice delle pagine per lettera"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "può essere enorme"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigazione"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Cerca in %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "A proposito di questi documenti"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Ultimo aggiornamento %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Creato con <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Cerca %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Argomento precedente"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "capitolo precedente"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Argomento successivo"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "capitolo successivo"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Attiva JavaScript per abilitare la funzione⏎\ndi ricerca."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "cerca"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Risultati della ricerca"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "La tua ricerca non corrisponde a nessun documento. Verifica che tutte le parole siano scritte correttamente e di aver scelto un numero sufficiente di categorie."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Ricerca veloce"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Questa pagina"
 
@@ -3211,19 +3341,19 @@ msgstr "Modifiche nelle API C"
 msgid "Other changes"
 msgstr "Altre modifiche"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Link a questa intestazione"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Link a questa definizione"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Nascondi i risultati della ricerca"
 
@@ -3235,12 +3365,12 @@ msgstr "Cerca"
 msgid "Preparing search..."
 msgstr "Preparo la ricerca..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Ricerca completata, trovata/e %s pagina/e corrispondenti."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", in "
 
@@ -3253,7 +3383,7 @@ msgstr "Espandi la barra laterale"
 msgid "Collapse sidebar"
 msgstr "Comprimi la barra laterale"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Contenuti"
 
@@ -3272,199 +3402,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Link a questa tabella"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Link a questo codice"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Link a questa immagine"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Link a questo indice"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Note a piè di pagina"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[immagine: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[immagine]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/ja/LC_MESSAGES/sphinx.po b/sphinx/locale/ja/LC_MESSAGES/sphinx.po
index 1477b3d8a2d..68e624f8b72 100644
--- a/sphinx/locale/ja/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ja/LC_MESSAGES/sphinx.po
@@ -1,7 +1,7 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # shirou - しろう <shirou.faw@gmail.com>, 2013
 # Akitoshi Ohta <fire.kuma8@gmail.com>, 2011
@@ -11,9 +11,9 @@
 # sutefu7, 2019-2020
 # shirou - しろう <shirou.faw@gmail.com>, 2017
 # Taizo Ito <taizo.ito@hennge.com>, 2019
-# Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>, 2013-2016
-# Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>, 2016-2017,2019
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016-2017,2019
+# Takayuki Shimizukawa <shimizukawa@gmail.com>, 2013-2016
+# Takayuki Shimizukawa <shimizukawa@gmail.com>, 2016-2017,2019
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016-2017,2019
 # Tetsuo Koyama <tkoyama010@gmail.com>, 2020
 # tomo, 2019
 # shirou - しろう <shirou.faw@gmail.com>, 2014
@@ -22,141 +22,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-23 04:15+0000\n"
-"Last-Translator: sutefu7\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\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"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: ja\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "conf.py が設定ディレクトリに存在しません (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "ソースディレクトリが存在しません (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "出力先ディレクトリにはソースディレクトリと異なるディレクトリを指定してください"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s を実行中"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr "セキュリティ上の理由から、macOSおよびpython3.8以降では並列モードが無効になっています。 詳細については https://github.com/sphinx-doc/sphinx/issues/6803 をご覧ください。"
+msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "このプロジェクトはSphinx v%s以降のバージョンでなければビルドできません。"
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "出力先ディレクトリを作成しています"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "拡張機能のセットアップ中 %s:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "conf.pyにある'setup'はPythonのcallableではありません。定義を修正してcallableである関数にしてください。これはconf.pyがSphinx拡張として動作するのに必要です。"
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "翻訳カタログをロードしています [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "完了"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "翻訳が用意されていません"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr "保存された環境データを読み込み中"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "失敗: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "ビルダーが選択されていないので、デフォルトの html を使用します"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "成功"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "完了（問題あり）"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "警告%s、%sをビルドします（警告はエラーとして扱われます）。"
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "警告%s、%sをビルドします（警告はエラーとして扱われます）。"
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "ビルド %s, %s warning."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "ビルド %s, %s 警告."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "ビルド %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "nodeクラス %r は既に登録されています。visitor関数は上書きされます"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "ディレクティブ %r は既に登録されています。ディレクティブは上書きされます"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "ロール %r は既に登録されています。ロールは上書きされます"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -164,12 +169,12 @@ msgid ""
 "explicit"
 msgstr "拡張 %s は並列読み込みが可能かどうかを宣言していないため、おそらく並列読み込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "%s拡張は並列読み込みに対して安全ではありません"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -177,59 +182,59 @@ msgid ""
 "explicit"
 msgstr "拡張 %s は並列書き込みが可能かどうかを宣言していないため、おそらく並列書き込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "%s拡張は並列書き込みに対して安全ではありません"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "直列で %sします"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "設定値の辞書 %r は上書きないため無視されました (%r を使って個別に設定してください)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "%r は設定値 %r の正しい値ではないため無視されました"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "%r は正しい型ではないため無視されました"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "不明な設定値 %r による上書きは無視されました"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "%s という設定値はありません"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "設定値 %r は既に登録済みです"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "設定ファイルに文法エラーが見つかりました: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "設定ファイル（あるいはインポートしたどれかのモジュール）がsys.exit()を呼びました"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -237,58 +242,51 @@ msgid ""
 "%s"
 msgstr "設定ファイルにプログラム上のエラーがあります:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, 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:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "%s 章"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "図 %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "表 %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "リスト %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr " 設定値 `{name}` に `{current}` が指定されましたが、  {candidates} のいずれかを指定してください。"
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "設定値 `{name}' に `{current.__name__}' 型が指定されていますが、 {permitted} 型を指定してください。"
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "設定値 `{name}' に `{current.__name__}' 型が指定されています。デフォルト値は `{default.__name__}' です。"
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "設定値 %r にstr型で非アスキー文字列が設定されました。これはUnicodeエラーを引き起こす可能性があります。 %r のようにUnicode型を使って下さい。"
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -296,405 +294,430 @@ msgstr "primary_domain %r が見つかりません。無視します。"
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "Sphinx-2.0から、 master_doc のデフォルト値として \"index\" を使用します。 \"master_doc = 'contents'\" をconf.pyに設定してください。"
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "イベント %r はすでに登録されています"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "不明なイベント名: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "needs_extensions設定で %s 拡張が要求されていますが、その拡張がありません。"
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "このプロジェクトは拡張 %s の %s 以降のバージョンが必要なため、現在のバージョン(%s)ではビルドできません。"
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Pygments に %r というlexerがありません"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "リテラルブロックを \"%s\" として解釈できませんでした。ハイライト処理をスキップします。"
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "ドキュメントを読めません。無視します。"
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "ビルダークラス %s には\"name\"属性がありません"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "ビルダー %r (モジュール %s) がすでに登録されています"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "ビルダー名 %s は登録されておらず、entry pointにもありません"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "ビルダー名 %s は登録されていません"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "ドメイン %s はすでに登録されています"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "ドメイン %s はまだ登録されていません"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "ディレクティブ %r は既に%sドメインに登録されています"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "ロール %r は既にドメイン%sに登録されています"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "インデックス %r はすでに%sドメインに登録されています"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "object_type %r はすでに登録されています"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "classref_type %r はすでに登録されています"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r はすでに登録されています"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "%r のsource_parserはすでに登録されています"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "%s のsource_parserは登録されていません"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "%r のTranslatorはすでに登録されています"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node() のキーワード引数は (visit, depart) の形式で関数をタプルで指定してください: %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r はすでに登録されています"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "数式レンダラー %s はすでに登録されています"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "拡張 %r はSphinxのバージョン%sでSphinxに統合されています。この拡張は無視されます。"
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "元の例外:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "拡張 %s をimportできません"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "拡張 %r には setup() 関数がありません。これは本当にSphinx拡張ですか？"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "このプロジェクトで使われている拡張 %s はSphinx v%s 以降が必要なため、現在のバージョンではビルドできません。"
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "拡張 %r のsetup()関数が、対応していないオブジェクトを返しました。Noneまたはメタデータ辞書を返してください"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "テーマ %r に \"theme\" 設定がありません"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "テーマ %r に \"inherit\" 設定がありません"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "テーマ %r が %r から継承されていますが、見つかりませんでした"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "設定 %s.%s がテーマ設定にありません"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "サポートされていないテーマオプション %r が指定されました"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "テーマパス上のファイル %r は正しいzipファイルではないか、テーマを含んでいません"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme への依存はバージョン1.4.0で解除されました。手動でインストールを行ってください(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "テーマ %r がありません(theme.confが見つからない?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "%sビルダー向けの画像形式が見つかりません: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "%sビルダー向けの画像形式が見つかりません: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "ビルド中 [mo]: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "出力中..."
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "全%d件のpoファイル"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "指定された %d 件のpoファイル"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "更新された %d 件のpoファイル"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "全てのソースファイル"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "コマンドラインに指定されたファイル %r はソースディレクトリ以下にないため無視されます"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "コマンドラインに指定されたファイル %r がないため無視されます"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "コマンドラインで指定された%d件のソースファイル"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "更新された %d 件のソースファイル"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "ビルド中 [%s]: "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "更新されたファイルを探しています... "
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "%d 件見つかりました"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "見つかりませんでした"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr "環境データを保存中"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr "整合性をチェック中"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "更新が必要な対象はありませんでした"
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "環境データを更新中"
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s 件追加, %s 件更新, %s 件削除"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "ソースを読み込み中..."
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "ワーカーの終了を待っています..."
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "書き込むdocname: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "preparing documents"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "Tocエントリーが重複しています: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "画像をコピー中... "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "画像ファイル %r をPILで読み込めないため、そのままコピーします"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "画像ファイル %r をコピーできません: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "画像ファイル %r を書き込めません: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr "Pillowがインストールされていません。代わりに画像をコピーします"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "ファイル %s を書き込み中..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "不明なmimetype %sのため無視します"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "ファイル %s を書き込み中..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "ファイルは%(outdir)sにあります"
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "バージョン %s での変更はありません"
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "概要ファイルを書き出し中..."
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "組み込み"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "モジュールレベル"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "ソースファイルをコピー中..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "Changelog作成中に %r を読み込めませんでした"
@@ -703,160 +726,164 @@ msgstr "Changelog作成中に %r を読み込めませんでした"
 msgid "The dummy builder generates no files."
 msgstr "dummyビルダーはファイルを出力しません"
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "ePubファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_language\" (あるいは \"language\") の指定が必要です"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "EPUB3では設定値  \"epub_uid\" はXML NAMEにするべきです"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_title\" (あるいは \"html_title\") の指定が必要です"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_author\" の指定が必要です"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_contributor\" が必要です"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_description\" が必要です"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_publisher\" の指定が必要です"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_copyright\" (あるいは \"copyright\") の指定が必要です"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_identifier\" の指定が必要です"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"version\" が必要です"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "無効な css_file %r は無視されました"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "メッセージカタログは%(outdir)sにあります。"
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "指定された %d 件のテンプレートファイル"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "テンプレートの読み込み中..."
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "メッセージカタログを出力中... "
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "上記の出力結果、または %(outdir)s /output.txt を見てエラーを確認してください"
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "アンカー '%s' が見つかりません"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "リンクが切れています: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "アンカー '%s' が見つかりません"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "マニュアルページは %(outdir)s にあります。"
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "設定値 \"man_pages\" が見つかりません。マニュアルページは書かれません"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "書き込み中"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "設定値 \"man_pages\" が不明なドキュメント %s を参照しています"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML ページは%(outdir)sにあります。"
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "ドキュメントを1ページにまとめています"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "追加のファイルを出力"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Texinfoファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nmakeinfo コマンドで処理するため、そのディレクトリで 'make' を実行してください。\n（これを自動的に行うには、ここで 'make info' を使用してください）。"
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "設定値 \"texinfo_documents\" が見つかりません。ドキュメントは書き込まれません"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "設定値 \"texinfo_documents\" は、不明なドキュメント %s を参照しています"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "処理中 %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "参照を解決しています..."
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (in "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "Texinfo 関連ファイルをコピーしています"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "Makefile の書き込みエラー: %s"
@@ -866,18 +893,18 @@ msgstr "Makefile の書き込みエラー: %s"
 msgid "The text files are in %(outdir)s."
 msgstr "テキストファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "ファイル書き込みエラー %s: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "XMLファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "pseudo-XMLファイルは%(outdir)sにあります。"
@@ -892,290 +919,302 @@ msgstr "build info ファイルが壊れています: %r"
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTMLページは%(outdir)sにあります。"
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "build info ファイルの読み込みに失敗しました: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y年%m月%d日"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "html_use_opensearch 設定値は文字列で指定してください"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "総合索引"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "索引"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "次へ"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "前へ"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr "索引を生成中"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr "追加のページを出力中"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "ダウンロードファイルをコピー中..."
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "ダウンロードファイル %r をコピーできません: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "静的ファイルをコピー中... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "静的ファイル %r をコピーできません"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr "extraファイルをコピー中"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "extraファイル %r をコピーできませんでした"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "build info ファイル %r の出力に失敗しました"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "検索インデックスを読み込めず、ドキュメントビルドの一部が不完全です。"
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "ページ %s がhtml_sidebarsの複数のパターンに一致しました: %r と %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "ページ%sの読み込み中にUnicodeエラーが発生しました。非アスキー文字を含む設定値は全てUnicode文字列にしてください。"
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "%sページのレンダリング中にエラーが発生しました。\n理由: %r "
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr "オブジェクト インベントリを出力"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr "%s の検索インデックスを出力"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "無効な js_file %r は無視されました"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "複数の math_renderer が登録されています。しかし math_renderer は選択されていません。"
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "不明な math_renderer %r が指定されました。"
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path %r が見つかりません"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "html_extra_path %r がoutdir内に配置されます"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "html_static_path %r が見つかりません"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "html_static_path %r がoutdir内に配置されます"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "ロゴファイル %r がありません"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "favicon ファイル %r がありません"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s ドキュメント"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTeXファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\n(pdf)latex コマンドで処理するために、そのディレクトリで 'make' を実行してください。\n（これを自動的に行うには、ここで 'make latexpdf' を使用してください）。"
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "設定値 \"latex_documents\" が見つかりません。ドキュメントは書き込まれません"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "設定値 \"latex_documents\" は、不明なドキュメント %s を参照しています"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "索引"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "リリース"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "%r 言語向けの 既知の Babel オプションはありません"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "TeX 関連ファイルをコピーしています"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "TeX 関連ファイルをコピー中..."
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "追加のファイルをコピーしています"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr "不明な設定値 latex_elements[%r] は無視されました。"
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r に \"theme\" 設定がありません"
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r に \"%s\" 設定がありません"
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "ビルド中に例外が発生しました。デバッガを起動します:"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr "割り込まれました！"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "reST マークアップエラー:"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "エンコードエラー:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "完全なトレースバックを%sに保存しました。問題を開発者に報告するときに添付してください。"
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "再起呼び出しエラー:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "この例外エラーは、非常に大きな、または深くネストされたソースファイルで発生する可能性があります。再帰処理の呼び出しの上限値 1000 は conf.py で変更できますが、慎重に行ってください。"
+msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "例外が発生しました"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "次期バージョンでのエラーメッセージ改善のために、ユーザーエラーの場合にも報告してください。"
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "バグ報告はこちらにお願いします <https://github.com/sphinx-doc/sphinx/issues> 。ご協力ありがとうございます！"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "ジョブ番号は正数でなければなりません"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "詳細は <http://sphinx-doc.org/> をご覧ください。"
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1192,296 +1231,290 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nソースファイルからドキュメントを生成します。\n\nsphinx-build は、SOURCEDIR 内のファイルをもとにドキュメントを生成し、\nOUTPUTDIR 内に配置します。またコンフィグ\n設定用に SOURCEDIR 内から\n 'conf.py' を探します。'sphinx-quickstart' ツールを使うと\n 'conf.py' を含むテンプレートファイルを生成することができます。\n\nsphinx-build は、さまざまな形式のドキュメントを作成することができます。フォーマットは、\nコマンドラインでビルダー名を指定して選択します。デフォルトは\nHTML です。ビルダーはドキュメント化処理に関連した他のタスクも実行できます。\n\nデフォルトでは、古いものはすべてビルドされています。個別にファイル名を指定することで、\n選択したファイルのみ出力することもできます。\n"
+msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "ドキュメントソースファイルへのパス"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "出力先ディレクトリへのパス"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "再構築するための設定ファイルのリスト。 -a が指定されている場合は無視されます"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "一般的なオプション"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "使用するビルダー（デフォルト：html）"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "すべてのファイルに書き込む（デフォルト: 新規ファイルまたは変更されたファイルのみ）"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "保存された環境は使わず、常に全てのファイルを読み込む"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "キャッシュされた環境とDoctreeファイルへのパス（デフォルト：OUTPUTDIR/.doctrees）"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "可能な場合、ビルドを N 個のプロセスで並列実行する（特別な値 \"auto\" は N を cpu-count に設定する）"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "設定ファイル（conf.py）がある場所のパス（デフォルト：SOURCEDIRと同じ場所）"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "設定ファイルを使用せず、-Dオプションのみを使用"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "設定ファイルの設定を上書きする"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "HTMLテンプレートに値を渡す"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "定義タグ: TAG ブロック\"のみ\"含む"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "nit-picky モード。不足しているすべての参照について警告する"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "コンソール出力オプション"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "精度の増加（繰り返し可能）"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "標準出力には出力せず、標準エラー出力に警告を出すのみ"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "何も出力せず、警告もしない"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "色分けで出力する（デフォルト：自動検出）"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "色分けの出力をしない（デフォルト：自動検出）"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "指定ファイルに警告（およびエラー）を書き込む"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "警告をエラーとして扱う"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr "-Wを指定すると、警告が表示されたときは実行を続ける"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "例外時にフルトレースバックを表示する"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "例外が発生したときにPdbを実行する"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "ファイル %r が見つかりません"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "-aオプションとファイル名を組み合わせることはできません"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "警告ファイル %r を開けません: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "-Dオプション引数は name = value の形式でなければなりません"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "-Aオプション引数は name = value の形式でなければなりません"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "モジュールから自動的に docstring を挿入する"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "doctest ブロック内のコードスニペットを自動的にテストする"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "異なるプロジェクトのSphinxドキュメント間のリンク"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "ビルド時に表示または非表示にできる \"todo\" エントリを書く"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "ドキュメントの適用範囲を確認する"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "PNG または SVG 画像としてレンダリングされた数学を含む"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "MathJax によってブラウザにレンダリングされた数学を含む"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "設定値に基づくコンテンツの条件付き包含"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "文書化された Python オブジェクトのソースコードへのリンクを含める"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "GitHub ページにドキュメントを公開するための .nojekyll ファイルを作成する"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "有効なパス名を入力してください。"
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "何か入力してください。"
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "%sのいずれかを入力してください。 "
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "'y' または 'n' を入力してください。"
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "ファイルの拡張子を入力してください。例:  '.rst' または '.txt'。"
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "*注：ASCII 以外の文字が入力され、端末のエンコードが不明です -- UTF-8またはLatin-1 を想定しています。"
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Sphinx %s クイックスタートユーティリティへようこそ。"
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "以下の設定値を入力してください（Enter キーのみ押した場合、\nかっこで囲まれた値をデフォルト値として受け入れます）。"
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr "選択されたルートパス: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr "ドキュメントのルートパスを入力してください。"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "ドキュメントのルートパス"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "エラー：選択されたルートパスに既存の conf.py が見つかりました。"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart は、既存の Sphinx プロジェクトを上書きしません。"
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "新しいルートパスを入力してください（または Enter を押すことで終了します）。"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Sphinx 出力用のビルドディレクトリを配置する方法は2つあります。\nルートパス内にある \"_build\" ディレクトリを使うか、\nルートパス内に \"source\" と \"build\" ディレクトリを分ける方法です。"
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "ソースディレクトリとビルドディレクトリを分ける（y / n）"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "プロジェクトのルートディレクトリに 2つ以上のディレクトリが作成されます。\nカスタマイズしたHTMLテンプレート用の\"_templates\"ディレクトリと、カスタマイズしたスタイルシート等を置く\"_static\"ディレクトリがあります。\nこれらのディレクトリは \"_\" で始まっていますが、別の文字(\".\"など)で始まるように指定できます。"
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "テンプレートと静的ディレクトリの名前プレフィックス"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "プロジェクト名は、ビルドされたドキュメントのいくつかの場所にあります。"
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "プロジェクト名"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "著者名（複数可）"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr "Sphinx には、ソフトウェアに対して \"バージョン\" と \"リリース\" という概念が\nあります。各バージョンは複数のリリースを持つことができます。\n例えば、Python だとバージョンが 2.5 や 3.0 のように分かれているように、\nリリースも 2.5.1 や 3.0a1 のように分けて持つことができます。もしこのような多重構成が必要ない場合は、\n両方を同じ値に設定するだけです。"
+msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "プロジェクトのバージョン"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "プロジェクトのリリース"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1491,21 +1524,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "ドキュメントを英語以外の言語で書く場合は、\n 言語コードで言語を選択できます。Sphinx は生成したテキストをその言語に翻訳します。\n\nサポートされているコードのリストについては、\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language を参照してください。"
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "プロジェクトの言語"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr "拡張子の名前はソースファイルに使います。\n通常は \".txt\" または \".rst\" です。これらの拡張子を持つファイルのみがドキュメントと見なされます。"
+msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "ソース・ファイルサフィックス"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1513,91 +1546,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr "1つのドキュメントは、\"コンテンツツリー\"の最上位ノードと\n見なされるという点で特別です。つまり、それはドキュメントにおける階層構造のルートである\nということです。通常、これは \"index\" ですが、\n\"index\" ドキュメントがカスタムテンプレートの場合、これを別のファイル名に設定することもできます。"
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "マスター文書の名前（拡張子を除く）"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "エラー：マスタファイル %s は、選択されたルートパス上で既に存在します。"
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart は既存のファイルを上書きしません。"
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "新しいファイル名を入力するか、既存のファイルの名前を変更してEnterキーを押してください。"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "次の Sphinx 拡張機能のうちどれを有効にするかを指定します。"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "注：imgmath と mathjax を同時に有効にすることはできません。 imgmath は未選択になります。"
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Makefile と Windows コマンドファイルは生成することができるので、\n後は実行するだけです。例えば、直接 sphinx-build を実行する代わりに `make html` を\n実行します。"
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Makefile を作成しますか？ （y/n）"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "Windows コマンドファイルを作成しますか？（y/n）"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "ファイル %s を作成しています。"
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "ファイル %s は既に存在しますのでスキップします。"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "終了：初期ディレクトリ構造が作成されました。"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "マスターファイル %s を作成して\n他のドキュメントソースファイルを作成します。"
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "次のように Makefile を使ってドキュメントを作成します。\n make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "次のように、ドキュメントを構築するには sphinx-build コマンドを使用してください。\n sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "\"builder\" はサポートされているビルダーの 1 つです。 例: html, latex, または linkcheck。"
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1607,787 +1640,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nSphinx プロジェクトに必要なファイルを生成します。\n\nsphinx-quickstart は、いくつかの質問であなたの\nプロジェクトを生成するためのディレクトリと、sphinx-build と一緒に使える\nサンプルのMakefileを作成してくれるインタラクティブなツールです。\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "Quiet モード"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr "project root"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "構成オプション"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "記述した場合、ソースとビルドのディレクトリを分割します。"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "_templates などのドットの置き換え"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "プロジェクトの基本オプション"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "プロジェクト名"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "著者名"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "プロジェクトのバージョン"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "プロジェクトのリリース"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "ドキュメント言語"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "ソース・ファイルサフィックス"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "マスタードキュメント名"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "epubを利用する"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "拡張オプション"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "%s 拡張を有効にする"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "任意の拡張を有効にする"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Makefileとbatファイルの生成オプション"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "makefileを作成する"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "makefileを作成しない"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "batファイルを作成する"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "batファイルを作成しない"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "Makefile / make.bat 向けに make-mode を使う"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "Makefile / make.bat 向けに make-mode を使わないでください。"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "プロジェクトテンプレート"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "テンプレートファイルのテンプレートディレクトリ"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "テンプレート変数の定義"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"quiet\" が指定されていますが、 \"project\" または \"author\" のいずれも指定されていません。"
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "エラー：指定されたパスはディレクトリではないか、または sphinx ファイルが既に存在します。"
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart は空のディレクトリにのみ生成します。新しいルートパスを指定してください。"
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "無効なテンプレート変数: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "過度なインデント解除が検出されました"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "不正な caption です: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "行番号の指定が範囲外です (1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "\"%s\" と \"%s\" のオプションは同時に使用できません"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "インクルードファイル %r が見つからないか読み込めません"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "エンコーディング %r はインクルードファイル %r の読み込みに適さないようです。:encoding: オプションを追加してみてください"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "%r という名前のオブジェクトがインクルードファイル %r 内に見つかりません"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr " \"lineno-match\" は不連続な \"lines\" に対して使用できません"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "指定された %r に一致する行がインクルードファイル %r にありませんでした"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "この節の作者: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "モジュールの作者: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "コードの作者: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "作者: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "パラメータ"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "戻り値"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "戻り値の型"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (C の関数)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C のメンバ変数)"
-
-#: sphinx/domains/c.py:191
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C macro)"
-msgstr "%s (C のマクロ)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C のデータ型)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "のメンバ変数"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C の変数)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "変数"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "の関数"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "のメンバ変数"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "のマクロ"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "union"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "列挙型"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerator"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "のデータ型"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "変数"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
-msgstr "%s のCオブジェクト記述、 %s の他の​​インスタンスを複製し、そのうちの1つに :noindex: を使用します"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "バージョン %s で追加"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "バージョン %s で変更"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "バージョン %s で非推奨"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "引用 %s はすでに %s で使われています"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "引用 [%s] は参照されていません。"
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "'%s' 内で定義されている宣言が重複しています。\n宣言場所は '%s' です。"
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "テンプレートパラメータ"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "例外"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "クラス"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "union"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "コンセプト"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "列挙型"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerator"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "'%s' 内で定義されている宣言が重複しています。\n宣言名は '%s' です。"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (組み込み関数)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s のメソッド)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (クラス)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (グローバル変数または定数)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s の属性)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "引数"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (モジュール)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "メソッド"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "データ"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "の属性"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "モジュール"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "%s の記述 %s はすでに %s で %s が使われています"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "数式 %s のラベルはすでに %s で使われています"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "無効な math_eqref_format: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "キーワード"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "演算子"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "オブジェクト"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "例外"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "文"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "組み込み関数"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "変数"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "例外"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s モジュール)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (組み込み変数)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s モジュール)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (組み込み変数)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (組み込みクラス)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s のクラス)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s のメソッド)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s のクラスメソッド)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s の静的メソッド)"
+msgid "%s() (%s property)"
+msgstr "%s() (%s のプロパティ)"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s の静的メソッド)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s のクラスメソッド)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s のクラスメソッド)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s の属性)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr "%s() (%s のプロパティ)"
+msgid "%s (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Pythonモジュール索引"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "モジュール"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "非推奨"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "クラスメソッド"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "の静的メソッド"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "%s のオブジェクト記述、 %s の他の​​インスタンスを複製し、そのうちの1つに :noindex: を使用します"
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "相互参照 %r に複数のターゲットが見つかりました: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (非推奨)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (ディレクティブ)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (ディレクティブオプション)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (ロール)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "ディレクティブ"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr "ディレクティブオプション"
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "ロール"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "%s の記述 %s はすでに %s で使われています"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "環境変数; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "不正なオプションの説明 %r は、\"opt\"、\"-opt args\"、\"--opt args\"、\"/opt args\" または \"+opt args\" のようになります。"
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr "%s コマンドラインオプション"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr "コマンドラインオプション"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr "用語集の前に空行が必要です"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr "用語集の用語は空行で区切ってはいけません"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "用語集のフォーマットが間違っているようです。インデントを確認してください"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "用語集の項目"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "文法トークン"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "参照ラベル"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "環境変数"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "プログラムオプション"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "document"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "モジュール索引"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "検索ページ"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "ラベル %s はすでに %s で使われています"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "%s の記述 %s はすでに %s で使われています"
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig は無効です。:numref: は無視されます。"
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "%s に番号が割り当てられていません: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "リンクにキャプションがありません: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "無効な numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "無効な numfig_format: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "新しい設定"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "変更された設定"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "変更された拡張"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "ビルド環境のバージョンが最新ではありません"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "ソースディレクトリが変更されました"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "この環境は選択したビルダーと互換性がありません。別の doctree ディレクトリーを選択してください。"
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "%s のドキュメントをスキャンできませんでした: %r "
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "ドメイン %r はまだ登録されていません"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr "自己参照している toctree が見つかりました。無視します。"
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "ドキュメントはどの toctree にも含まれていません"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "%sを参照"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "%sも参照"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "不明なインデックスエントリタイプ %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "記号"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "循環参照している toctree が検出されましたので無視します: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree にはタイトルのないドキュメント %r への参照が含まれています: リンクは生成されません"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree に除外したドキュメントへの参照が含まれています %r"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree に存在しないドキュメントへの参照が含まれています %r"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "画像ファイルが読み込めません: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "画像ファイル %s が読み込めません: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr "ダウンロードファイルが読み込めません: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s はすでにセクション番号が割り当てられています (入れ子になった番号の toctree ?)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr "ファイル %s を作成したものとします。"
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2399,165 +2421,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr "\n<MODULE_PATH> 内を再帰的に調べてPython のモジュールとパッケージ、\n後は1つのreST ファイルを <OUTPUT_PATH> 内にあるパッケージ毎の automodule ディレクティブに作成します。\n\n<EXCLUDE_PATTERN> は、ファイル、またはディレクトリ、または両方のパターンを\n生成処理から除外することができます。\n\n注：デフォルトでは、このスクリプトはすでに作成されているファイルを上書きしません。"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr "ドキュメントへのモジュールパス"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "生成処理から除外するための、ファイル、ディレクトリ、または両方のパターンを記した fnmatch-style 形式"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr "すべての生成データを配置するディレクトリ"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "目次に表示するサブモジュールの最大深度 (デフォルト: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "存在するファイルは上書きする"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "シンボリックリンクをたどります。collective.recipe.omeletteと組み合わせると強力です。"
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "ファイルを作成せずにスクリプトを実行する"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr "各モジュールのドキュメントをそれぞれのページに配置する"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr "\"_private\" モジュールを含めます。"
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr "目次のファイル名 (デフォルト: モジュール)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "目次ファイルを生成しない"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "module/package パッケージの見出しを生成しない (例: docstring にすでにそれらが含まれている場合など)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr "サブモジュールのドキュメントの前に、モジュールのドキュメントを置く"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "PEP-0420 暗黙の名前空間の指定に従って、モジュールパスを解釈する"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "ファイルの拡張子 (デフォルト: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr "sphinx-quickstart を使って完全なプロジェクトを生成する"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "module_pathを sys.path に追加します。--full が与えられたときに使用されます。"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr "プロジェクト名 (デフォルト: ルートモジュール名)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr "プロジェクト著者名(複数可)。--full が与えられたときに使用されます。"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr "プロジェクトバージョン。--full が与えられたときに使用されます。"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "プロジェクトのリリースバージョン。--full が与えられたときに使用されます。デフォルトは --doc-version"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "拡張オプション"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s はディレクトリではありません。"
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "無効な正規表現 %r が %s 内に見つかりました"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "ソース内のカバレッジのテストが終了したら、%(outdir)spython.txt の結果を確認してください。"
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "coverage_c_regexes 内に無効な正規表現 %r があります"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "モジュール %s をインポートできませんでした: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "'%s' オプション内に '+' または '-' が不足しています"
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' は正しいオプションではありません"
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' は正しい pyversion オプションではありません"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "無効な TestCode タイプ"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "ソース内の doctests のテストが終了したら、%(outdir)s/output.txt の結果を確認してください。"
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "%sブロックにあるコード/出力 が %s にありません: %s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "無効な doctest コードは無視されます: %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "====================== 最も遅い読み取り時間 ======================="
@@ -2571,11 +2613,11 @@ msgstr "Graphviz ディレクティブはコンテンツとファイル名の両
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "外部の Graphviz ファイル %r が見つからないか読み込めません"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "コンテンツのない \"graphviz\" ディレクティブを無視します"
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2585,14 +2627,14 @@ msgid ""
 "%r"
 msgstr "dotは出力ファイルを生成しませんでした:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot コマンド %r は実行できません (graphviz 出力のために必要です)。graphviz_dot の設定を確認してください"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2602,30 +2644,31 @@ msgid ""
 "%r"
 msgstr "dot はエラー終了しました:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format は %r ではなく 'png' か 'svg' でなければなりません"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr "dot コード %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[グラフ: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[グラフ]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr "convert コマンド %r は実行できません。image_converter の設定を確認してください"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
+msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
 #, python-format
@@ -2637,148 +2680,158 @@ msgid ""
 "%r"
 msgstr "変換処理はエラー終了しました:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "convert コマンド %r は実行できません。image_converter の設定を確認してください"
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "LaTeX コマンド %r を実行できません (数式表示のために必要です)。imgmath_latex の設定を確認してください"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s コマンド %r を実行できません (数式表示のために必要です)。imgmath_%s の設定を確認してください"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr "latex の表示 %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "latex のインライン表示 %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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 "intersphinx インベントリは移動しました: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "%s から intersphinx インベントリをロード中..."
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(in %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(in %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "intersphinx 識別子 %r は文字列ではありません。無視します"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr "intersphinx_mapping [%s] の読み取りに失敗しました。無視します: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[ソース]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "課題"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "TODO エントリーが見つかりました: %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> は、 %s の %d 行目です)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "元のエントリ"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr "モジュールコードをハイライトしています..."
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[ドキュメント]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "モジュールコード"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s のソースコード</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "概要: モジュールコード"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>全モジュールのうち、コードを読めるもの</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "auto%s (%r) の署名が無効です"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "%sの引数のフォーマット中にエラーが発生しました: %s "
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "オブジェクト %s に属性 %s がありません"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autodoc: ドキュメント化する %r の決定に失敗しました。次の例外が発生しました:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2786,104 +2839,157 @@ msgid ""
 "explicit module name)"
 msgstr "ドキュメントの自動生成 %r のためにどのモジュールをインポートするのか分かりません (ドキュメントに \"module\"または \"currentmodule\"ディレクティブを配置するか、明示的なモジュール名を指定してください)"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "automodule 名の \"::\" は意味がありません"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "automodule に与えられた署名引数、または戻り値となるアノテーション %s"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ は文字列のリストでなければなりません。%r (%s モジュールの中) ではないです -- ignoring __all__"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr ":members: または __all__ に記載されている属性がありません: モジュール %s、属性 %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "ベースクラス: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr ":class:`%s` のエイリアス"
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "%rのtype_commentを解析できませんでした: %s"
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "autosummary は除外したドキュメント %r を参照しています。無視されます。"
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary: stubファイルが見つかりません%r。autosummary_generate設定を確認してください。"
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "%s のインポートに失敗しました"
+msgid "autosummary: failed to import %s"
+msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr "%sの名前を解析できませんでした "
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "%sオブジェクトをインポートできませんでした "
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: ファイルが見つかりません: %s"
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary は内部的に rst ファイルを生成します。しかしあなたの source_suffix は rst ファイルに含まれていませんでした。スキップします。"
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autosummary: ドキュメント化する %r の決定に失敗しました。次の例外が発生しました:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr "[autosummary] %s の autosummary を生成中"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[autosummary] %s に書き込み中"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr "[autosummary] %rのインポートに失敗しました: %s"
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2898,107 +3004,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nautosummary ディレクティブを使って ReStructuredText を生成します。\n\nsphinx-autogen は sphinx.ext.autosummary.generate のフロントエンドです。\n入力されたファイルを含む autosummary ディレクティブから reStructuredText ファイルを\n生成します。\n\nautosummary ディレクティブのフォーマットは\n``sphinx.ext.autosummary`` に記載されています。Pythonモジュールと :: を使って読むことができます。\n\npydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "rST ファイルを生成するためのソースファイル"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "すべての生成データを配置するディレクトリ"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "ファイルのデフォルト拡張子 (デフォルト: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "カスタムテンプレートディレクトリ (デフォルト: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "インポートしたメンバーのドキュメント (デフォルト: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "キーワード引数"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "サンプル"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "サンプル"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "メモ"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "その他のパラメータ"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "参照"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "警告"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr "列挙"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "注意"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "注意"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "危険"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "エラー"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "ヒント"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "重要"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "注釈"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "参考"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "ちなみに"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "警告"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "前のページからの続き"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "次のページに続く"
@@ -3015,181 +3145,181 @@ msgstr "番号"
 msgid "page"
 msgstr "ページ"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "目次"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "検索"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "検索"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "ソースコードを表示"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "概要"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Welcome! This is"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "the documentation for"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "最終更新"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "索引と表一覧:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "総合目次"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "章／節一覧"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "ドキュメントを検索"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "モジュール総索引"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "全モジュール早見表"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "関数、クラスおよび用語総覧"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "索引 &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "総索引"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "頭文字別索引"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "大きい場合があるので注意"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "ナビゲーション"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s 内を検索"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "このドキュメントについて"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "著作権"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "最終更新: %(last_updated)s"
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "このドキュメントは <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s で生成しました。"
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "%(docstitle)s 内を検索"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "前のトピックへ"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "前の章へ"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "次のトピックへ"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "次の章へ"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "検索機能を使うには JavaScript を有効にしてください。"
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr "複数の単語を検索すると、次を含む一致のみが表示されます\n     すべての用語。"
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "検索"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "検索結果"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "検索した文字列はどの文書にも見つかりませんでした。すべての単語が正確に記述されているか、あるいは、十分なカテゴリーが選択されているか確認してください。"
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "クイック検索"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "このページ"
 
@@ -3221,19 +3351,19 @@ msgstr "C API に関する変更"
 msgid "Other changes"
 msgstr "その他の変更"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "このヘッドラインへのパーマリンク"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "この定義へのパーマリンク"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "検索結果を隠す"
 
@@ -3245,12 +3375,12 @@ msgstr "検索中"
 msgid "Preparing search..."
 msgstr "検索を準備しています..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "検索が完了し、 %s ページ見つけました。"
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", in "
 
@@ -3263,7 +3393,7 @@ msgstr "サイドバーを展開"
 msgid "Collapse sidebar"
 msgstr "サイドバーをたたむ"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "コンテンツ"
 
@@ -3282,199 +3412,207 @@ msgstr "Footnote [%s] は参照されていません。"
 msgid "Footnote [#] is not referenced."
 msgstr "Footnote [#] は参照されていません。"
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "翻訳されたメッセージの footnote 参照が矛盾しています。原文: {0}、翻訳: {1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "翻訳されたメッセージの参照が矛盾しています。原文: {0}、翻訳: {1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "翻訳されたメッセージの引用参照が矛盾しています。原文: {0}、翻訳: {1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "翻訳されたメッセージの用語参照が矛盾しています。原文: {0}、翻訳: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "'any' クロスリファレンス %r のターゲットが1つ以上みつかりました。 %s に参照を設定します。"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s の参照ターゲットが見つかりません: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "%r の参照ターゲットが見つかりません: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "リモート画像を取得できませんでした: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr "リモート画像を取得できませんでした: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "不明な画像フォーマット: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "デコードできないソース文字です。\"?\" に置き換えます: %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr "スキップしました"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr "失敗しました"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "読み取りエラー: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "書き込みエラー: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "日付形式が無効です。直接出力したい場合は、文字列を一重引用符で囲みます: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree に存在しないファイルへの参照が含まれています %r"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "only ディレクティブの条件式の評価中に例外が発生しました: %s"
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr "Python2 構文の評価のサポートは廃止予定であり、Sphinx 4.0 では削除される予定です。%s を Python3 の構文に変換します。"
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "デフォルトのロール %s が見つかりません"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "%s に numfig_format は定義されていません"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "いくつかの ID が %s ノードに割り当てられていません"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "このテーブルへのパーマリンク"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "このコードへのパーマリンク"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "この画像へのパーマリンク"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "この目次へのパーマリンク"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "画像サイズを取得できませんでした。:scale: オプションは無視されます。"
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "不明なクラス %r の toplevel_sectioning %r"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: が大きすぎるので無視されます。"
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr "ドキュメントのタイトルは、単一の Text ノードではありません"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "セクション、トピック、表、訓戒またはサイドバーにないタイトルノードが見つかりました。"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "注記"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "tabularcolumns と :widths: オプションの両方が設定されています。:widths: は無視されます。"
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "ディメンション単位 %s が無効です。無視されます。"
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "不明なインデックスエントリタイプ %s が見つかりました"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[画像: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[画像]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "キャプションは図の中にはありません。"
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "未実装のノードタイプ: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr "不明なノードタイプ: %r"
diff --git a/sphinx/locale/ko/LC_MESSAGES/sphinx.po b/sphinx/locale/ko/LC_MESSAGES/sphinx.po
index 56fff17d18b..e32caef594c 100644
--- a/sphinx/locale/ko/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ko/LC_MESSAGES/sphinx.po
@@ -1,222 +1,227 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Minho Ryang <minhoryang@gmail.com>, 2019
-# YT H <dev@theYT.net>, 2019
+# YT H <dev@theYT.net>, 2019-2021
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-12 00:16+0000\n"
+"Last-Translator: YT H <dev@theYT.net>\n"
 "Language-Team: Korean (http://www.transifex.com/sphinx-doc/sphinx-1/language/ko/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: ko\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "설정 디렉토리에 conf.py 파일이 없습니다 (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
-msgstr "소스 디렉토리를 찾을 수 없습니다 (%s)"
+msgstr "원본 디렉토리를 찾을 수 없습니다 (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr "출력 디렉토리 %s은(는) 디렉토리가 아닙니다."
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
-msgstr "소스 디렉토리와 대상 디렉토리는 같을 수 없습니다"
+msgstr "원본 디렉토리와 대상 디렉토리는 같을 수 없습니다"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx 버전 %s 실행 중"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr ""
+msgstr "보안상의 이유로 macOS의 Python 3.8 버전 이상에서는 병렬 모드가 비활성화되어 있습니다. 자세한 내용은 https://github.com/sphinx-doc/sphinx/issues/6803 을 참조하십시오"
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "이 프로젝트는 최소 Sphinx 버전 %s이(가) 필요하므로 현재 버전으로 빌드할 수 없습니다."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
-msgstr ""
+msgstr "출력 디렉토리 만드는 중"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
-msgstr ""
+msgstr "확장 기능 %s 설정 중:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "현재 conf.py 파일에 정의된 'setup'은 호출 가능한 Python 객체가 아닙니다. 호출 가능한 함수가 되도록 정의를 수정하십시오.\n이것은 conf.py가 Sphinx 확장 기능으로 동작하는 데 필요합니다."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "번역을 불러오는 중 [%s]… "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "완료"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "기본 제공 메시지를 사용할 수 없습니다"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
-msgstr ""
+msgstr "pickle로 저장된 환경을 불러오는 중"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "실패: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "선택한 빌더가 없으므로, 기본값인 html을 사용합니다"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "성공"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "완료했으나 문제점 발견"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
-msgstr ""
+msgstr "빌드 %s, 경고가 %s 개 발생했습니다 (경고를 오류로 처리)."
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
-msgstr ""
+msgstr "빌드 %s, 경고가 %s 개 발생했습니다 (경고를 오류로 처리)."
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "빌드 %s, 경고가 %s 개 발생했습니다."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
-msgstr ""
+msgstr "빌드 %s, 경고가 %s 개 발생했습니다."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "빌드 %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
-msgstr ""
+msgstr "%r 노드 클래스가 이미 등록되어 있으며, 방문자를 무시합니다"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
-msgstr ""
+msgstr "%r 지시문이 이미 등록되어 있으며, 재정의됩니다"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
-msgstr ""
+msgstr "%r 역할이 이미 등록되어 있으며, 재정의됩니다"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr ""
+msgstr "%s 확장 기능은 병렬 읽기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
-msgstr ""
+msgstr "%s 확장 기능은 병렬 읽기에 안전하지 않습니다"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr ""
+msgstr "%s 확장 기능은 병렬 쓰기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
-msgstr ""
+msgstr "%s 확장 기능은 병렬 쓰기에 안전하지 않습니다"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "병렬 %s 처리"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "Dictionary 구성 설정 %r을(를) 재정의할 수 없으며, 무시합니다 (개별 요소를 설정하기 위해 %r 사용)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
-msgstr "설정 값 %r에 대해 숫자 %r이(가) 유효하지 않으며, 무시합니다"
+msgstr "숫자 %r이(가) 설정값 %r에 대해 유효하지 않으며, 무시합니다"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
-msgstr "지원되지 않는 유형에 대한 구성 설정 %r을(를) 재정의 할 수 없으며, 무시합니다"
+msgstr "지원되지 않는 유형의 구성 설정 %r을(를) 재정의 할 수 없으며, 무시합니다"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
-msgstr "재정의 중 알 수 없는 구성 값 %r, 무시합니다"
+msgstr "재정의 중 알 수 없는 설정값 %r, 무시합니다"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "해당 설정값이 없습니다: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "설정값 %r이(가) 이미 존재합니다"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
-msgstr ""
+msgstr "구성 파일에 구문 오류가 있습니다: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "구성 파일(또는 가져온 모듈 중 하나)에서 sys.exit()을 호출했습니다"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,57 +229,50 @@ msgid ""
 "%s"
 msgstr "구성 파일에 프로그램 오류가 있습니다:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
-msgstr ""
+msgstr "설정값 'source_suffix'는 문자열, 문자열의 목록 또는 dictionary를 예상합니다. 그러나 `%r'이(가) 지정되었습니다."
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "제 %s 절"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "그림 %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "표 %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "예시 %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
-msgstr "설정 값 `{name}`은(는) {candidates} 중 하나여야 하지만, `{current}`이(가) 주어졌습니다."
+msgstr "설정값 `{name}`은(는) {candidates} 중 하나여야 하지만, `{current}`이(가) 지정되었습니다."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
-msgstr ""
+msgstr "설정값 `{name}'은(는) `{current.__name__}' 유형이지만, {permitted} 유형을 기대했습니다."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
-msgstr "설정 값 `{name}'은(는) `{current.__name__}' 유형이며, 기본값은 `{default.__name__}'입니다."
-
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "구성 값 %r이(가) 비 ASCII 문자가 있는 문자열로 설정되었으며, 이로 인해 유니코드 오류가 발생할 수 있습니다. %r와(과) 같은 유니코드 문자열을 사용하십시오."
+msgstr "설정값 `{name}'은(는) `{current.__name__}' 유형이지만, 기본값은 `{default.__name__}'입니다."
 
 #: sphinx/config.py:461
 #, python-format
@@ -283,886 +281,927 @@ msgstr "primary_domain %r(이)가 없으므로, 무시합니다."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr ""
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr "2.0 버전부터 Sphinx는 기본적으로 \"index\"를 root_doc으로 사용합니다. conf.py에 \"root_doc = 'contents'\"를 추가하십시오."
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "이벤트 %r이(가) 이미 존재합니다"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "알 수 없는 이벤트 이름: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr "처리기 %r (이벤트 %r에 대한) 에서 예외를 발생했습니다"
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
-msgstr ""
+msgstr "%s 확장 기능은 needs_extensions 설정에 따라 필요하지만, 로드되지 않았습니다."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
-msgstr ""
+msgstr "이 프로젝트에는 최소한 %s 버전의 %s 확장 기능이 필요하므로 로드 된 버전(%s)으로 빌드 할 수 없습니다."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
-msgstr ""
+msgstr "Pygments 구문 분석기 이름 %r을(를) 확인할 수 없습니다"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
-msgstr "literal_block을 \"%s\"(으)로 어휘 분석할 수 없습니다. 구문 강조를 건너뜁니다."
+msgstr "literal_block을 \"%s\"(으)로 구문 분석할 수 없습니다. 구문 강조를 건너뜁니다."
+
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr "문서 \"%s\"에 대해 여러 파일을 발견했습니다: %r\n빌드에 %r을(를) 사용합니다."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
-msgstr ""
+msgstr "문서를 읽을 수 없습니다. 무시합니다."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "빌더 클래스 %s에 \"name\" 속성이 없습니다"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
-msgstr ""
+msgstr "%r 빌더가 이미 존재합니다 (%s 모듈에 있음)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
-msgstr ""
+msgstr "빌더 이름 %s이(가) 등록되지 않았거나 진입점을 통해서만 사용할 수 있습니다"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
-msgstr ""
+msgstr "빌더 이름 %s이(가) 등록되지 않았습니다"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
-msgstr ""
+msgstr "%s 영역이 이미 등록되었습니다"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
-msgstr ""
+msgstr "%s 영역이 아직 등록되지 않았습니다"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
-msgstr ""
+msgstr "%r 지시문이 %s 영역에 이미 등록되었습니다"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
-msgstr ""
+msgstr "%r 역할이 %s 영역에 이미 등록되었습니다"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
-msgstr ""
+msgstr "%r 색인이 %s 영역에 이미 등록되었습니다"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
-msgstr ""
+msgstr "%r object_type이 이미 등록되었습니다"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
-msgstr ""
+msgstr "%r crossref_type이 이미 등록되었습니다"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
-msgstr ""
+msgstr "source_suffix %r이(가) 이미 등록되었습니다"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "%r에 대한 source_parser가 이미 등록되었습니다"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "%s에 대한 소스 해석기가 등록되지 않았습니다"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
-msgstr ""
+msgstr "%r에 대한 변환기가 이미 존재합니다"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node()에 대한 kwargs는 반드시 (visit, depart)의 함수 튜플이어야 합니다: %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r이(가) 이미 등록되었습니다"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "수식 렌더러 %s이(가) 이미 등록되었습니다"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
-msgstr "확장 %r은(는) 이미 Sphinx에 버전 %s 이후로 병합되었습니다. 이 확장은 무시됩니다."
+msgstr "%r 확장 기능은 Sphinx에 버전 %s 이후로 이미 병합되었습니다. 이 확장 기능은 무시됩니다."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
-msgstr "원본 예외:\n"
+msgstr "원래 예외:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
-msgstr ""
+msgstr "확장 기능 %s을(를) 가져올 수 없습니다"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
-msgstr ""
+msgstr "확장 기능 %r에 setup() 함수가 없습니다. Sphinx 확장 모듈이 맞습니까?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
-msgstr ""
+msgstr "이 프로젝트에서 사용하는 %s 확장 기능에는 최소한 Sphinx v%s이(가) 필요합니다. 따라서 이 버전으로 빌드 할 수 없습니다."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
-msgstr ""
+msgstr "확장 기능 %r이(가) setup() 함수에서 지원되지 않는 개체를 반환했습니다. None 또는 메타데이터 dictionary를 반환해야 합니다"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
-msgstr "파이썬 향상 제안; PEP %s"
+msgstr "Python 향상 제안; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "테마 %r에 \"theme\" 설정이 없습니다"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "테마 %r에 \"inherit\" 설정이 없습니다"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
-msgstr ""
+msgstr "이름이 %r인 테마가 없으며, %r에서 상속합니다"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
-msgstr ""
+msgstr "검색된 테마 구성에서 %s.%s 설정이 존재하지 않습니다"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "지원하지 않는 테마 옵션 %r을(를) 설정했습니다"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
-msgstr ""
+msgstr "테마 경로의 %r 파일이 유효한 ZIP 파일이 아니거나 테마를 포함하지 않습니다"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr ""
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr "sphinx_rtd_theme (< 0.3.0) 가 발견되었습니다. 이 테마는 Sphinx 6.0부터 사용할 수 없습니다."
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
-msgstr ""
+msgstr "이름이 %r인 테마를 찾을 수 없습니다 (theme.conf 파일 누락?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
-msgstr ""
+msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
-msgstr ""
+msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "빌드 중 [mo]: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "출력을 쓰는 중… "
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
-msgstr ""
+msgstr "모든 %d 개의 po 파일"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
-msgstr ""
+msgstr "지정된 %d 개의 po 파일 대상"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
-msgstr ""
+msgstr "오래된 %d 개의 po 파일 대상"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
-msgstr "모든 소스 파일"
+msgstr "모든 원본 파일"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
-msgstr ""
+msgstr "명령줄에 지정된 파일 %r이(가) 원본 디렉토리에 있지 않으므로, 무시합니다"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
-msgstr ""
+msgstr "명령줄에 지정된 파일 %r이(가) 존재하지 않으므로, 무시합니다"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
-msgstr ""
+msgstr "명령줄에 지정된 %d 개의 원본 파일"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
-msgstr ""
+msgstr "오래된 %d 개의 원본 파일 대상"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "빌드 중 [%s]: "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
-msgstr "오래 된 파일을 찾는 중… "
+msgstr "오래된 파일을 찾는 중… "
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "%d 개 찾음"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
-msgstr "찾은 것이 없습니다"
+msgstr "찾은 것이 없음"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
-msgstr ""
+msgstr "pickle로 환경을 저장하는 중"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
-msgstr ""
+msgstr "일관성 확인 중"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
-msgstr ""
+msgstr "오래된 대상이 없습니다."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
-msgstr ""
+msgstr "환경을 갱신하는 중: "
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
-msgstr ""
+msgstr "%s 개 추가됨, %s 개 변경됨, %s 개 제거됨"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
-msgstr ""
+msgstr "원본을 읽는 중… "
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
-msgstr ""
+msgstr "작업자를 기다리는 중…"
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
-msgstr ""
+msgstr "기록할 문서 이름: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
-msgstr ""
+msgstr "문서 준비 중"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
-msgstr ""
+msgstr "중복된 목차 항목 발견: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
-msgstr ""
+msgstr "이미지를 복사하는 중… "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
-msgstr ""
+msgstr "이미지 파일 %r을(를) 읽을 수 없으며, 대신 복사합니다"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
-msgstr ""
+msgstr "이미지 파일 %r을(를) 복사할 수 없습니다: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
-msgstr ""
+msgstr "이미지 파일 %r을(를) 기록할 수 없습니다: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
-msgstr ""
+msgstr "Pillow를 찾을 수 없습니다 - 이미지 파일을 복사합니다"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr ""
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr "mimetype 파일 쓰는 중…"
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr "META-INF/container.xml 파일 쓰는 중…"
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr "content.opf 파일 쓰는 중…"
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
-msgstr ""
+msgstr "%s은(는) 알 수 없는 MIME 유형이며, 무시합니다"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr "toc.ncx 파일 쓰는 중…"
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "%s 파일을 기록하는 중…"
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
-msgstr ""
+msgstr "개요 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
-msgstr ""
+msgstr "버전 %s에는 변경 사항이 없습니다."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
-msgstr ""
+msgstr "요약 파일 작성 중…"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
-msgstr "기본"
+msgstr "내장"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "모듈 수준"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
-msgstr "소스 파일을 복사하는 중…"
+msgstr "원본 파일을 복사하는 중…"
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
-msgstr ""
+msgstr "변경 로그 생성을 위해 %r을(를) 읽을 수 없습니다"
 
 #: sphinx/builders/dummy.py:22
 msgid "The dummy builder generates no files."
-msgstr ""
+msgstr "더미 빌더는 파일을 생성하지 않습니다."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
-msgstr ""
+msgstr "ePub 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr "nav.xhtml 파일 쓰는 중…"
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
-msgstr ""
+msgstr "설정값 \"epub_language\"(또는 \"language\")는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
-msgstr ""
+msgstr "설정값 \"epub_uid\"는 EPUB3의 경우 XML 이름이어야 합니다"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
-msgstr ""
+msgstr "설정값 \"epub_title\"은 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
-msgstr ""
+msgstr "설정값 \"epub_author\"는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
-msgstr ""
+msgstr "설정값 \"epub_contributor\"는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
-msgstr ""
+msgstr "설정값 \"epub_description\"은 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
-msgstr ""
+msgstr "설정값 \"epub_publisher\"는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
-msgstr ""
+msgstr "설정값 \"epub_copyright\"(또는 \"copyright\")는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
-msgstr ""
+msgstr "설정값 \"epub_identifier\"는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
-msgstr ""
+msgstr "설정값 \"version\"은 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
-msgstr ""
+msgstr "잘못된 css_file: %r, 무시합니다"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
-msgstr ""
+msgstr "메시지 카탈로그는 %(outdir)s에 있습니다."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
-msgstr ""
+msgstr "%d 개의 템플릿 파일 대상"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "템플릿을 읽는 중… "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
-msgstr ""
+msgstr "메시지 카탈로그 작성 중… "
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
-msgstr "위의 출력 또는 %(outdir)s/output.txt 파일에서 오류를 확인하십시오."
+msgstr "위의 출력 또는 %(outdir)s/output.txt 파일에서 오류를 확인하십시오"
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
-msgstr ""
+msgid "broken link: %s (%s)"
+msgstr "끊어진 링크: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
-msgstr ""
+msgid "Anchor '%s' not found"
+msgstr "앵커 '%s'을(를) 찾을 수 없습니다"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
-msgstr ""
+msgstr "매뉴얼 페이지는 %(outdir)s에 있습니다."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
-msgstr ""
+msgstr "\"man_pages\" 설정값이 없으므로, 매뉴얼 페이지를 작성하지 않습니다"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
-msgstr ""
+msgstr "작성 중"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
-msgstr ""
+msgstr "\"man_pages\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
-msgstr ""
+msgstr "HTML 페이지는 %(outdir)s에 있습니다."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
-msgstr ""
+msgstr "단일 문서 조합 중"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
-msgstr ""
+msgstr "추가 파일 작성 중"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
-msgstr ""
+msgstr "Texinfo 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
-msgstr ""
+msgstr "\nmakeinfo를 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make info'를 사용하십시오)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
-msgstr ""
+msgstr "\"texinfo_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
-msgstr ""
+msgstr "\"texinfo_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
-msgstr ""
+msgstr "%s 처리 중"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
-msgstr ""
+msgstr "참조 처리 중…"
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
-msgstr ""
+msgstr " (문서 "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
-msgstr ""
+msgstr "Texinfo 지원 파일을 복사하는 중"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
-msgstr ""
+msgstr "Makefile 쓰기 오류: %s"
 
 #: sphinx/builders/text.py:30
 #, python-format
 msgid "The text files are in %(outdir)s."
-msgstr ""
+msgstr "텍스트 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
-msgstr ""
+msgstr "%s 파일 쓰기 오류: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
-msgstr ""
+msgstr "XML 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
-msgstr ""
+msgstr "의사 XML 파일은 %(outdir)s에 있습니다."
 
 #: sphinx/builders/html/__init__.py:144
 #, python-format
 msgid "build info file is broken: %r"
-msgstr ""
+msgstr "빌드 정보 파일이 손상되었습니다: %r"
 
 #: sphinx/builders/html/__init__.py:176
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
-msgstr ""
+msgstr "HTML 페이지는 %(outdir)s에 있습니다."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
-msgstr ""
+msgstr "빌드 정보 파일을 읽을 수 없습니다: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y년 %m월 %d일"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "이제 html_use_opensearch 설정값은 문자열이어야 합니다"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "전체 색인"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "색인"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "다음"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "이전"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
-msgstr ""
+msgstr "색인 생성 중"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
-msgstr ""
+msgstr "추가 페이지 작성 중"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
-msgstr ""
+msgstr "다운로드 가능한 파일을 복사하는 중… "
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
-msgstr ""
+msgstr "다운로드 가능한 파일 %r을(를) 복사할 수 없습니다: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr ""
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr "html_static_file에 있는 파일을 복사할 수 없습니다: %s: %r"
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr "정적 파일을 복사하는 중"
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
-msgstr ""
+msgstr "정적 파일을 복사할 수 없습니다: %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
-msgstr ""
+msgstr "추가 파일을 복사하는 중"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
-msgstr ""
+msgstr "추가 파일을 복사할 수 없습니다: %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
-msgstr ""
+msgstr "빌드 정보 파일 쓰기 실패: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
-msgstr ""
+msgstr "검색 색인을 불러올 수 없지만 모든 문서가 작성되지는 않은 것은 아닙니다. 색인이 불완전합니다."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
-msgstr ""
+msgstr "%s 페이지가 html_sidebars의 두 패턴(%r 및 %r)과 일치합니다"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
-msgstr ""
+msgstr "%s 페이지를 렌더링 할 때 유니코드 오류가 발생했습니다. ASCII가 아닌 내용을 포함하는 모든 설정값이 유니코드 문자열인지 확인하십시오."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
-msgstr ""
+msgstr "%s 페이지를 렌더링하는 중에 오류가 발생했습니다.\n원인: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
-msgstr ""
+msgstr "객체 인벤토리 덤프 중"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
-msgstr ""
+msgstr "%s에서 검색 인덱스 덤프 중"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
-msgstr ""
+msgstr "잘못된 js_file: %r, 무시합니다"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
-msgstr ""
+msgstr "여러 math_renderers가 등록되어 있습니다. 하지만 math_renderer가 선택되지 않았습니다."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
-msgstr ""
+msgstr "알 수 없는 math_renderer %r이(가) 지정되었습니다."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
-msgstr ""
+msgstr "html_extra_path 항목 %r이(가) 없습니다"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "html_extra_path 항목 %r이(가) outdir 안에 있습니다"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
-msgstr ""
+msgstr "html_static_path 항목 %r이(가) 없습니다"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "html_static_path 항목 %r이(가) outdir 안에 있습니다"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
-msgstr ""
+msgstr "로고 파일 %r이(가) 존재하지 않습니다"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
-msgstr ""
+msgstr "Favicon 파일 %r이(가) 존재하지 않습니다"
+
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr "html_add_permalinks는 3.5.0 버전부터 더 이상 사용되지 않습니다. 대신 html_permalinks 및 html_permalinks_icon을 사용하십시오."
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s 문서"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
-msgstr ""
+msgstr "LaTeX 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
-msgstr ""
+msgstr "\n(pdf)latex을 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make latexpdf'를 사용하십시오)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
-msgstr ""
+msgstr "\"latex_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
-msgstr ""
-
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+msgstr "\"latex_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다"
+
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "색인"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
-msgstr "출시 버전"
+msgstr "릴리스"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
-msgstr ""
+msgstr "%r 언어에 대해 알려진 Babel 옵션이 없습니다"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
-msgstr ""
+msgstr "TeX 지원 파일을 복사하는 중"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
-msgstr ""
+msgstr "TeX 지원 파일을 복사하는 중…"
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
-msgstr ""
+msgstr "추가 파일을 복사하는 중"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
-msgstr ""
+msgstr "알 수 없는 설정 키: latex_elements[%r], 무시합니다."
+
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr "알 수 없는 테마 옵션: latex_theme_options[%r], 무시합니다."
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
-msgstr ""
+msgstr "%r에 \"theme\" 설정이 없습니다"
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
-msgstr ""
+msgstr "%r에 \"%s\" 설정이 없습니다"
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
-msgstr ""
+msgstr "빌드하는 동안 예외 발생, 디버거 시작:"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
-msgstr ""
+msgstr "중단되었습니다!"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
-msgstr ""
+msgstr "reST 마크업 오류:"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "인코딩 오류:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
-msgstr ""
+msgstr "개발자에게 문제를 보고할 경우를 위해, 전체 역추적 정보가 %s에 저장되었습니다."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
-msgstr ""
+msgstr "재귀 오류:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr ""
+msgstr "이 상황은 매우 크거나 많이 중첩된 원본 파일에서 발생할 수 있습니다. 다음과 같이 conf.py에서 Python 재귀 제한 기본값 1000을 늘릴 수 있습니다 (주의):"
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
-msgstr ""
+msgstr "예외 발생:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
-msgstr ""
+msgstr "사용자 오류인 경우에도 이를 보고하여, 다음에 더 나은 오류 메시지를 제공할 수 있도록 해 주십시오."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
-msgstr ""
+msgstr "버그 보고서는 <https://github.com/sphinx-doc/sphinx/issues>의 트래커에 제출할 수 있습니다. 감사합니다!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
-msgstr ""
+msgstr "작업 숫자는 양수여야 합니다"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "자세한 내용은 <http://sphinx-doc.org/>를 참조하십시오."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1181,294 +1220,288 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr "\n소스 파일로부터 문서를 생성합니다.\n\nsphinx-build는 SOURCEDIR에 있는 파일로부터 문서를 생성하여 OUTPUTDIR에 저장합니다.\n구성 설정을 위해 SOURCEDIR에서 'conf.py' 파일을 찾습니다.\n'sphinx-quickstart' 도구는 'conf.py'를 포함하여 템플릿 파일을 생성하는 데 사용할 수 있습니다.\n\nsphinx-build는 다양한 형식으로 문서를 생성할 수 있습니다.\n형식은 명령줄에서 빌더 이름을 지정하여 선택하며, 기본값은 HTML입니다.\n빌더는 문서 처리와 관련한 다른 태스크를 수행할 수도 있습니다.\n\n기본적으로 오래된 모든 항목을 빌드합니다.\n개별 파일명을 지정하여 선택한 파일에 대한 출력만 빌드할 수 있습니다.\n"
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
-msgstr "문서 소스 파일의 경로"
+msgstr "문서 원본 파일의 경로"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "출력 디렉토리 경로"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "다시 빌드 할 특정 파일의 목록. -a가 지정되면 무시합니다"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "일반 옵션"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "사용할 빌더 (기본값: html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
-msgstr "모든 파일 쓰기 (기본값: 새 파일과 변경된 파일만 쓰기)"
+msgstr "모든 파일 기록 (기본값: 새 파일과 변경된 파일만 기록)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "저장된 환경을 사용하지 않고, 항상 모든 파일 읽기"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "캐시된 환경 및 doctree 파일 경로 (기본값: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
-msgstr "가능한 경우 N 개의 프로세스를 사용하여 병렬로 빌드 (특수 값 \"auto\"는 N을 CPU 개수로 설정합니다)"
+msgstr "가능한 경우 N 개의 프로세스를 사용하여 병렬로 빌드 (특수 값 \"auto\"는 CPU 개수로 N 값을 설정합니다)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "구성 파일(conf.py)이 있는 경로 (기본값: SOURCEDIR과 동일)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "설정 파일을 전혀 사용하지 않고, -D 옵션들만 사용"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "구성 파일의 설정 무시"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "HTML 템플릿에 값 전달"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
-msgstr "태그를 정의: 태그가 있는 블록\"만\" 포함됨"
+msgstr "태그를 정의: 태그가 있는 \"only\" 블록을 포함"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "까다로움 모드, 모든 누락된 참조에 대해 경고 발생"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "콘솔 출력 옵션"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "상세도 높임 (반복 가능)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "stdout에 출력하지 않고, stderr에 경고만 표시"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "경고를 포함하여 아무 출력도 하지 않음"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "컬러 출력 허용 (기본값: 자동 감지)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "컬러 출력을 허용하지 않음 (기본값: 자동 감지)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "주어진 파일에 경고(및 오류)를 기록"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "경고를 오류로 바꿈"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
-msgstr ""
+msgstr "-W와 함께 지정하여, 경고가 발생했을 때 계속 진행"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "예외 발생 시 전체 추적 표시"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "예외 발생 시 Pdb 실행"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
-msgstr ""
+msgstr "파일을 찾을 수 없습니다: %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
-msgstr ""
+msgstr "-a 옵션과 파일 이름을 함께 사용할 수 없습니다"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
-msgstr ""
+msgstr "경고 기록 파일 %r을(를) 열 수 없습니다: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
-msgstr ""
+msgstr "-D 옵션 인수는 name=value 형식이어야 합니다"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
-msgstr ""
+msgstr "-A 옵션 인수는 name=value 형식이어야 합니다"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
-msgstr ""
+msgstr "모듈에서 자동으로 docstring 삽입"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
-msgstr ""
+msgstr "doctest 블록의 코드 조각을 자동으로 테스트"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
-msgstr ""
+msgstr "다른 프로젝트의 Sphinx 문서 간 링크"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
-msgstr ""
+msgstr "빌드 시 표시하거나 숨길 수 있는 \"할 일\" 항목 작성"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
-msgstr ""
+msgstr "문서의 커버리지 확인"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
-msgstr ""
+msgstr "PNG나 SVG 이미지로 렌더링 된 수식 포함"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
-msgstr ""
+msgstr "MathJax로 브라우저에서 렌더링 하는 수식 포함"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
-msgstr ""
+msgstr "설정값을 기반으로 콘텐츠를 조건부 포함"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
-msgstr ""
+msgstr "문서화 된 Python 객체의 소스 코드에 대한 링크 포함"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
-msgstr ""
+msgstr "GitHub 페이지에 문서를 게시하기 위해 .nojekyll 파일 생성"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
-msgstr ""
+msgstr "유효한 경로 이름을 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
-msgstr ""
+msgstr "텍스트를 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
-msgstr ""
+msgstr "%s 중 하나를 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
-msgstr ""
+msgstr "'y' 또는 'n'을 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
+msgstr "파일 접미사를 입력하십시오 (예: '.rst' 또는 '.txt')."
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
-msgstr ""
+msgstr "Sphinx %s 빠른 시작 유틸리티에 오신 것을 환영합니다."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
-msgstr ""
+msgstr "다음 설정에 대한 값을 입력하십시오 (대괄호로 묶여 있는 기본값이 존재하고\n이 값을 사용하려면 바로 Enter를 누릅니다)."
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
-msgstr ""
+msgstr "선택한 루트 경로: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
-msgstr ""
+msgstr "문서의 루트 경로를 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
-msgstr ""
+msgstr "문서의 루트 경로"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
-msgstr ""
+msgstr "오류: 선택한 루트 경로에서 기존 conf.py 파일이 발견되었습니다."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
-msgstr ""
+msgstr "sphinx-quickstart는 기존 Sphinx 프로젝트를 덮어 쓰지 않습니다."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
-msgstr ""
+msgstr "새 루트 경로를 입력하십시오 (또는 Enter를 눌러 종료)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
-msgstr ""
+msgstr "Sphinx 출력을 위한 빌드 디렉토리를 배치하는 두 가지 옵션이 있습니다.\n루트 경로 내에서 \"_build\" 디렉토리를 사용하거나, 루트 경로 내에서\n\"source\"와 \"build\" 디렉토리로 분리합니다."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
-msgstr ""
+msgstr "원본과 빌드 디렉토리 분리 (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
-msgstr ""
+msgstr "루트 디렉토리 내에 두 개의 추가 디렉토리가 생성됩니다. 사용자 정의 HTML 템플릿의\n경우 \"_templates\", 사용자 정의 스타일시트 및 기타 정적 파일의 경우 \"_static\"\n입니다. 다른 접두사(\".\" 과 같은)를 입력하여 밑줄 문자를 변경할 수 있습니다."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
-msgstr ""
+msgstr "템플릿 및 정적 디렉토리의 이름 접두사"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
-msgstr ""
+msgstr "프로젝트 이름은 빌드 된 문서의 여러 위치에 표시됩니다."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "프로젝트 이름"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "작성자 이름"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr ""
+msgstr "Sphinx는 소프트웨어에 대한 \"버전\"과 \"릴리스\"라는 개념을 가지고 있습니다.\n각 버전에는 여러 릴리스가 있을 수 있습니다. 예를 들어 Python의 경우 버전은\n2.5나 3.0과 같은 반면 릴리스는 2.5.1 또는 3.0a1과 같습니다.\n이러한 이중 구조가 필요하지 않으면 둘 다 동일한 값으로 설정하십시오."
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "프로젝트 버전"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
-msgstr "프로젝트 출시 버전"
+msgstr "프로젝트 릴리스"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,115 +1509,115 @@ msgid ""
 "\n"
 "For a list of supported codes, see\n"
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
-msgstr ""
+msgstr "문서를 영어 이외의 언어로 작성하려는 경우, 여기에서 해당 언어 코드로 언어를\n선택할 수 있습니다. 그러면 Sphinx가 생성한 텍스트를 해당 언어로 번역합니다.\n\n지원되는 코드 목록은\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language\n를 참조하십시오."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "프로젝트 언어"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr ""
+msgstr "원본 파일의 파일 이름 접미사. 일반적으로 \".txt\" 또는 \".rst\" 입니다. 이 접미사가\n있는 파일만 문서로 간주됩니다."
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
-msgstr ""
+msgstr "원본 파일 접미사"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
 "of the documents. Normally, this is \"index\", but if your \"index\"\n"
 "document is a custom template, you can also set this to another filename."
-msgstr ""
+msgstr "한 문서는 \"컨텐츠 트리\"의 최상위 노드, 즉 문서 계층 구조의 루트로 간주된다는\n점에서 특별합니다. 일반적으로 이 값은 \"index\" 이지만, \"index\" 문서가\n사용자 정의 템플릿일 경우 이를 다른 파일 이름으로 설정할 수도 있습니다."
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
-msgstr ""
+msgstr "마스터 문서의 이름 (접미사 없이)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
-msgstr ""
+msgstr "오류: 선택한 루트 경로에 마스터 파일 %s이(가) 이미 있습니다."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
-msgstr ""
+msgstr "sphinx-quickstart는 기존 파일을 덮어 쓰지 않습니다."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
-msgstr ""
+msgstr "새 파일 이름을 입력하거나 기존 파일의 이름을 바꾸고, Enter를 누르십시오"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
-msgstr ""
+msgstr "다음 Sphinx 확장 기능 중 사용 설정해야 하는 항목을 지정하십시오:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
-msgstr ""
+msgstr "참고: imgmath와 mathjax는 동시에 활성화 할 수 없습니다. imgmath가 선택 취소되었습니다."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
-msgstr ""
+msgstr "Makefile 및 Windows 명령 파일을 생성할 수 있으므로, sphinx-build를 직접 호출하는\n대신 (예를 들어) `make html'을 실행하기만 하면 됩니다."
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
-msgstr ""
+msgstr "Makefile을 만드시겠습니까? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
-msgstr ""
+msgstr "Windows 명령 파일을 만드시겠습니까? (y/n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
-msgstr ""
+msgstr "%s 파일을 만드는 중입니다."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
-msgstr ""
+msgstr "%s 파일이 이미 존재하여, 건너뜁니다."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
-msgstr ""
+msgstr "완료됨: 초기 디렉토리 구조가 생성되었습니다."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
-msgstr ""
+msgstr "이제 마스터 파일 %s을(를) 채우고 다른 원본 문서 파일을 만들어야 합니다. "
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
-msgstr ""
+msgstr "Makefile을 사용하여 다음과 같이 문서를 빌드하십시오:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
-msgstr ""
+msgstr "sphinx-build 명령을 사용하여 다음과 같이 문서를 빌드하십시오:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
-msgstr ""
+msgstr "여기서 \"builder\"는 지원되는 빌더 중 하나(예: html, latex, linkcheck)입니다."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1594,787 +1627,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nSphinx 프로젝트에 필요한 파일을 생성합니다.\n\nsphinx-quickstart는 대화형 도구로서, 프로젝트에 대한 몇 가지 질문을 한 다음\n완전한 문서 디렉토리와 (sphinx-build와 함께 사용할 수 있는) 견본 Makefile을 생성합니다.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "조용한 모드"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
-msgstr ""
+msgstr "프로젝트 루트 디렉토리"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "구조 옵션"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
-msgstr "지정된 경우, 소스와 빌드 디렉토리를 구분함"
+msgstr "지정된 경우, 원본과 빌드 디렉토리를 구분합니다"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr "지정된 경우, 원본 디렉토리 아래에 빌드 디렉토리를 만듭니다"
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
-msgstr ""
+msgstr "_templates 등에서 마침표의 대체 문자"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "프로젝트 기본 옵션"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "프로젝트 이름"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "작성자 이름"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "프로젝트의 버전"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
-msgstr "프로젝트의 출시 버전"
+msgstr "프로젝트의 릴리스"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "문서 언어"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
-msgstr ""
+msgstr "원본 파일의 접미사"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "마스터 문서 이름"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
-msgstr ""
+msgstr "EPUB 사용"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "확장 기능 옵션"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "%s 확장 기능 사용"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "임의의 확장 기능 사용"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Makefile과 배치 파일 생성"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "makefile 생성"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "makefile을 생성하지 않음"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "배치 파일 생성"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "배치 파일을 생성하지 않음"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
-msgstr ""
+msgstr "Makefile/make.bat에서 make 모드 사용"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
-msgstr ""
+msgstr "Makefile/make.bat에서 make 모드 사용하지 않음"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "프로젝트 템플릿"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
-msgstr ""
+msgstr "템플릿 파일에 대한 템플릿 디렉토리"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
-msgstr ""
+msgstr "템플릿 변수 정의"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
-msgstr ""
+msgstr "\"quiet\"이 지정되었지만, \"project\" 또는 \"author\"가 정의되지 않았습니다."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
-msgstr ""
+msgstr "오류: 지정된 경로가 디렉토리가 아니거나, Sphinx 파일이 이미 있습니다."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
-msgstr ""
+msgstr "sphinx-quickstart는 빈 디렉토리에만 생성됩니다. 새 루트 경로를 지정하십시오."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
-msgstr ""
+msgstr "잘못된 템플릿 변수: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr ""
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr "내어쓰기에 의해 비 공백 문자가 제거됨"
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
-msgstr ""
+msgstr "잘못된 캡션: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
-msgstr ""
+msgstr "줄 번호 지정이 범위를 벗어남 (1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
-msgstr ""
+msgstr "\"%s\"과(와) \"%s\" 옵션을 모두 사용할 수 없습니다"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
-msgstr ""
+msgstr "포함 파일 %r을(를) 찾을 수 없거나 읽지 못했습니다"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
-msgstr ""
+msgstr "포함 파일 %r을 읽는데 사용한 %r 인코딩이 잘못된 것 같습니다. :encoding: 옵션을 지정해 보십시오"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
-msgstr ""
+msgstr "포함 파일 %r에서 이름이 %r 인 객체를 찾을 수 없습니다"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
-msgstr ""
+msgstr "분리된 \"lines\" 집합과 함께 \"lineno-match\"를 사용할 수 없습니다"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
-msgstr ""
+msgstr "행 지정 %r: 포함 파일 %r에서 가져온 줄이 없습니다"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
-msgstr ""
+msgstr "구역 작성자: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "모듈 작성자: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "코드 작성자: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "작성자: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr "csv-table 지시문의 \":file:\" 옵션은 이제 절대 경로를 소스 디렉토리의 상대 경로로 인식합니다. 문서를 업데이트하십시오."
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr "중복 C 선언이며, %s:%s에 정의되었습니다.\n선언은 '.. c:%s:: %s' 입니다."
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "매개변수"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "반환값"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "반환 형식"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (C 함수)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C 멤버 변수)"
-
-#: sphinx/domains/c.py:191
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C macro)"
-msgstr "%s (C 매크로)"
+msgid "%s (C %s)"
+msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C 데이터 형식)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "멤버 변수"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C 변수)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "변수"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "함수"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "멤버 변수"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "매크로"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
-msgstr "데이터 형식"
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr "구조체"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "변수"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "공용체"
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
-msgstr ""
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "열거형"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "열거자"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
+msgstr "자료형"
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr "함수 매개변수"
+
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "버전 %s에 추가"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "버전 %s에서 변경"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
-msgstr "버전 %s부터 폐지"
+msgstr "버전 %s부터 폐지됨"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
-msgstr ""
+msgstr "중복 인용 %s, 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
-msgstr ""
+msgstr "인용 [%s]이(가) 참조되지 않았습니다."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr ""
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr "중복 C++ 선언이며, %s:%s에 정의되었습니다.\n선언은 '.. cpp:%s:: %s' 입니다."
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "템플릿 매개변수"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "예외"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
-msgstr ""
+msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "클래스"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr ""
+msgstr "콘셉트"
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr "템플릿 매개변수"
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (내장 함수)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s 메서드)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (클래스)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (전역 변수 또는 상수)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s의 속성)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "인수"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (모듈)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "메서드"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "데이터"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "속성"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "모듈"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
-msgstr ""
+msgstr "중복된 %s 설명 (%s에 대한), 다른 항목은 %s (%s)에 있음"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
-msgstr ""
+msgstr "중복 레이블의 수식 %s, 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
-msgstr ""
+msgstr "잘못된 math_eqref_format: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "키워드"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "연산자"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "객체"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "예외"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
-msgstr "글"
+msgstr "문"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "내장 함수"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "변수"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
-msgstr "예외"
+msgstr "예외 발생"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s 모듈)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (내장 변수)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s 모듈)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (내장 변수)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (내장 클래스)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s 클래스)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s의 메서드)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s의 클래스 메서드)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s의 정적 메서드)"
+msgid "%s() (%s property)"
+msgstr "%s() (%s의 특성)"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s의 정적 메서드)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s의 클래스 메서드)"
+msgid "%s (%s property)"
+msgstr "%s (%s의 특성)"
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s의 클래스 메서드)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s의 속성)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python 모듈 목록"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "모듈"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
-msgstr "폐지"
+msgstr "폐지됨"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "클래스 메서드"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "정적 메서드"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr "특성"
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
-msgstr ""
+msgstr "%s의 중복 객체 설명, 다른 인스턴스는 %s에 있으며, 이 중 하나에 :noindex:를 사용하십시오"
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
-msgstr ""
+msgstr "상호 참조 %r에 대해 둘 이상의 대상을 찾았습니다: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
-msgstr ""
+msgstr " (폐지됨)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (지시문)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
-msgstr ""
+msgstr ":%s: (지시문 옵션)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (역할)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
-msgstr "지시자"
+msgstr "지시문"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
-msgstr ""
+msgstr "지시문 옵션"
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "역할"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
-msgstr ""
+msgstr "중복된 %s %s 설명, 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "환경 변수; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
-msgstr ""
+msgstr "잘못된 옵션 설명 %r, \"opt\", \"-opt args\", \"--opt args\", \"/opt args\", \"+opt args\"와 같은 형식이어야 합니다"
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
-msgstr ""
+msgstr "%s 명령줄 옵션"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
-msgstr ""
+msgstr "명령줄 옵션"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
-msgstr ""
+msgstr "용어 앞에는 빈 줄이 와야 합니다"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
-msgstr ""
+msgstr "용어 정의는 빈 줄로 구분하면 안됩니다."
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
-msgstr ""
+msgstr "용어 정의 형식이 잘못된 것 같습니다. 들여쓰기를 확인하십시오"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "용어 항목"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "문법 토큰"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "참조 레이블"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "환경 변수"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "프로그램 옵션"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
-msgstr ""
+msgstr "문서"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "모듈 목록"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "검색 페이지"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
-msgstr ""
+msgstr "중복 레이블 %s, 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
-msgstr ""
+msgstr "중복된 %s 설명 (%s에 대한), 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
-msgstr ""
+msgstr "numfig가 비활성화되었습니다. :numref:는 무시됩니다."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr ""
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr "상호 참조를 생성하지 못했습니다. 어떤 번호도 할당되지 않았습니다: %s"
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
-msgstr ""
+msgstr "링크에 캡션이 없습니다: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
-msgstr ""
+msgstr "잘못된 numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
-msgstr ""
+msgstr "잘못된 numfig_format: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr "정의되지 않은 레이블: %s"
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr "상호 참조를 생성하지 못했습니다. 제목 또는 캡션을 찾을 수 없습니다: %s"
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "새로운 설정"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "설정이 변경됨"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "확장 기능이 변경됨"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
-msgstr ""
+msgstr "빌드 환경 버전이 최신이 아님"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
-msgstr ""
+msgstr "원본 디렉토리가 변경됨"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
-msgstr ""
+msgstr "이 환경은 선택한 빌더와 호환되지 않습니다. 다른 doctree 디렉토리를 선택하십시오."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
-msgstr ""
+msgstr "%s에서 문서를 탐색하지 못했습니다: %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
-msgstr ""
+msgstr "%r 영역이 등록되지 않았습니다"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
-msgstr ""
+msgstr "자체 참조된 toctree가 발견되었습니다. 무시합니다."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
-msgstr ""
+msgstr "문서가 어느 toctree에도 포함되어 있지 않음"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "%s 문서"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "%s 참조"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
-msgstr ""
+msgstr "알 수 없는 색인 항목 유형 %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "기호"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
-msgstr ""
+msgstr "순환 toctree 참조가 감지되었으며, 무시합니다: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
-msgstr ""
+msgstr "toctree에 제목이 없는 문서 %r에 대한 참조가 있습니다. 링크가 생성되지 않습니다"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
-msgstr ""
+msgstr "toctree에 제외된 문서 %r에 대한 참조가 있음"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
-msgstr ""
+msgstr "toctree에 존재하지 않는 문서 %r에 대한 참조가 있음"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
-msgstr ""
+msgstr "이미지 파일을 읽을 수 없음: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
-msgstr ""
+msgstr "이미지 파일 %s을(를) 읽을 수 없음: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
-msgstr ""
+msgstr "다운로드 가능 파일을 읽을 수 없음: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
-msgstr ""
+msgstr "%s에 이미 구역 번호가 할당되었습니다 (중첩된 번호 붙인 toctree?)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
-msgstr ""
+msgstr "%s 파일을 작성합니다."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,185 +2406,205 @@ msgid ""
 "excluded from generation.\n"
 "\n"
 "Note: By default this script will not overwrite already created files."
-msgstr ""
+msgstr "\n<MODULE_PATH>에서 Python 모듈 및 패키지를 재귀적으로 찾고\nautomodule 지시문이 있는 패키지 당 하나의 reST 파일을 <OUTPUT_PATH>에 만듭니다.\n\n<EXCLUDE_PATTERN>은 생성에서 제외할 파일 또는 디렉토리 패턴일 수 있습니다.\n\n참고: 기본적으로이 스크립트는 이미 생성된 파일을 덮어 쓰지 않습니다."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
-msgstr ""
+msgstr "문서에 대한 모듈 경로"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
-msgstr ""
+msgstr "생성에서 제외할 fnmatch 형식의 파일 또는 디렉토리 패턴"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
-msgstr ""
+msgstr "모든 출력을 저장할 디렉토리"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
-msgstr ""
+msgstr "목차에 표시할 하위 모듈의 최대 깊이 (기본값: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
-msgstr ""
+msgstr "기존 파일 덮어쓰기"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
-msgstr ""
+msgstr "심볼릭 링크를 따라갑니다. collective.recipe.omelette과 결합하면 강력합니다."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
-msgstr ""
+msgstr "파일을 생성하지 않고 스크립트 실행"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
-msgstr ""
+msgstr "각 모듈에 대한 문서를 개별 페이지에 배치"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
-msgstr ""
+msgstr "\"_private\" 모듈 포함"
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
-msgstr ""
+msgstr "목차의 파일 이름 (기본값: modules)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
-msgstr ""
+msgstr "목차 파일을 만들지 않음"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
-msgstr ""
+msgstr "모듈/패키지에 대한 제목을 만들지 않음 (예: docstring에 이미 포함된 경우)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
-msgstr ""
+msgstr "서브 모듈 문서 앞에 모듈 문서를 넣음"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
-msgstr ""
+msgstr "PEP-0420 암시적 네임 스페이스 사양에 따라 모듈 경로 해석"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
-msgstr ""
+msgstr "파일 확장자 (기본값: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
-msgstr ""
+msgstr "sphinx-quickstart로 전체 프로젝트 생성"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
-msgstr ""
+msgstr "--full이 주어졌을 때, sys.path에 module_path 추가"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
-msgstr ""
+msgstr "프로젝트 이름 (기본값: 루트 모듈 이름)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
-msgstr ""
+msgstr "--full이 주어졌을 때, 프로젝트 작성자"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
-msgstr ""
+msgstr "--full이 주어졌을 때, 프로젝트 버전"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
-msgstr ""
+msgstr "--full이 주어졌을 때, 프로젝트의 릴리스이며 기본값은 --doc-version 값과 같음"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
-msgstr ""
+msgstr "확장 기능 옵션"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
-msgstr ""
+msgstr "%s은(는) 디렉토리가 아닙니다."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
-msgstr ""
+msgstr "잘못된 정규식 %r (%s에서)"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
-msgstr ""
+msgstr "소스에서 커버리지 테스트가 완료되었으며, %(outdir)s/python.txt 에서 결과를 확인하십시오."
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
-msgstr ""
+msgstr "coverage_c_regexes의 잘못된 정규표현식 %r"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr "문서화되지 않은 C API: %s [%s], 파일 %s"
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
-msgstr ""
+msgstr "%s 모듈을 가져올 수 없습니다: %s"
+
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr "문서화되지 않은 Python 함수: %s :: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr "문서화되지 않은 Python 클래스: %s :: %s"
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr "문서화되지 않은 Python 메소드: %s :: %s :: %s"
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
-msgstr ""
+msgstr "'%s' 옵션에 '+'나 '-'가 없습니다."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
-msgstr ""
+msgstr "'%s'은(는) 유효한 옵션이 아닙니다."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
-msgstr ""
+msgstr "'%s'은(는) 유효한 pyversion 옵션이 아닙니다"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
-msgstr ""
+msgstr "잘못된 TestCode 유형"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
-msgstr ""
+msgstr "소스에서 doctest 테스트가 완료되었으며, %(outdir)s/output.txt 에서 결과를 확인하십시오."
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
-msgstr ""
+msgstr "%s 블록(%s:%s)에 코드/출력 없음"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
-msgstr ""
+msgstr "잘못된 doctest 코드 무시: %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
-msgstr ""
+msgstr "====================== 가장 느린 읽기 시간 ======================="
 
 #: sphinx/ext/graphviz.py:132
 msgid "Graphviz directive cannot have both content and a filename argument"
-msgstr ""
+msgstr "Graphviz 지시문에 내용과 파일 이름 인수를 모두 지정할 수 없습니다"
 
 #: sphinx/ext/graphviz.py:142
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
-msgstr ""
+msgstr "외부 Graphviz 파일 %r을(를) 찾을 수 없거나 읽지 못했습니다"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
-msgstr ""
+msgstr "내용이 없는 \"graphviz\" 지시문을 무시합니다."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,16 +2612,16 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "dot이 출력 파일을 생성하지 않았습니다:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
-msgstr ""
+msgstr "dot 명령 %r을(를) 실행할 수 없습니다 (graphviz 출력에 필요). graphviz_dot 설정을 확인하십시오."
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,32 +2629,33 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "dot이 오류와 함께 종료되었습니다:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
-msgstr ""
+msgstr "graphviz_output_format은 'png', 'svg' 중 하나여야 하지만, 값이 %r 입니다"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
-msgstr ""
+msgstr "dot 코드 %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
-msgstr ""
+msgstr "[그래프: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
-msgstr ""
+msgstr "[그래프]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr ""
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
+msgstr "변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오: %s"
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
 #, python-format
@@ -2622,255 +2665,318 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "convert가 오류와 함께 종료되었습니다:\n[stderr]\n%r\n[stdout]\n%r"
+
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오."
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
-msgstr ""
+msgstr "LaTeX 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_latex 설정을 확인하십시오"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
-msgstr ""
+msgstr "%s 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_%s 설정을 확인하십시오"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
-msgstr ""
+msgstr "표시 LaTeX %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
-msgstr ""
+msgstr "인라인 LaTeX %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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 ""
+msgstr "intersphinx 인벤토리가 이동함: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
-msgstr ""
+msgstr "%s 에서 intersphinx 인벤토리 로드 중…"
 
-#: 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 ""
+msgstr "일부 인벤토리에서 몇 가지 문제가 발생했지만, 동작하는 대체 인벤토리로 처리했습니다:"
 
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
 msgid "failed to reach any of the inventories with the following issues:"
-msgstr ""
+msgstr "다음 문제가 있어 어느 인벤토리도 도달하지 못했습니다:"
 
-#: sphinx/ext/intersphinx.py:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
-msgstr ""
+msgstr "(%s v%s에서)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
-msgstr ""
+msgstr "(%s에서)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
-msgstr ""
+msgstr "intersphinx 식별자 %r이(가) 문자열이 아닙니다. 무시합니다"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
-msgstr ""
+msgstr "intersphinx_mapping[%s]을(를) 읽지 못했으며, 무시합니다: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[소스]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "할 일"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
-msgstr "TODO 항목을 찾았습니다: %s"
+msgstr "TODO 항목 발견: %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<원래 항목>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<원래 항목>>은 %s 파일, %d 행에 있습니다.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "원래 항목"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
-msgstr ""
+msgstr "모듈 코드 강조 중… "
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[문서]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "모듈 코드"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s의 소스 코드</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "개요: 모듈 코드"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
-msgstr ""
+msgstr "<h1>코드를 확인할 수 있는 모든 모듈</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr "member-order 옵션에 대해 잘못된 값: %s"
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
-msgstr ""
+msgstr "auto%s (%r)에 대한 잘못된 서명"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
-msgstr ""
+msgstr "%s에 대한 인수를 서식화하는 동안 오류 발생: %s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
-msgstr ""
+msgstr "%s 속성이 %s 객체에 없음"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autodoc: 문서화 할 %r을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
 "\"module\" or \"currentmodule\" directive in the document, or giving an "
 "explicit module name)"
-msgstr ""
+msgstr "%r의 자동 문서화를 위해 가져올 모듈을 알 수 없습니다 (문서에 \"module\" 또는 \"currentmodule\" 지시문을 배치하거나, 명시적으로 모듈 이름을 지정해 보십시오)"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr "%s에 대한 서명을 서식화하는 동안 오류 발생: %s"
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
-msgstr ""
+msgstr "automodule 이름의 \"::\"은 의미가 없음"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
-msgstr ""
+msgstr "automodule %s에 대해 서명 인수 또는 반환 값 주석이 지정됨"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
-msgstr ""
+msgstr "__all__은 %r이(가) 아닌 문자열의 목록이어야 합니다 (모듈 %s) -- __all__을 무시합니다"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr ""
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ":members: 옵션에 언급된 속성이 없습니다: 모듈 %s, 속성 %s"
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr "%s에 대한 함수 서명을 가져오지 못했습니다: %s"
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr "%s에 대한 생성자 서명을 가져오지 못했습니다: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "기반 클래스: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr ""
+msgid "alias of %s"
+msgstr "%s의 별칭"
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr "TypeVar(%s)의 별칭"
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr "%s에 대한 메소드 서명을 가져오지 못했습니다: %s"
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr "%s에서 잘못된 __slots__ 가 발견되었습니다. 무시합니다."
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr "autodoc_member_order는 이제 \"alphabetical\" 대신 \"alphabetic\"을 허용합니다. 설정을 업데이트하십시오."
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr "%r에 대한 기본 인수 값을 해석하지 못했습니다: %s"
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr "%r에 대한 서명을 업데이트하지 못했습니다. 매개변수를 찾을 수 없습니다: %s"
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
-msgstr ""
+msgstr "%r에 대한 type_comment를 해석하지 못했습니다: %s"
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
-msgstr ""
+msgstr "autosummary가 제외된 문서 %r을(를) 참조합니다. 무시합니다."
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
-msgstr ""
+msgstr "autosummary: 스텁 파일 %r을(를) 찾을 수 없습니다. autosummary_generate 설정을 확인하십시오."
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr "캡션이 있는 자동 요약에는 :toctree: 옵션이 필요합니다. 무시합니다."
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr ""
+msgid "autosummary: failed to import %s"
+msgstr "autosummary: %s을(를) import 하지 못했습니다"
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
-msgstr ""
+msgstr "이름 %s을(를) 해석하지 못함"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
-msgstr ""
+msgstr "객체 %s을(를) import 하지 못함"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
-msgstr ""
+msgstr "autosummary_generate: 파일을 찾을 수 없음: %s"
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
-msgstr ""
+msgstr "autosummary는 내부적으로 .rst 파일을 생성합니다. 하지만 source_suffix에 .rst가 포함되어 있지 않습니다. 건너뜁니다."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autosummary: 문서화 할 %r을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
-msgstr ""
+msgstr "[autosummary] 자동 요약 생성: %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
-msgstr ""
+msgstr "[autosummary] %s에 기록"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
-msgstr ""
+msgstr "[autosummary] %r을(를) import 하지 못했습니다: %s"
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,116 +2989,140 @@ msgid ""
 "``sphinx.ext.autosummary`` Python module and can be read using::\n"
 "\n"
 "  pydoc sphinx.ext.autosummary\n"
-msgstr ""
+msgstr "\nautosummary 지시문을 사용하여 ReStructuredText를 생성합니다.\n\nsphinx-autogen은 sphinx.ext.autosummary.generate의 프런트엔드입니다.\n주어진 입력 파일에 포함된 autosummary 지시문에서 reStructuredText 파일을 생성합니다.\n\nautosummary 지시문의 형식은 ``sphinx.ext.autosummary`` Python 모듈에 문서화되어 있으며 다음 명령을 사용하여 읽을 수 있습니다.\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
-msgstr ""
+msgstr "rST 파일을 생성할 원본 파일"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
-msgstr ""
+msgstr "모든 출력을 저장할 디렉토리"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
-msgstr ""
+msgstr "파일의 기본 확장자 (기본값: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
-msgstr ""
+msgstr "사용자 정의 템플릿 디렉토리 (기본값: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
-msgstr ""
+msgstr "가져온 멤버 문서화 (기본값: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
-msgstr "키워드 인수"
+msgstr "키워드 매개변수"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "예제"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "예제"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "참고"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "기타 매개변수"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr "수신"
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "참조"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
-msgstr ""
+msgstr "경고"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
-msgstr ""
+msgstr "생성"
+
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr "잘못된 값 세트 (닫는 중괄호 누락): %s"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr "잘못된 값 세트 (여는 중괄호 누락): %s"
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr "잘못된 문자열 리터럴 (닫는 따옴표 누락): %s"
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr "잘못된 문자열 리터럴 (여는 따옴표 누락): %s"
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "주의"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "조심"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "위험"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "오류"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "힌트"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "중요"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "참고"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "더 보기"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "팁"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "경고"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "이전 페이지에서 계속"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "다음 페이지에 계속"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:10
 msgid "Non-alphabetical"
-msgstr ""
+msgstr "알파벳 이외"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:12
 msgid "Numbers"
@@ -3002,181 +3132,181 @@ msgstr "숫자"
 msgid "page"
 msgstr "페이지"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "목차"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "검색"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "이동"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "소스 보기"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "개요"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
-msgstr ""
+msgstr "환영합니다!"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
-msgstr ""
+msgstr "문서:"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "최종 업데이트"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "색인 및 표 목록:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "종합 목차"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
-msgstr "영역별 목차"
+msgstr "모든 구역과 하위 구역 목록"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "문서 검색"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "모듈 총 색인"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "모든 모듈 조견표"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "함수, 클래스 및 용어 개관"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
-msgstr ""
+msgstr "색인 &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "한 페이지에 전체 색인 보기"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "알파벳별 색인"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "큰 경우가 있으므로 주의"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "탐색"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s에서 찾기"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "이 문서 정보"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "저작권"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
-msgstr ""
+msgstr "&#169; <a href=\"%(path)s\">저작권</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
-msgstr ""
+msgstr "&#169; 저작권 %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "최종 업데이트: %(last_updated)s"
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "<a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s 버전으로 생성되었습니다."
+msgstr "<a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s 버전으로 생성되었습니다."
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "%(docstitle)s에서 찾기"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "이전 항목"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "이전 장"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "다음 항목"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "다음 장"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "검색 기능을 사용하려면 JavaScript를 활성화하십시오."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
-msgstr ""
+msgstr "여러 단어를 검색하면 모든 단어가 포함된 일치 항목만 표시됩니다."
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "검색"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "검색 결과"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
-msgstr ""
+msgstr "검색어와 일치하는 문서가 없습니다. 모든 단어의 철자가 올바른지, 충분한 카테고리를 선택했는지 확인하십시오."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "빠른 검색"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "현재 문서"
 
@@ -3184,45 +3314,45 @@ msgstr "현재 문서"
 #: sphinx/themes/basic/changes/versionchanges.html:12
 #, python-format
 msgid "Changes in Version %(version)s &#8212; %(docstitle)s"
-msgstr ""
+msgstr "버전 %(version)s의 변경 사항 &#8212; %(docstitle)s"
 
 #: sphinx/themes/basic/changes/rstsource.html:5
 #, python-format
 msgid "%(filename)s &#8212; %(docstitle)s"
-msgstr ""
+msgstr "%(filename)s &#8212; %(docstitle)s"
 
 #: sphinx/themes/basic/changes/versionchanges.html:17
 #, python-format
 msgid "Automatically generated list of changes in version %(version)s"
-msgstr "버전 %(version)s의 변경 사항 (이 목록은 자동으로 생성합니다)"
+msgstr "버전 %(version)s의 변경 사항 (자동으로 생성된 목록)"
 
 #: sphinx/themes/basic/changes/versionchanges.html:18
 msgid "Library changes"
-msgstr "라이브러리에 대한 변경"
+msgstr "라이브러리 변경 사항"
 
 #: sphinx/themes/basic/changes/versionchanges.html:23
 msgid "C API changes"
-msgstr "C API에 대한 변경"
+msgstr "C API 변경 사항"
 
 #: sphinx/themes/basic/changes/versionchanges.html:25
 msgid "Other changes"
 msgstr "다른 변경 사항"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
-msgstr "제목 주소"
+msgstr "이 표제에 대한 퍼머링크"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
-msgstr "정의 주소"
+msgstr "이 정의에 대한 퍼머링크"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
-msgstr "검색 결과 숨기기"
+msgstr "검색 일치 숨기기"
 
 #: sphinx/themes/basic/static/searchtools.js:136
 msgid "Searching"
@@ -3232,12 +3362,12 @@ msgstr "검색 중"
 msgid "Preparing search..."
 msgstr "검색 준비 중…"
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
+msgstr "검색이 완료되었으며, 검색어와 일치하는 %s 개 페이지를 찾았습니다."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", 문서 - "
 
@@ -3250,7 +3380,7 @@ msgstr "사이드바 열기"
 msgid "Collapse sidebar"
 msgstr "사이드바 닫기"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "내용"
 
@@ -3258,210 +3388,218 @@ msgstr "내용"
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
-msgstr ""
+msgstr "4 개 열 기반 색인을 찾았습니다. 사용하고 있는 확장 기능의 버그일 수 있습니다: %r"
 
 #: sphinx/transforms/__init__.py:263
 #, python-format
 msgid "Footnote [%s] is not referenced."
-msgstr ""
+msgstr "각주 [%s]이(가) 참조되지 않았습니다."
 
 #: sphinx/transforms/__init__.py:269
 msgid "Footnote [#] is not referenced."
-msgstr ""
+msgstr "각주 [#]이 참조되지 않았습니다."
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
-msgstr ""
+msgstr "번역된 메시지의 각주 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
-msgstr ""
+msgstr "번역된 메시지의 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
-msgstr ""
+msgstr "번역된 메시지의 인용 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
-msgstr ""
+msgstr "번역된 메시지의 용어 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}"
+
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr "상호 참조에 대한 대체 텍스트를 결정할 수 없습니다. 버그일 수 있습니다."
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
-msgstr ""
+msgstr "'any' 상호 참조 %r에 대해 둘 이상의 대상이 발견되었습니다: %s 일 수 있습니다"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr ""
+msgid "%s:%s reference target not found: %s"
+msgstr "%s:%s 참조 대상을 찾을 수 없음: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr ""
+msgid "%r reference target not found: %s"
+msgstr "%r 참조 대상을 찾을 수 없음: %s"
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
-msgstr ""
+msgstr "원격 이미지를 가져올 수 없습니다: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
-msgstr ""
+msgstr "원격 이미지를 가져올 수 없습니다: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
-msgstr ""
+msgstr "알 수 없는 이미지 형식: %s…"
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "디코드 할 수 없는 원본 문자이며, \"?\"로 대체합니다: %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
-msgstr ""
+msgstr "건너뜀"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
-msgstr ""
+msgstr "실패"
+
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr "알 수 없는 지시문 또는 역할 이름: %s:%s"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "읽기 오류: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "쓰기 오류: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
-msgstr ""
+msgstr "잘못된 날짜 형식입니다. 바로 출력하려면 작은 따옴표로 문자열을 인용하십시오: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
-msgstr ""
+msgstr "toctree에 존재하지 않는 파일 %r에 대한 참조가 있음"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
-msgstr ""
+msgstr "only 지시문 식을 평가하는 동안 예외 발생: %s"
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
-msgstr ""
+msgstr "기본 역할 %s을(를) 찾을 수 없음"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
-msgstr ""
+msgstr "numfig_format이 %s에 대해 정의되지 않음"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
-msgstr ""
+msgstr "%s 노드에 할당되지 않은 ID"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr "이 용어에 대한 퍼머링크"
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "이 표에 대한 퍼머링크"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "이 코드에 대한 퍼머링크"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "이 이미지에 대한 퍼머링크"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "이 목차에 대한 퍼머링크"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
-msgstr ""
+msgstr "이미지 크기를 얻어올 수 없습니다. :scale: 옵션을 무시합니다."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
-msgstr ""
+msgstr "알 수 없는 %r toplevel_sectioning (클래스 %r)"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
-msgstr ""
+msgstr ":maxdepth:가 너무 크며, 무시합니다."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
-msgstr ""
+msgstr "문서 제목이 단일 텍스트 노드가 아님"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
-msgstr ""
+msgstr "구역, 주제, 표, 조언, 사이드바 안에 있지 않은 제목 노드가 발견됨"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "각주"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
-msgstr ""
+msgstr "tabularcolumns와 :widths: 옵션이 모두 설정되었습니다. :widths:는 무시됩니다."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
-msgstr ""
+msgstr "치수 단위 %s이(가) 잘못되었습니다. 무시합니다."
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
-msgstr ""
+msgstr "알 수 없는 색인 항목 유형 %s이(가) 발견됨"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[그림: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[그림]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
-msgstr ""
+msgstr "캡션이 그림 안에 있지 않습니다."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
-msgstr ""
+msgstr "구현되지 않은 노드 유형: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
-msgstr ""
+msgstr "알 수 없는 노드 유형: %r"
diff --git a/sphinx/locale/lt/LC_MESSAGES/sphinx.po b/sphinx/locale/lt/LC_MESSAGES/sphinx.po
index 4df91eb54e2..f71ac4e09d0 100644
--- a/sphinx/locale/lt/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/lt/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # DALIUS DOBRAVOLSKAS <DALIUS@SANDBOX.LT>, 2010
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Lithuanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lt/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: lt\n"
 "Plural-Forms: nplurals=4; plural=(n % 10 == 1 && (n % 100 > 19 || n % 100 < 11) ? 0 : (n % 10 >= 2 && n % 10 <=9) && (n % 100 > 19 || n % 100 < 11) ? 1 : n % 1 != 0 ? 2: 3);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Įtaisytieji"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Modulio lygis"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (kuris yra "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y-%m-%d"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Bendras indeksas"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "indeksas"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "kitas"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "praeitas"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Indeksas"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Leidimas"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Skyriaus autorius: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Modulio autorius: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Kodo autorius: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autorius: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametrai"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Grąžinamos reikšmės"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Grąžinamos reikšmės tipas"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C funkcija)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C narys)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C makrokomanda)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C tipas)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "narys"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C kintamasis)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "kintamasis"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funkcija"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "narys"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makrokomanda"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tipas"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "kintamasis"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nauja %s versijoje"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Pakeista %s versijoje"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Nebepalaikoma nuo %s versijos"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Išmeta"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klasė"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (itaisytoji funkcija)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metodas)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasė)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globalus kintamasis arba konstanta)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atributas)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumentais"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modulis)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metodas"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "duomenys"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribudas"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modulis"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "bazinis žodis"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operatorius"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objektas"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "išimtis"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "sakinis"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "įtaisytoji funkcija"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Kintamieji"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Sukelia"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (modulyje %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (įtaisytasis kintamasis)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (modulje %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (įtaisytasis kintamasis)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (įtaisytoji klasė)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasė iš %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metodas)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s klasės metodas)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s statinis metodas)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statinis metodas)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s klasės metodas)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s klasės metodas)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s atributas)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduliai"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Atmestas"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "klasės metodas"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statinis metodas"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (atmestas)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktyva)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rolė)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktyva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rolė"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "aplinkos kintamasis; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "aiškinamasis terminas"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "gramatinė leksema"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "nuorodos požymis"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "aplinkos kintamasis"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "programos parinktis"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Modulio indeksas"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Paieškos puslapis"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[šaltinis]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Padaryti"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "originalus įrašas"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dokumentai]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Modulio kodas"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kodas %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Apžvalga: modulio kodas"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Visi moduliai turintys kodą</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr ":class:`%s` alternatyvus vardas"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Dėmesio"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Atsargiai"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Pavojinga"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Klaida"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Patarimas"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Svarbu"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Pastaba"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Taip pat žiūrėkite"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Patarimas"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Įspėjimas"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "tęsinys iš praeito puslapio"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,181 +3131,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Paieška"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Pirmyn"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Rodyti pirminį kodą"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Apžvalga"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indeksai ir lentelės:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Pilnas Turinys"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "surašyti visus skyrius ir poskyrius"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "ieškoti šiame dokumente"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Globalus Modulio Indeksas"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "greitas visų modulių pasiekimas"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "visos funkcijos, klasės ir terminai"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Indeksas &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Pilnas indeksas viename puslapyje"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indekso puslapiai pagal raidę"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "gali būti didelis"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigacija"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Ieškoti tarp %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Apie šiuos dokumentus"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Autoriaus teisės"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Paskutinis atnaujinimas %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Sukurta naudojant <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Ieškoti %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Praeita tema"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "praeita dalis"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Kita tema"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "kita dalis"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Prašome aktyvuoti JavaScript, kad veiktų paieškos\n    funkcionalumas."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "ieškoti"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Paieškos rezultatai"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Greitoji paieška"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Šis puslapis"
 
@@ -3207,19 +3337,19 @@ msgstr "C API pakeitimai"
 msgid "Other changes"
 msgstr "Kiti pakeitimai"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Nuoroda į šią antraštę"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Nuoroda į šį apibrėžimą"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Paslėpti paieškos rezultatus"
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr "Išplėsti šoninę juostą"
 msgid "Collapse sidebar"
 msgstr "Paslėpti šoninę juostą"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Turinys"
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Išnašos"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[paveiksliukas]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/lv/LC_MESSAGES/sphinx.po b/sphinx/locale/lv/LC_MESSAGES/sphinx.po
index ca8ef8240a6..c8e6e8f4c6b 100644
--- a/sphinx/locale/lv/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/lv/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Latvian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lv/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: lv\n"
 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n != 0 ? 1 : 2);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Iebūvētie"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Moduļu līmenis"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (iekš "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d.%m.%Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Vispārējs indekss"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "indekss"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "nākošais"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "iepriekšējs"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Indekss"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Izlaidums"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Sekcijas autors: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Moduļa autors: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Koda autors: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autors: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametri"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Atgriež"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Atgriežamais tips"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C funkcija)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C loceklis)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C makross)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C tips)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "loceklis"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C mainīgais)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "mainīgais"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funkcija"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "loceklis"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makross"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tips"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "mainīgais"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Jauns versijā %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Mainīts versijā %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Neieteicams no versijas %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Izmet"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klase"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (iebūvēta funkcija)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metods)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globālais mainīgais vai konstanta)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atributs)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumenti"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modulis)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metods"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "dati"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atributs"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modulis"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "atslēgas vārds"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operators"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekts"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "izņēmums"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "priekšraksts"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "iebūvēta funkcija"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Mainīgie"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Ceļ"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (moduļī %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (iebūvētais mainīgais)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (moduļī %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (iebūvētais mainīgais)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (iebūvēta klase)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klase iekš %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metods)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s klases metods)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s statiskais metods)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statiskais metods)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s klases metods)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s klases metods)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s atributs)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduļi"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Nav ieteicams"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "klases metods"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statiskais metods"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktīva)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktīva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "role"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "apkārtnes mainīgais; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "glosārija termins"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "gramatiskais marķieris"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "atsauces virsraksts"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "apkārtnes mainīgais"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "programmas opcija"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Moduļu indekss"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Atlases lapa"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[kods]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Jāizdara"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "sākotnējs ieraksts"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dokumenti]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Moduļa teksts"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s izejas teksts</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Apskats: moduļa teksts"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Visi moduļi, kuriem ir izejas teksti</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "aizstājvārds klasei :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Uzmanību"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Uzmanies"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Bīstami"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Kļūda"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Mājiens"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Svarīgi"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Piezīme"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Skat.arī"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Padoms"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Brīdinājums"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "turpinājums no iepriekšējās lappuses"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,181 +3130,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Meklēt"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Izpildīt"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Rādīt izejas tekstu"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Apskats"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indeksi un tabulas:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Pilns saturs"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "rāda visas sekcijas un apakšsekcijas"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "meklēt šajā dokumentācijā"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Vispārējs moduļu indekss"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "ātra piekļuve visiem moduliem"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "visas funkcijas, klases un termini"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Indekss &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Pilns indekss vienā lappusē"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Lappušu indekss pēc burtiem"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "var būt milzīgs"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigācija"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Meklēt iekš %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Par šiem dokumentiem"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Pēdējas izmaiņas %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Sagatavots izmantojot <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "%(docstitle)s meklēšana"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "iepriekšēja tēma"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "iepriekšēja sadaļa"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "nākoša tēma"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "nākoša sadaļa"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Lai iespējotu meklēšanu, lūdzu aktivizēt JavaScript."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "meklēt"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Atlases rezultāti"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Ātra meklēšana"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Šī lappuse"
 
@@ -3206,19 +3336,19 @@ msgstr "Izmaiņas iekš C API"
 msgid "Other changes"
 msgstr "Citas izmaiņas"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Pastāvīga norāde šo virsrakstu"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Pastāvīga norāde uz šo definīciju"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Paslēpt atlases vārdus"
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr "Izplest sānjoslu"
 msgid "Collapse sidebar"
 msgstr "Savērst sānjoslu"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Saturs"
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Vēres"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[attēls: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[attēls]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/mk/LC_MESSAGES/sphinx.po b/sphinx/locale/mk/LC_MESSAGES/sphinx.po
index 397828d91c0..bc48753b49c 100644
--- a/sphinx/locale/mk/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/mk/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Vasil Vangelovski <vvangelovski@gmail.com>, 2013
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Macedonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/mk/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: mk\n"
 "Plural-Forms: nplurals=2; plural=(n % 10 == 1 && n % 100 != 11) ? 0 : 1;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Предлог за подобрување на Python; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Вградени"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Ниво на модул"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (во "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Главна содржина"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "содржина"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "следна"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "претходна"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s документација"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Автор на секцијата:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Автор на модул:"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Автор на код:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Автор: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Параметри"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Враќа"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Повратен тип"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (C функција)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C член)"
-
-#: sphinx/domains/c.py:191
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C macro)"
-msgstr "%s (C макро)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C тип)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "член"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C променлива)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "променлива"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "функција"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "член"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "макро"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "тип"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "променлива"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Фрла"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "класа"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr ""
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (вградена функција)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s метод)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (класа)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "погледни %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "погледни %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Симболи"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,124 +3131,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3127,55 +3257,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3207,19 +3337,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
index 05fe2c92cbe..20d423ea490 100644
--- a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Norwegian Bokmål (Norway) (http://www.transifex.com/sphinx-doc/sphinx-1/language/nb_NO/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: nb_NO\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Innebygde"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Modulnivå"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(i "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Hovedindex"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "neste"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "forrige"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Utgivelse"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Seksjon forfatter: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Modul forfattar: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Kildekode forfatter: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Forfatter: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametere"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Returnere"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Retur type"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C-funktion)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C-medlem)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C-makro)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C-type)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "medlem"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C-variabel)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variabel"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funksjon"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "medlem"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "type"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variabel"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nytt i version %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Endret i version %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Foreldet siden version %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Kaster"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klasse"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (innebygd funksjon)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metode)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasse)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (global variabel eller konstant)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribut)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argument"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metode"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "attributt"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "nøkkelord"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "untak"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "uttrykk"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "innebygde funksjoner"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variabler"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Hever"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (i modul %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (innebygd variabel)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (i modul %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (innebygd variabel)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (innebygd klasse)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasse i %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metode)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s klassemetode)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s statisk metode)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statisk metode)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s klassemetode)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s klassemetode)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s attributt)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python Modulindex"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduler"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Foreldet"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "klassemetode"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statisk metode"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (foreldet)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiv)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rolle)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktiv"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rolle"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "miljøvariabel; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "ordliste"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "grammatikk token"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "referanse-etikett"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "miljøvariabel"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "programvalg"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Modulindex"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Søkeside"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "se %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "se også %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[kilde]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "opprinnelig oppføring"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dokumentasjon]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Modul kildekode"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kildekode for %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Oversikt: modulkildekode"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alla moduler hvor kildekode finnes</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias for :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Obs"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Advarsel"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Fare"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Feil"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Hint"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Viktig"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Obs"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Se også"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tips"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Advarsel"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "fortsettelse fra forrige side"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,181 +3130,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Søk"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Gå"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Vis kildekode"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Oversikt"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Index og tabeller"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Komplett Innholdsfortegnelse"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "liste over alle paragrafer og underparagrafer"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "søk i dette dokumentet"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Global Modulindex"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "snarvei til alle moduler"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "alla funksjoner, klasser, vilkår"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Index &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Hele innholdsfortegnelsen på en side"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Innholdsfortegnelse per bokstav"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "kan bli stor"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigering"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Søk blant %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Om disse dokumenter"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Sist oppdatert %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Lagd med <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Søk %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Forrige tittel"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "Forrige kapittel"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Neste emne"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "neste kapittel"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Vennligst aktiver JavaScript for å aktivere søk."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "søk"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Søkeresultat"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Hurtigsøk"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Denne siden"
 
@@ -3206,19 +3336,19 @@ msgstr "Endringer i C API"
 msgid "Other changes"
 msgstr "Andre endringer"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Permalink til denne oversikten"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Permalink til denne definisjonen"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Skjul søkeresultat"
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr "Utvid sidepanelet"
 msgid "Collapse sidebar"
 msgstr "Skjul sidepanelet"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Innhold"
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Fotnoter"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[bilde]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/ne/LC_MESSAGES/sphinx.po b/sphinx/locale/ne/LC_MESSAGES/sphinx.po
index 22e4ef6263c..c8ed1607f21 100644
--- a/sphinx/locale/ne/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ne/LC_MESSAGES/sphinx.po
@@ -1,149 +1,154 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2011
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Nepali (http://www.transifex.com/sphinx-doc/sphinx-1/language/ne/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: ne\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -151,12 +156,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -164,59 +169,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,58 +229,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -283,405 +281,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "बिइल्टिन्स"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "मडुलको तह"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -690,160 +713,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(in"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -853,18 +880,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -879,290 +906,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "सामान्य  अनुसुची"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "अनुसुची"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "पछिल्लो"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "अघिल्लो"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "अनुसुची"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "रीलीज"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1181,277 +1220,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1460,15 +1493,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1478,21 +1511,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1500,91 +1533,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1594,787 +1627,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "सेक्सनको लेखक"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "मडुलको लेखक"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Codeको लेखक "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "लेखक"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parameters"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Returns"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Return type"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C कार्य)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C सदस्य)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C बृहत)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C किसिम)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "सदस्य"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C चल)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "चल"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "फन्क्सन"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "सदस्य"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "बृहत"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "किसिम"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "चल"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "भर्सन %s मा नयाँ"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "भर्सन  %s मा बदलिएको"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Deprecated since version %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Throws"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "कक्षा"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (built-in function)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s विधी)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (कक्षा)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (global variable or constant)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribute)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Arguments"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (मडुल)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "विधी"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "attribute"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "मडुल"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "मुख्य शब्द"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "सन्चालक"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "object"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "अपबाद"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "भनाई"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "built-in फन्क्सन"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "चलहरू"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Raises"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (in मडुल %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (built-in चल)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (in मडुल %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (built-in चल)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (built-in कक्षा)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (कक्षा in %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s विधी)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s कक्षा विधी)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s static विधी)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s static विधी)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s कक्षा विधी)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s कक्षा विधी)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s attribute)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python Module Index"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "modules"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Deprecated"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "कक्षा विधी"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "static विधी"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr "(deprecated)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (निर्देशिक)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (भूमिका)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "निर्देशिक"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "भूमिका"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "environment variable; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "शब्द-अर्थमा भएको"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "grammar token"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "सन्दर्व सामग्री"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "environment variable"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "कार्यक्रमका बिकल्प"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "मडुल अनुसुची"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "पानामा खोज्नुहोस्"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "%s हेर्नुहोस्"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "%s पनि हेर्नुहोस् "
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2386,165 +2408,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2558,11 +2600,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2572,14 +2614,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2589,29 +2631,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2624,148 +2667,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[स्रोत]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "मौलिक इन्ट्री"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Module code"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Source code for %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "पुनरावलोकन: module code"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>All modules for which code is available</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2773,104 +2826,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias of :class:`%s`"
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2885,107 +2991,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "ध्यानाकर्षण"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "होसियार "
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "खतरा"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "गलत"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "सङ्केत"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "जरुरी"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "टिप्पणी"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "पनि हेर्नुहोस"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "साबधान"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "अघिल्लो पानासँग जोडीएको"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3002,124 +3132,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "खोज्नुहोस् "
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "जानुहोस्"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "स्रोत देखाउनुहोस् "
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "पुनरावलोकन "
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "इन्डीसीस्स र तलिका"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "पुरा विषयसूची"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "सबै सेक्सन र सवसेक्सन देखाउनुहोस्"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "यो डकुमेन्ट खोज्नुहोस्"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "ग्लोबल मडुल अनुसुची"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "सबै मोदुलेसमा छिटै जानुहोस्"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "सबै फन्क्सनस्, कक्षाहरू र टर्मस्"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Index &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "पुरा अनुसुची एकै पानामा"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "अक्षर अनुसार अनुसुचीका पाना"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "धेरै ठुलो हुन सक्छ"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "नेभिगेसन "
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "यी डकुमेन्टहरुको बारेमा"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "कपिराइट "
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "यो भन्दा अगाडी %(last_updated)s मा अपडेट भएको"
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3128,55 +3258,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "अघिल्लो विषय "
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "अघिल्लो खन्ड"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "पछिल्लो विषय"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "पछिल्लो खन्ड"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "खोज्ने कार्य आगाडी बढाउनको लागि जाभास्कृप्ट चलाईदिनुहोस "
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "खोज्नुहोस्"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "खोजेको नतिजा"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "छिट्टो खोज्नुहोस्"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "यो पाना"
 
@@ -3208,19 +3338,19 @@ msgstr "C API का  परिवर्तनहरु "
 msgid "Other changes"
 msgstr "अरु परिवर्तनहरु "
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "यो शिर्षकको लागि पर्मालिन्क । "
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "यो अर्थको लागि पर्मालिन्क"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "खोजेको नतिजाहरु लुकाउनुहोस्"
 
@@ -3232,12 +3362,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3250,7 +3380,7 @@ msgstr "साइडबर ठुलो बनाउनुहोस्"
 msgid "Collapse sidebar"
 msgstr "साइडबर सानो बनाउनुहोस्"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "विषयसूची"
 
@@ -3269,199 +3399,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "फूट्नोट्स"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[चित्र]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/nl/LC_MESSAGES/sphinx.po b/sphinx/locale/nl/LC_MESSAGES/sphinx.po
index 4bdf9f43b6e..934e0cbf81d 100644
--- a/sphinx/locale/nl/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/nl/LC_MESSAGES/sphinx.po
@@ -1,7 +1,7 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Bram Geron, 2017
 # brechtm, 2016
@@ -13,141 +13,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Dutch (http://www.transifex.com/sphinx-doc/sphinx-1/language/nl/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: nl\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "configuratiemap bevat geen conf.py bestand (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Kan bronmap niet vinden (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Bron- en doelmap kunnen niet identiek zijn"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s start op"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Dit project vereist tenminste Sphinx v%s, en kan daarom niet worden gebouwd met deze versie."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "aanmaken doelmap"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' gedefinieerd in conf.py is niet aanroepbaar (geen Python-callable). Pas a.u.b. de definitie aan zodat het een oproepbare functie wordt. Dit is nodig voor conf.py om zich als een Sphinx extensie te gedragen."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "laden van vertalingen [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "klaar"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "mislukt: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Geen bouwer geselecteerd, dus de standaardbouwer wordt gebruikt: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "gelukt"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "afgerond met problemen"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "bouwen %s, %s waarschuwing."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "bouwen %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -155,12 +160,12 @@ msgid ""
 "explicit"
 msgstr "de %s extensie geeft niet aan of deze veilig is voor parallel lezen, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -168,59 +173,59 @@ msgid ""
 "explicit"
 msgstr "de %s extensie geeft niet aan of deze veilig is voor parallel schrijven, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "seriële verwerking van %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "kan dictionary-instelling %r niet overschrijven in configuratie, wordt genegeerd (gebruik %r om individuele elementen te overschrijven)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "ongeldig getal %r voor configuratiewaarde %r, wordt genegeerd"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "kan instelling %r niet overschrijven met zo'n waarde van een niet-ondersteund type; wordt genegeerd"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "onbekende configuratiewaarde %r tijdens overschrijven, wordt genegeerd"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Ongeldige configuratiewaarde: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Configuratiewaarde %r was reeds aangevoerd"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -228,58 +233,51 @@ msgid ""
 "%s"
 msgstr "Een fout heeft zich voorgedaan in uw configuratiebestand:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Sectie %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabel %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Codefragment %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "De waarde voor configuratievariabele %r is een tekenreeks met karakters buiten de ASCII-set. Dit kan leiden tot problemen met de Unicode tekencodering. Maak alstublieft gebruik van Unicode-tekenreeksen, bijvoorbeeld: %r."
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -287,405 +285,430 @@ msgstr "primary_domain %r onbekend, wordt genegeerd."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Gebeurtenis %r bestaat reeds"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Onbekende gebeurtenisnaam: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Dit project vereist extensie %s met versie %s of hoger, en kan daarom niet met de geladen versie (%s) worden gebouwd"
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Bouwerklasse %s heeft geen \"name\"-attribuut"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Bouwer %r bestaat reeds (in module %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Bouwernaam %s is niet geregistreerd of beschikbaar via entrypoint"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Bouwernaam %s is niet geregistreerd"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "domein %s was reeds geregistreerd"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domein %s nog niet geregistreerd"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser voor %r is reeds geregistreerd"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Broncode-parser voor %s is niet geregistreerd"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "extensie %r is reeds in Sphinx ingevoegd sinds Sphinx-versie %s; deze extensie wordt genegeerd."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Oorspronkelijke exceptie:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Kon extensie %s niet importeren"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "extensie %r heeft geen setup() functie; weet u zeker dat het een Sphinx-extensiemodule is?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Dit project gebruikt extensie %s, maar die extensie heeft Sphinx-versie v%s of hoger nodig; het project kan daarom niet worden gebouwd met deze versie."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "de setup() functie van extensie %r retourneerde een niet-ondersteund object; dit moet None of een metadata dictionary zijn"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "thema %r heeft geen \"theme\" instelling"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "thema %r heeft geen \"inherit\" instelling"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "thema met naam %r niet gevonden, geërfd door %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "instelling %s.%s komt niet voor in de doorzochte thema configuraties"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "bestand %r in thema pad is geen geldige zipfile of bevat geen thema"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme is sinds versie 1.4.0 niet langer een harde afhankelijkheid. Installeer het handmatig. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "thema met naam %r niet gevonden (ontbrekende theme.conf?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "bestand %r zoals gegeven op de opdrachtregel is niet aanwezig in de bronmap, wordt genegeerd"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Builtins"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Moduleniveau"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -694,160 +717,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (in "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -857,18 +884,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -883,290 +910,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "de waarde voor de configuratievariabele html_use_opensearch moet een tekenreeks zijn"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Algemene index"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "volgende"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "vorige"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s documentatie"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Release"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1185,277 +1224,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "pad naar doelmap"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Naam van het project"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Auteur(s)"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1464,15 +1497,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Versie van het project"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Release van het project"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1482,21 +1515,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1504,91 +1537,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Bestandsnaam van het hoofddocument (zonder bestandsextensie)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Fout: hoofddocumentbestandsnaam %s is reeds aanwezig op het aangewezen pad."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Afgerond: een beginstructuur van mappen is aangemaakt."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1598,787 +1631,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "release van project"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "documenttaal"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "bestandsextensie van bronbestanden"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "bestandsnaam van hoofddocument"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "sjabloonmap voor sjabloonbestanden"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "Overmatige negative inspringing gevonden"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Ongeldig onderschrift: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Gebruik van zowel \"%s\" als \"%s\" opties is niet toegestaan"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Include bestand %r is niet gevonden of het lezen is mislukt"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Encodering %r gebruikt voor het lezen van include-bestand %r lijkt verkeerd, probeer een :encoding: optie te specificeren"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Object met naam %r is niet gevonden in include bestand %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "\"lineno-match\" kan niet gebruikt worden met een disjuncte set \"lines\""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Regels %r: geen regels gebruikt uit include-bestand %r"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Auteur van deze sectie: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Auteur van deze module: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Auteur van deze broncode:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Auteur: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parameters"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Returns"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Return type"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (C-functie)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C-member)"
-
-#: sphinx/domains/c.py:191
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C macro)"
-msgstr "%s (C-macro)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C-type)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "member"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C-variabele)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variabele"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "functie"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "member"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerator"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "type"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variabele"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nieuw in versie %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Veranderd in versie %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Verouderd sinds versie %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Sjabloonparameters"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Werpt"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klasse"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "concept"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerator"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (ingebouwde functie)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s methode)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasse)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globale variabele of constante)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribuut)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumenten"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (module)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "methode"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "attribuut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "module"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "duplicaatlabel van formule %s, andere in %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "trefwoord"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "object"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "exceptie"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "statement"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "ingebouwde functie"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variabelen"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Veroorzaakt"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (in module %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (geïntegreerde variabele)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (in module %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (geïntegreerde variabele)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (geïntegreerde klasse)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasse in %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (methode van %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s klassemethode)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (statische methode van %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statische methode van %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s klassemethode)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s klassemethode)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (attribuut van %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python-moduleïndex"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "modules"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Verouderd"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "klassemethode"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statische methode"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (verouderd)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directive)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "directive"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rol"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "omgevingsvariabele; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "woordenlijstterm"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "grammaticatoken"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "verwijzingslabel"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "omgevingsvariabele"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "programmaoptie"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "document"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Module-index"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Zoekpagina"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "onderschrift ontbreekt voor link: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "bronmap is gewijzigd"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "zie %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "zie %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symbolen"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2390,165 +2412,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "bestandsextensie (standaardwaarde: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s is geen map."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "ontbrekende '+' of '-' in optie '%s'."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' is geen geldige optie."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' is geen geldige pyversion optie"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2562,11 +2604,11 @@ msgstr "Graphviz directive mag niet zowel inhoud als een bestandsnaam argument h
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Extern Graphviz bestand %r niet gevonden of het lezen is mislukt"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "\"graphviz\" directive zonder inhoud wordt genegeerd."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2576,14 +2618,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot commando %r kan niet worden uitgevoerd (vereist voor graphviz output), controleer de instelling graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2593,29 +2635,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format moet 'png' of 'svg' zijn, maar is %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graaf: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graaf]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2628,148 +2671,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Permalink naar deze formule"
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(in %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(in %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[broncode]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Te doen"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<origineel item>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Het <<originele item>> bevindt zich in %s, regel %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "originele item"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[documentatie]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Modulebroncode"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Broncode voor %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Overzicht: module broncode"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alle modules waarvoor de broncode beschikbaar is</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2777,104 +2830,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Basisklassen: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias voor :class:`%s`"
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2889,107 +2995,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Sleutelwoordargumenten"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "Verwijzingen"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Let op"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Pas op"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Gevaar"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Fout"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Hint"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Belangrijk"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Notitie"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Zie ook"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Waarschuwing"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "Vervolgd van vorige pagina"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "Vervolgt op volgende pagina"
@@ -3006,181 +3136,181 @@ msgstr ""
 msgid "page"
 msgstr "pagina"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Zoeken"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Zoek"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Broncode weergeven"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Overzicht"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Welkom! Dit is"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "de documentatie voor"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "laatst bijgewerkt"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indices en tabellen:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Volledige inhoudsopgave"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "geeft alle secties en subsecties weer"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "zoeken in deze documentatie"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Globale Module-index"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "sneltoegang naar alle modules"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "alle functies, klasses en begrippen"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Index &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Volledige index op één pagina"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Index pagineerd per letter"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "kan heel groot zijn"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigatie"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Zoeken in %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Over deze documenten"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Laatste aanpassing op %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Aangemaakt met <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Zoek in %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Vorig onderwerp"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "vorig hoofdstuk"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Volgend onderwerp"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "volgend hoofdstuk"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Activeer JavaSscript om de zoekfunctionaliteit in te schakelen."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "zoeken"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Zoekresultaten"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Uw zoekopdracht leverde geen resultaten op. Zorg ervoor dat alle woorden juist zijn gespeld en dat u voldoende categorieën hebt geselecteerd."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Snel zoeken"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Deze pagina"
 
@@ -3212,19 +3342,19 @@ msgstr "Veranderingen in de C-API"
 msgid "Other changes"
 msgstr "Andere veranderingen"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Permalink naar deze titel"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Permalink naar deze definitie"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Zoekresultaten verbergen"
 
@@ -3236,12 +3366,12 @@ msgstr "Bezig met zoeken"
 msgid "Preparing search..."
 msgstr "Zoeken aan het voorbereiden..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Zoekopdracht voltooid, %s pagaina(s) gevonden die overeenkomen met de zoekterm."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", in"
 
@@ -3254,7 +3384,7 @@ msgstr "Zijpaneel uitklappen"
 msgid "Collapse sidebar"
 msgstr "Zijpaneel inklappen"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Inhoudsopgave"
 
@@ -3273,199 +3403,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "meer dan één doel gevonden voor 'any' kruisverwijzing %r: is mogelijk %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s verwijzingsdoel niet gevonden: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "%r verwijzingsdoel niet gevonden: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Permalink naar deze tabel"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Permalink naar deze broncode"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Permallink naar deze afbeelding"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Permalink naar deze toctree"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Voetnoten"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[afbeelding: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[afbeelding]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "onderschrift niet binnen figuur."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/pl/LC_MESSAGES/sphinx.po b/sphinx/locale/pl/LC_MESSAGES/sphinx.po
index 73b7a64786d..5e865275f09 100644
--- a/sphinx/locale/pl/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pl/LC_MESSAGES/sphinx.po
@@ -1,151 +1,156 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # m_aciek <maciej.olko@gmail.com>, 2017-2020
 # Michael Gielda <michal.gielda@gmail.com>, 2014
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2018
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2018
 # Tawez, 2013-2019
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Polish (http://www.transifex.com/sphinx-doc/sphinx-1/language/pl/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: pl\n"
 "Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && (n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "folder konfiguracyjny nie zawiera pliku conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Nie odnaleziono katalogu źródłowego (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Katalog źródłowy i katalog docelowy nie mogą być identyczne"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Uruchamianie Sphinksa v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Ten projekt potrzebuje Sphinksa w wersji co najmniej %s, dlatego nie może zostać zbudowany z tą wersją."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "tworzenie katalogu wyjścia"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "podczas ustawiania rozszerzenia %s:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' podany w conf.py nie jest wywoływalny. Prosimy zmienić jego definicję tak, aby była wywoływalną funkcją. Jest to potrzebne w conf.py, aby zachowywało się jak rozszerzenie Sphinksa."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "ładowanie tłumaczeń [%s]..."
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "gotowe"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "niedostępne dla wbudowanych wiadomości"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr "ładowanie zapakowanego środowiska"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "nie powiodło się: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Nie wybrano buildera, używamy domyślnego: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "udało się"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "zakończono z problemami"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "build %s, %s ostrzeżenie."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "build %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "klasa %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "dyrektywa %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "rola %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -153,12 +158,12 @@ msgid ""
 "explicit"
 msgstr "rozszerzenie %s nie deklaruje, czy jest bezpieczne do czytania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenie o sprawdzenie i zadeklarowania tego wprost"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -166,59 +171,59 @@ msgid ""
 "explicit"
 msgstr "rozszerzenie %s nie deklaruje, czy jest bezpieczne do pisania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenia o sprawdzenie i zadeklarowanie tego wprost"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "tworzenie serii %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "nie można nadpisać słownikowego ustawienia konfiguracji %r, ignorowanie (użyj %r, by ustawić poszczególne elementy)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "niepoprawna liczba %r dla wartości konfiguracji %r, ignorowanie"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "nie można nadpisać ustawienia konfiguracji %r nie wspieranym typem, ignorowanie"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "nieznana wartość konfiguracji %r w nadpisaniu, ignorowanie"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Nie ma takiej wartości konfiguracyjnej: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Wartość konfiguracji %r już podana"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "W twoim piku konfiguracyjnym jest błąd składniowy: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Plik konfiguracyjny (albo jeden z modułów przez niego zaimportowanych) wywołał sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -226,58 +231,51 @@ msgid ""
 "%s"
 msgstr "W twoim piku konfiguracyjnym jest błąd programowalny: \n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Rozdział %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Rys. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabela %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Listing %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "Wartość konfiguracyjna `{name}` musi być jednym z {candidates}, a podany jest `{current}`."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -285,405 +283,430 @@ msgstr "Nie odnaleziono primary_domain %r, zignorowano."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Zdarzenie %r już obecne"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nieznana nazwa zdarzenia: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Ten projekt potrzebuje rozszerzenia %s co najmniej w wersji %s, dlatego nie może zostać zbudowany z załadowaną wersją (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Klasa buildera %s nie ma atrybutu \"name\""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r już istnieje (w module %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Builder o nazwie %s jest niezarejestrowany lub dostępny przez punkt wejścia"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Builder o nazwie %s jest niezarejestrowany"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "domena %s jest już zarejestrowana"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domena %s nie została jeszcze zarejestrowana"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "%r object_type jest już zarejestrowany"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "%r crossref_type jest już zarejestrowany"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r jest już zarejestrowany"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser dla %r jest już zarejestrowany"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Parser źródeł dla %s jest nie zarejestrowany"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r już zarejestrowany"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "rozszerzenie %r zostało już włączone do Sphinx'a, począwszy od wersji %s; to rozszerzenie jest zignorowane."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Pierwotny wyjątek:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Nie można zaimportować rozszerzenia %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "rozszerzenie %r nie zawiera funkcji setup(); czy to na pewno moduł rozszerzenia Sphinx?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Rozszerzenie %s używane przez ten projekt potrzebuje Sphinksa w wersji co najmniej %s; dlatego nie może zostać zbudowane z tą wersją."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "rozszerzenie %r zwróciło nie wspierany obiekt ze swojej funkcji setup(); powinno zwrócić None lub słownik metadanych"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "motyw %r nie ma ustawienia \"theme\""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "motyw %r nie ma ustawienia \"inherit\""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "nie znaleziono motywu o nazwie %r, z którego dziedziczy %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "ustawienie %s.%s nie występuje w żadnej z przeszukiwanych konfiguracji motywów"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "plik %r na ścieżce motywu nie jest poprawnym plikiem zip lub nie zawiera motywu"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme nie jest już twardą zależnością od wersji 1.4.0. Prosimy zainstalować je ręcznie. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "nie znaleziono motywu o nazwie %r (brak theme.conf?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "budowanie [mo]:"
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "pisanie wyjścia..."
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "wszystkie z %d plików po"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "wsztstkie pliki źródłowe"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "plik %r podany w wierszu poleceń nie znajduje się w katalogu źródłowym, ignoruję"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "plik %r podany w wierszu poleceń nie istnieje, ignoruję"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d plików źródłowych podano w wierszu poleceń"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "znaleziono %d"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "nic nie znaleziono"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "kopiowanie obrazków..."
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "pisanie pliku %s..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "nieznany mimetype dla %s, ignoruję"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "pisanie pliku %s..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "brak zmian w wersji %s."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Wbudowane"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Poziom modułu"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "kopiowanie plików źródłowych..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -692,160 +715,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Plik ePub znajduje się w %(outdir)s."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "nieprawidłowy css_file: %r, zignorowano"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "wczytywanie szablonów... "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "Nie znaleziono kotwicy '%s'"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "zepsuty odnośnik: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "Nie znaleziono kotwicy '%s'"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Strona HTML jest w %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Pliki Texinfo znajdują się w %(outdir)s."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "nie znaleziono wartości konfiguracyjnej \"texinfo_documents\"; żadne dokumenty nie zostaną zapisane"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "wartość konfiguracyjna \"texinfo_documents\" odwołuje się do nieznanego dokumentu %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (w "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -855,18 +882,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr "Pliki tekstowe są w %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "błąd zapisu pliku %s: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Pliki XML znajdują się w %(outdir)s."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Pliki pseudo-XML są w %(outdir)s."
@@ -881,290 +908,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Strony HTML są w %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "wartość konfiguracyjna html_use_opensearch musi być teraz ciągiem"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indeks ogólny"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "indeks"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "dalej"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "wstecz"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "kopiowanie plików do pobrania..."
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "kopiowanie plików statycznych..."
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "nie można skopiować pliku statycznego %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "nie można skopiować dodatkowego pliku %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Wystąpił błąd podczas renderowania strony %s.\nPowód: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "nieprawidłowy js_file: %r, zignorowano"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Podano nieznany math_renderer %r."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "plik favicon %r nie istnieje"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s - dokumentacja"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Pliki LaTeX znajdują się w %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "nie znaleziono wartości konfiguracyjnej \"latex_documents\"; żadne dokumenty nie zostaną zapisane"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "wartość konfiguracyjna \"latex_documents\" odwołuje się do nieznanego dokumentu %s"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Indeks"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Wydanie"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Błąd kodowania:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Błąd rekursji:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "Wystąpił wyjątek:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Raport o błędzie można zgłosić pod adresem <https://github.com/sphinx-doc/sphinx/issues>. Dzięki!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Aby uzyskać więcej informacji, odwiedź <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1183,277 +1222,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "ogólne opcje"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "zapisz wszystkie pliki (domyślnie: zapisz tylko nowe i zmienione pliki)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "zastąp ustawienie w pliku konfiguracyjnym"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "przekaż wartość do szablonów HTML"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "zwiększ szczegółowość (może być powtórzone)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "zapisz ostrzeżenia (i błędy) do podanego pliku"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "zamień ostrzeżenia na błędy"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "nie można znaleźć plików %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "Argument opcji -D musi mieć postać nazwa=wartość"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "Argument opcji -A musi mieć postać nazwa=wartość"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "warunkowe włączenie treści na podstawie wartości konfiguracyjnych"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "Wprowadź poprawną nazwę ścieżki."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Wprowadź \"y\" lub \"n\"."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Podaj rozszerzenie pliku, na przykład '.rst' lub '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Witamy w narzędziu quickstart Sphinksa %s."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "Ścieżka root dla dokumentacji"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Błąd: znaleziono istniejący conf.py na wskazanej ścieżce root."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart nie nadpisze istniejących projektów Sphinx."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Wprowadź, prosimy, nową ścieżkę root (lub tylko Enter, aby wyjść)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Rozdziel katalogi source i build (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "Prefiks nazw dla katalogów templates i static"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Nazwa projektu"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Nazwisko autora"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1462,15 +1495,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Wersja projektu"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Wydanie projektu"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1480,21 +1513,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Język projektu"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Sufiks pliku źródłowego"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1502,91 +1535,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart nie nadpisze istniejącego pliku."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Wskaż, które z następujących rozszerzeń Sphinx powinny być włączone:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Stworzyć Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Tworzenie pliku %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Plik %s już istnieje, pomijam."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Zakończono: Utworzono początkową strukturę katalogów."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1596,787 +1629,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "tryb cichy"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "Podstawowe opcje projektu"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "nazwa projektu"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "nazwiska autorów"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "wersja projektu"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "język dokumentu"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "rozszerzenie pliku źródłowego"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "nazwa głównego dokumentu"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Opcje rozszerzeń"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "włącz rozszerzenie %s"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "utwórz plik makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "nie twórz pliku makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "twórz plik wsadowy"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "nie twórz pliku wsadowego"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "Wykryto nadużycie"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Nieprawidłowy podpis: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Nie można użyć jednocześnie opcji \"%s\" i \"%s\""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Plik include %r nie znaleziony lub nie powiódł się jego odczyt"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Kodowanie %r użyte do odczytu pliku include %r wydaje się być złe, spróbuj dając opcję :encoding:"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Nie znaleziono obiektu o nazwie %r w pliku include %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Nie można użyć „lineno-match” z rozłącznym zbiorem „lines”"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Specyfikacja linii %r: nie wyciągnięto żadnych linii z pliku include %r"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor rozdziału: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor modułu: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autor kodu: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametry"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Zwraca"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Typ zwracany"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (funkcja C)"
-
-#: sphinx/domains/c.py:189
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C member)"
-msgstr "%s (pole C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (makro C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (typ C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "pole"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (zmienna C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "zmienna"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funkcja"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "pole"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "unia"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerator"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "typ"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "zmienna"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nowe w wersji %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Zmienione w wersji %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Niezalecane od wersji %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "Cytat [%s] nie ma odniesienia."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Parametry szablonu"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Wyrzuca"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klasa"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "unia"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "koncepcja"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerator"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funkcja wbudowana)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metoda)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasa)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (zmienna globalna lub stała)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atrybut)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumenty"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (moduł)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metoda"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "dane"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atrybut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "moduł"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "zduplikowana etykieta równania %s, inne wystąpienie w %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Nieprawidłowy math_eqref_format: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "słowo kluczowe"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "obiekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "wyjątek"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "instrukcja"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "funkcja wbudowana"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Zmienne"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Wyrzuca"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (w module %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (zmienna wbudowana)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (w module %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (zmienna wbudowana)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (klasa wbudowana)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasa w module %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metoda)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s metoda klasy)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s metoda statyczna)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s metoda statyczna)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s metoda klasy)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s metoda klasy)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atrybut %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Indeks modułów Pythona"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduły"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Niezalecane"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "metoda klasy"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statyczna metoda"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (niezalecane)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (dyrektywa)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rola)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "dyrektywa"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rola"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "zmienna środowiskowa; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "termin glosariusza"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "symbol gramatyki"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "etykieta odsyłacza"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "zmienna środowiskowa"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "opcja programu"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Indeks modułów"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Wyszukiwanie"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "nowa konfiguracja"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "konfiguracja zmieniona"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "rozszerzenie zmienione"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "katalog źródłowy został zmieniony"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Domena %r nie jest zarejestrowana"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "zobacz %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "zobacz także %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symbole"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2388,165 +2410,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "maksymalna głębokość submodułów wyświetlanych w spisie treści (domyślnie: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "nadpisz istniejące pliki"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "wykonaj skrypt bez tworzenia plików"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "nie twórz pliku spisu treści"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "rozszerzenie pliku (domyślnie: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s nie jest katalogiem."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "nieprawidłowe wyrażenie regularne %r w %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "nieprawidłowe wyrażenie regularne %r w coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "moduł %s nie mógł zostać zaimportowany: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "brak '+' lub '-' w opcji '%s'."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' nie jest prawidłową opcją."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' nie jest prawidłową opcją pyversion."
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2560,11 +2602,11 @@ msgstr "dyrektywa Graphviz nie może mieć jednocześnie argumentów content i f
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Nie znaleziono zewnętrznego pliku Graphviz %r lub jego odczyt się nie powiódł"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignorujemy dyrektywę „graphviz” bez treści."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2574,14 +2616,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "komenda dot %r nie może zostać uruchomiona (potrzebna do wyjścia graphviz), sprawdź ustawienia graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2591,29 +2633,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format musi mieć wartość „png” lub „svg” a ma %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[wykres: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[wykres]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2626,148 +2669,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(w %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr " (w %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[źródło]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<oryginalny wpis>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<Oryginalny wpis>> znajduje się w pliku %s, w linii %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "oryginalny wpis"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dokumentacja]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Kod modułu"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kod źródłowy modułu %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Przeglądanie: kod modułu"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Wszystkie moduły, dla których jest dostępny kod</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "błąd podczas formatowania argumentów dla %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "brakujący atrybut %s w obiekcie %s"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2775,104 +2828,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Klasy bazowe: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias klasy :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2887,107 +2993,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "domyślny sufiks dla plików (domyślnie: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Argumenty Nazwane"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Przykład"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Przykłady"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Uwagi"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Pozostałe parametry"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Uwaga"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Ostrzeżenie"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Niebezpieczeństwo"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Błąd"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Podpowiedź"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Ważne"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Informacja"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Zobacz także"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Wskazówka"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Ostrzeżenie"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "kontynuacja poprzedniej strony"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "ciąg dalszy na następnej stronie"
@@ -3004,181 +3134,181 @@ msgstr "Liczby"
 msgid "page"
 msgstr "strona"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Spis treści"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Szukaj"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Szukaj"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Pokaż źródło"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Przegląd"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Witaj! To jest"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "dokumentacja do"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "ostatnio aktualizowana"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indeksy i tablice:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Kompletny spis treści"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "wszystkie rozdziały i podrozdziały"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "przeszukaj tę dokumentację"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Globalny indeks modułów"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "szybki dostęp do wszystkich modułów"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "wszystkie funkcje, klasy, terminy"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Indeks &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Cały indeks na jednej stronie"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Strony indeksu alfabetycznie"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "może być ogromny"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Nawigacja"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Szukaj pośród %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "O tych dokumentach"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Ostatnia modyfikacja %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Utworzone przy pomocy <a href=\"http://sphinx-doc.org/\">Sphinx</a>'a %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Przeszukaj %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Poprzedni temat"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "poprzedni rozdział"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Następny temat"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "następny rozdział"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Aby umożliwić wyszukiwanie, proszę włączyć JavaScript."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "szukaj"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Wyniki wyszukiwania"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Twoje wyszukiwanie nie dało żadnych wyników. Upewnij się, że wszystkie słowa są wpisane prawidłowo i że wybrałeś dostateczną ilość kategorii."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Szybkie wyszukiwanie"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Ta strona"
 
@@ -3210,19 +3340,19 @@ msgstr "Zmiany w C API"
 msgid "Other changes"
 msgstr "Inne zmiany"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Stały odnośnik do tego nagłówka"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Stały odnośnik do tej definicji"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Ukryj wyniki wyszukiwania"
 
@@ -3234,12 +3364,12 @@ msgstr "Wyszukiwanie"
 msgid "Preparing search..."
 msgstr "Inicjalizacja wyszukiwania..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Wyszukiwanie zakończone. Liczba znalezionych stron pasujących do zapytania: %s."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", w "
 
@@ -3252,7 +3382,7 @@ msgstr "Rozwiń pasek boczny"
 msgid "Collapse sidebar"
 msgstr "Zwiń pasek boczny"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Treść"
 
@@ -3271,199 +3401,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "znaleziono więcej niż jeden cel dla cross-referencji „any” %r: może być %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "nie znaleziono celu referencji %s:%s: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "nie znaleziono celu referencji %r: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Nieznany format obrazka: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "błąd odczytu: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "błąd zapisu: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Stały odnośnik do tej tabeli"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Stały odnośnik do tego bloku kodu"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Stały odnośnik do tego obrazu"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Stały odnośnik do tego spisu treści"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Przypisy"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "%s"
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[obraz: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[obraz]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/pt/LC_MESSAGES/sphinx.po b/sphinx/locale/pt/LC_MESSAGES/sphinx.po
index e08ce7a5d9d..6c0dbf0c0a8 100644
--- a/sphinx/locale/pt/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pt/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Portuguese (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: pt\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,124 +3130,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3126,55 +3256,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3206,19 +3336,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po
index 3e9e2965f6e..28161645f78 100644
--- a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po
@@ -1,153 +1,158 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Claudio Rogerio Carvalho Filho <excriptbrasil@gmail.com>, 2016
 # FIRST AUTHOR <roger.demetrescu@gmail.com>, 2008
 # gilberto dos santos alves <gsavix@gmail.com>, 2015-2016
 # Rafael Fontenelle <rafaelff@gnome.org>, 2019
-# Rafael Fontenelle <rffontenelle@gmail.com>, 2019-2020
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Rafael Fontenelle <rffontenelle@gmail.com>, 2019-2021
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 22:13+0000\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 18:32+0000\n"
 "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>\n"
 "Language-Team: Portuguese (Brazil) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_BR/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: pt_BR\n"
 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "o diretório de configuração não contém um arquivo conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Não foi possível encontrar o diretório de origem (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr "O diretório de saída (%s) não é um diretório"
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Diretório de origem e o diretório de destino não podem ser idênticos"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Executando Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr "Por motivos de segurança, o modo paralelo está desativado no macOS e python3.8 e superior. Para mais detalhes, leia https://github.com/sphinx-doc/sphinx/issues/6803"
+msgstr "Por motivos de segurança, o modo paralelo está desabilitado no macOS e python3.8 e acima. Para mais detalhes, leia https://github.com/sphinx-doc/sphinx/issues/6803"
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser compilado com esta versão."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "criando o diretório de saída"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "enquanto definia a extensão %s:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "“setup”, conforme definido atualmente em conf.py, não é um invocável do Python. Modifique sua definição para torná-la uma função que pode ser chamada. Isso é necessário para o conf.py se comportar como uma extensão do Sphinx."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "carregando traduções [%s]… "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "feito"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "não disponível para mensagens internas"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr "carregando ambiente com pickle"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "falha: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Nenhum compilador selecionado, usando padrão: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "bem-sucedida"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "finalizada com problemas"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "compilação %s, %s aviso. (com avisos tratados como erros)."
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "compilação %s, %s avisos (com avisos tratados como erros)."
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "compilação %s, %s aviso."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "compilação %s, %s avisos."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "compilação %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "classe de nodo %r já está registrada, seus visitantes serão sobrescritos"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "diretiva %r já está registrada, ela será sobrescrita"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
-msgstr "função %r já está registrada, ela será sobrescrita"
+msgstr "papel %r já está registrado, ele será sobrescrito"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -155,12 +160,12 @@ msgid ""
 "explicit"
 msgstr "a extensão %s não declara se é segura para leitura em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "a extensão %s não é segura para leitura em paralelo"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -168,59 +173,59 @@ msgid ""
 "explicit"
 msgstr "a extensão %s não declara se é segura para escrita em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "a extensão %s não é segura para escrita em paralelo"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "fazendo serial %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "não foi possível sobrescrever a configuração do dicionário %r ignorando (use %r para definir elementos individuais)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "número inválido %r para valor de configuração %r, ignorando"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "não é possível sobrescrever a configuração %r com tipo sem suporte, ignorando"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "valor de configuração desconhecido %r na sobrescrita, ignorando"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Valor de configuração inexistente: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Valor da configuração %r já presente"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Há um erro de sintaxe em seu arquivo de configuração: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "O arquivo de configuração (ou um dos módulos que ele importa) chamou sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -228,58 +233,51 @@ msgid ""
 "%s"
 msgstr "Há um erro de programável em seu arquivo de configuração:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "O valor da configuração “source_suffix” espera uma string, lista de strings ou dicionário. Mas “%r” é fornecido."
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Seção %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabela %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Listagem %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "O valor da configuração “{name}” deve ser um entre {candidates}, mas “{current}” é fornecido."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "O valor da configuração “{name}” possui tipo “{current.__name__}”; esperava {permitted}."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "O valor da configuração “{name}” possui tipo “{current.__name__}”; o padrão é “{default.__name__}”."
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "o valor de configuração %r é definido como uma sequência com caracteres não ASCII; isso pode levar a erros Unicode. Use strings Unicode como, por exemplo, %r."
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -287,405 +285,430 @@ msgstr "primary_domain %r não encontrado, ignorado."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "Desde v2.0, o Sphinx usa “index” como master_doc por padrão. Por favor, adicione “master_doc = 'contents'” ao seu conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr "Desde v2.0, Sphinx usa \"index\" como root_doc por padrão. Adicione \"root_doc = 'contents'\" ao seu conf.py."
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Evento %r já presente"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nome de evento desconhecido: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr "O manipulador %r para evento %r levantou uma exceção"
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "A extensão %s é requerida pelas configurações needs_extensions, mas não está carregada."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Este projeto precisa da extensão %s pelo menos na versão %s e, portanto, não pode ser compilado com a versão carregada (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Nome de analisador léxico Pygments %r não é conhecido"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "Não foi possível fazer análise léxica de literal_block como “%s”. Realce de sintaxe ignorado."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr "vários arquivos encontrados para o documento \"%s\": %r\nUse %r para a construção."
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "documento não legível. Ignorado."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Classe de compilador %s possui nenhum atributo “name”"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Compilador %r já existe (no módulo %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Nome do compilador %s não registrado ou disponível através do ponto de entrada"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Nome do compilador %s não registrado"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "domínio %s já registrado"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domínio %s ainda não registrado"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "A diretiva %r já está registrada para o domínio %s"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
-msgstr "A função %r já está registrada para o domínio %s"
+msgstr "O papel %r já está registrado para o domínio %s"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "O índice %r já está registrado para o domínio %s"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "O object_type %r já está registrado"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "O crossref_type %r já está registrado"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r já está registrado"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser para %r já está registrado"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Analisador de fonte para %s não registrado"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Tradutor para %r já existe"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "kwargs para add_node() deve ser uma tupla de função (visit, depart): %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r já registrado"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "renderizador matemático %s já está registrado"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "a extensão %r já foi mesclada com Sphinx desde a versão %s; esta extensão é ignorada."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Extensão original:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Não foi possível importar a extensão %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "a extensão %r possui nenhuma função setup(); é realmente um módulo de extensão do Sphinx?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "A extensão %s usada por este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser compilada com esta versão."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "a extensão %r retornou um objeto não suportado de sua função setup(); deve retornar None ou um dicionário de metadados"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Propostas Estendidas Python; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "o tema %r não tem a configuração “theme”"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "o tema %r não tem a configuração “inherit”"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "nenhum tema chamado %r encontrado, herdado por %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "a configuração %s.%s ocorre em nenhuma das configurações de tema pesquisadas"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "sem suporte à opção de tema %r fornecida"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "o arquivo %r no caminho de tema não é um arquivo zip válido ou contém nenhum tema"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme não é mais uma dependência rígida desde a versão 1.4.0. Por favor, instale-o manualmente. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr "sphinx_rtd_theme (< 0.3.0) encontrado. Ele não estará disponível a partir do Sphinx-6.0"
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "nenhum tema chamado %r encontrado (faltando theme.conf?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "uma imagem adequada para o compilador %s não encontrada: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "uma imagem adequada para o compilador %s não encontrada: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "compilando [mo]: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "escrevendo saída… "
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "todos os %d arquivos po"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "alvos para %d arquivos po que estão especificados"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "alvos para %d arquivos po que estão desatualizados"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "todos os arquivos-fonte"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "o arquivo %r fornecido na linha de comando não está dentro do diretório fonte, ignorando"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "o arquivo %r fornecido na linha de comando não existe, ignorando"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d arquivos-fonte dados na linha de comando"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "alvos para %d arquivos fonte que estão desatualizados"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "compilando [%s]: "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "procurando por arquivos agora desatualizados… "
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "%d encontrado"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "nenhum encontrado"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr "tornando um ambiente pickle"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr "verificando consistência"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
-msgstr "nenhum algo está desatualizado."
+msgstr "nenhum alvo está desatualizado."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "atualizando ambiente: "
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s adicionado(s), %s alterado(s), %s removido(s)"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "lendo fontes… "
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "aguardando por workers…"
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "docnames para escrever: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "preparando documentos"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "entrada de tabela de conteúdos duplicada encontrada: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "copiando imagens… "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "não foi possível ler o arquivo de imagem %r: copiando-o"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "não foi possível copiar arquivo de imagem %r: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "não foi possível escrever arquivo de imagem %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr "Pillow não encontrado – copiando arquivos de imagem"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "escrevendo arquivo %s…"
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr "escrevendo o arquivo mimetype..."
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr "escrevendo o arquivo META-INF/container.xml..."
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr "escrevendo o arquivo content.opf..."
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "tipo mime desconhecido para %s, ignorando"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr "escrevendo o arquivo toc.ncx..."
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "escrevendo arquivo %s…"
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "O arquivo de visão geral está em %(outdir)s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "nenhuma alteração na versão %s."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "escrevendo arquivo de resumo…"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Internos"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Nível do Módulo"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "copiando arquivos-fonte…"
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "não foi possível ler %r para criação do changelog"
@@ -694,160 +717,164 @@ msgstr "não foi possível ler %r para criação do changelog"
 msgid "The dummy builder generates no files."
 msgstr "O compilador fictício não gera arquivos."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "O arquivo ePub está em %(outdir)s."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr "escrevendo o arquivo nav.xhtml..."
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_language” (ou “language”) não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "o valor da configuração “epub_uid” deve ser XML NAME para EPUB3"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_title” (ou “html_title”) não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_author” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_contributor” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_description” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_publisher” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_copyright” (ou “copyright”) não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_identifier” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "o valor da configuração “version” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "css_file inválido: %r, ignorado"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Os catálogos de mensagens estão em %(outdir)s."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "alvos para os %d arquivos de modelo"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "lendo modelos… "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "escrevendo catálogos de mensagens… "
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Procure por quaisquer erros na saída acima ou em %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "Âncora “%s” não encontrada"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "link quebrado: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "Âncora “%s” não encontrada"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "As páginas de manual estão em %(outdir)s."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "nenhum valor de configuração “man_pages” encontrado; nenhuma página de manual será escrita"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "escrevendo"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "o valor da configuração “man_pages” faz referência a um documento desconhecido %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "A página HTML está em %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "montando documento único"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "escrevendo arquivos adicionais"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Os arquivos Texinfo estão em %(outdir)s."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nExecute \"make\" nesse diretório para executá-los com makeinfo\n(use \"make info\" aqui para fazer isso automaticamente)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "nenhuma valor de configuração “texinfo_documents” encontrado; nenhum documento será escrito"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "o valor da configuração “texinfo_documents” faz referência a documento desconhecido %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "processando %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "resolvendo referências…"
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (em "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "copiando arquivos de suporte Texinfo"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "erro ao escrever o arquivo Makefile: %s"
@@ -857,18 +884,18 @@ msgstr "erro ao escrever o arquivo Makefile: %s"
 msgid "The text files are in %(outdir)s."
 msgstr "Os arquivos texto estão em %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "erro ao escrever o arquivo %s: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Os arquivos XML estão em %(outdir)s."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Os arquivos pseudo-XML estão em %(outdir)s."
@@ -883,290 +910,302 @@ msgstr "arquivo de informações da compilação está quebrado: %r"
 msgid "The HTML pages are in %(outdir)s."
 msgstr "As páginas HTML estão em %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Falha ao ler o arquivo de informações de compilação: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "o valor da configuração html_use_opensearch deve agora ser uma string"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Índice Geral"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "índice"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "próximo"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "anterior"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr "gerando índices"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr "escrevendo páginas adicionais"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "copiando arquivos baixáveis… "
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "não foi possível copiar o arquivo baixável %r: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "copiando arquivos estáticos… "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr "Falha ao copiar um arquivo em html_static_file: %s: %r"
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr "copiando arquivos estáticos"
+
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "não foi possível copiar o arquivo estático %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr "copiando arquivos extras"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "não foi possível copiar o arquivo extra %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Falha ao escrever o arquivo de informações de compilação: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "não foi possível carregar o índice de pesquisa, mas nem todos os documentos serão compilados: o índice ficará incompleto."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "a página %s corresponde a dois padrões em html_sidebars: %r e %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "ocorreu um erro Unicode ao renderizar a página %s. Verifique se todos os valores de configuração que contêm conteúdo não ASCII são strings Unicode."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Ocorreu um erro ao renderizar a página %s.\nMotivo: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr "despejando inventário de objetos"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr "despejando índice de pesquisa em %s"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "js_file inválido: %r, ignorado"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Muitos math_renders estão registrados, mas nenhum math_renderer está selecionado."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "math_renderer desconhecido %r é fornecido."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "a entrada de html_extra_path %r não existe"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "entrada de html_extra_path %r está posicionada dentro de outdir"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "a entrada de html_static_path %r não existe"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "entrada de html_static_path %r está posicionada dento de outdir"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "o arquivo logo %r não existe"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "o arquivo favicon %r não existe"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr "html_add_permalinks foi descontinuado desde v3.5.0. Use html_permalinks e html_permalinks_icon."
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "documentação %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Os arquivos LaTeX estão em %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nExecute \"make\" nesse diretório para executá-los com (pdf)latex\n(use \"make latexpdf\" aqui para fazer isso automaticamente)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "nenhuma valor da configuração “latex_documents” encontrado; nenhum documento será escrito"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "o valor da configuração “latex_documents” faz referência a um documento desconhecido %s"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Índice"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Release"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "nenhuma opção Babel conhecida para o idioma %r"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "copiando arquivos de suporte TeX"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "copiando arquivos de suporte TeX…"
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "copiando arquivos adicionais"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr "Chave configuração desconhecida: latex_elements[%r], ignorado."
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr "Opção de tema desconhecida: latex_theme_options[%r], ignorada."
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r não possui a configuração \"theme\""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r não possui a configuração \"%s\""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Ocorreu uma exceção enquanto compilava, iniciando depurador:"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr "Interrompido!"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "Erro de marcação reST:"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Erro de codificação:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "O rastro completo foi salvo em %s, caso você queira relatar o problema aos desenvolvedores."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Erro de recursão:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "Isso pode acontecer com arquivos-fonte muito grandes ou profundamente aninhados. Você pode aumentar cuidadosamente o limite de recursão padrão do Python de 1000 em conf.py, p.ex.:"
+msgstr "Isso pode acontecer com arquivos fonte muito grande e profundamente aninhados. Você pode aumentar com cuidado o limite padrão de recursão do Python de 1000 no conf.py com, por exemplo:"
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "Ocorreu uma exceção:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Por favor, relate isso também se houver um erro do usuário, para que uma mensagem de erro melhor possa ser fornecida na próxima vez."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Um relatório de erro pode ser preenchido no rastreador em <https://github.com/sphinx-doc/sphinx/issues>. Obrigado!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "número de tarefas deve ser um número positivo"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Para mais informações, visite <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1183,296 +1222,290 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nGera documentação a partir dos arquivos-fonte.\n\nsphinx-build gera documentação a partir dos arquivos em SOURCEDIR e a coloca\nem OUTPUTDIR. Ele procura por \"conf.py\" em SOURCEDIR para as definições de\nconfiguração. A ferramenta \"sphinx-quickstart\" pode ser usada para gerar\narquivos de modelo, incluindo \"conf.py\"\n\nO sphinx-build pode criar documentação em diferentes formatos. Um formato\né selecionado especificando o nome do compilador na linha de comandos; o\npadrão é HTML. Os compiladores também podem executar outras tarefas\nrelacionadas ao processamento da documentação.\n\nPor padrão, tudo o que está desatualizado é compilado. A saída apenas para\narquivos selecionados pode ser criada especificando nomes de arquivos\nindividuais.\n"
+msgstr "\nGera documentação de arquivos fonte.\n\nsphinx-build gera documentação a partir dos arquivos em SOURCEDIR e os coloca\nem OUTPUTDIR. Ele procura por \"conf.py\" em SOURCEDIR para a configuração\ndefinições. A ferramenta \"sphinx-quickstart\" pode ser usada para gerar\narquivos de modelo, incluindo \"conf.py\"\n\nsphinx-build pode criar documentação em diferentes formatos. Um formato é\nselecionado especificando o nome do construtor na linha de comandos; o padrão\né HTML. Os construtores também podem realizar outras tarefas relacionadas à\ndocumentação em processamento.\n\nPor padrão, tudo o que está desatualizado é construído. Saída apenas para\nselecionado os arquivos podem ser construídas especificando nomes de arquivos\nindividuais.\n"
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "caminho para os arquivos-fonte da documentação"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "caminho para o diretório de saída"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "uma lista de arquivos específicos para recompilar. Ignorado se -a for especificado"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "opções gerais"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "compilador para usar (padrão: html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "escrever todos os arquivos (padrão: escrever apenas arquivos novos e alterados)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "não usa um ambiente salvo, sempre lê todos os arquivos"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "caminho para o ambiente em cache e arquivos doctree (padrão: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "compila em paralelo com N processos onde possível (o valor especial “auto” será definido com N para número de CPUs)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "caminho no qual o arquivo de configuração (conf.py) está localizado (padrão: mesmo que SOURCEDIR)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "usa nenhum arquivo de configuração, apenas as opções -D"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "sobrescreve a configuração no arquivo de configuração"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "passa um valor para modelos em HTML"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "define tag: inclui blocos “only” com TAG"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "modo exigente, avisa sobre todas as referências em falta"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "opções de saída do console"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "aumenta o nível de detalhamento (pode ser repetido)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "nenhuma saída para stdout, apenas avisos na stderr"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "nenhuma saída, nem mesmo avisos"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "emite saída colorida (padrão: detectar automaticamente)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "não emite saída colorida (padrão: detectar automaticamente)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "escreve avisos (e erros) para o arquivo fornecido"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "transforma avisos em erros"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr "com -W, segue em frente ao receber avisos"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "mostra rastro completo em exceção"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "executa Pdb na exceção"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "não foi possível localizar os arquivos %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "não é possível combinar a opção -a e nomes de arquivos"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "não foi possível abrir o arquivo de aviso %r: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "o argumento da opção -D deve estar no formato nome=valor"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "o argumento da opção -A deve estar no formato nome=valor"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "insere docstrings automaticamente a partir de módulos"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "testa trechos de código automaticamente em blocos de doctest"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "cria link entre documentação Sphinx de diferentes projetos"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "escreve entradas “todo” que podem ser mostradas ou ocultadas na compilação"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "verifica por cobertura da documentação"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "inclui matemática, renderizada como imagens PNG ou SVG"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "inclui matemática, renderizada no navegador por MathJax"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "inclusão condicional de conteúdo com base nos valores de configuração"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "inclui links para o código-fonte dos objetos Python documentados"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "cria um arquivo .nojekyll para publicar o documento em páginas do GitHub"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "Insira um nome de caminho válido."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Insira algum texto."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Insira um entre %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Insira “y” ou “n”."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Insira um sufixo de arquivo, p.ex., “.rst” ou “.txt”."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "* Nota: caracteres não ASCII inseridos e codificação de terminal desconhecida -- presumindo UTF-8 ou Latin-1."
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Bem-vindo ao utilitário de início rápido do Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Digite valores para as seguintes configurações (basta pressionar Enter\npara aceitar um valor padrão, se houver um entre colchetes)."
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Caminho raiz selecionado: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr "Insira o caminho raiz para a documentação."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "Caminho raiz para a documentação"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Erro: um conf.py existente foi encontrado no caminho raiz selecionado."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart não vai sobrescrever projetos Sphinx existentes."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Insira um novo caminho raiz (ou pressione Enter para sair)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Você tem duas opções para definir o diretório de compilação para a saída\nSphinx. Você pode usar um diretório \"_build\" no caminho raiz ou separar\nos diretórios de \"origem\" e \"compilação\" no caminho raiz."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Separar os diretórios de origem e compilação (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "Dentro do diretório raiz, mais dois diretórios serão criados; \"_templates\"\npara modelos HTML personalizados e \"_static\" para folhas de estilo (CSS)\npersonalizadas e outros arquivos estáticos. Você pode inserir outro prefixo\n(como \".\") para substituir o sublinhado."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "Prefixo do nome para o diretório de modelos e de arquivos estáticos"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "O nome do projeto vai aparecer em vários lugares na documentação compilada."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Nome do projeto"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Nome(s) de autor(es)"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr "Sphinx tem a noção de uma \"versão\" e uma \"lançamento\" para o software.\nCada versão pode ter vários lançamentos. Por exemplo, para Python, a\nversão é algo como 2.5 ou 3.0, enquanto o lançamento é algo como 2.5.1\nou 3.0a1. Se você não precisar dessa estrutura dupla, basta definir as\nduas para o mesmo valor."
+msgstr "O Sphinx tem a noção de uma \"versão\" e um \"lançamento\" para o software.\nCada versão pode ter vários lançamentos. Por exemplo, para Python a\nversão é algo como 2.5 ou 3.0, enquanto o lançamento é algo como 2.5.1\nou 3.0a1. Se você não precisa dessa estrutura dupla, apenas defina ambos\ncom o mesmo valor."
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Versão do projeto"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Lançamento do projeto"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1482,21 +1515,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Se os documentos forem escritos em um idioma diferente do inglês, você\npode selecionar um idioma aqui pelo seu código de idioma. O Sphinx,\nentão, traduzirá o texto gerado para esse idioma.\n\nPara obter uma lista dos códigos suportados, consulte\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Idioma do projeto"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr "O sufixo do nome do arquivo para os arquivos-fonte. Geralmente ele é\n\".txt\" ou \".rst\". Somente arquivos com esse sufixo são considerados\ndocumentos."
+msgstr "O sufixo do nome de arquivo para arquivos fonte. Normalmente, isso é\n\".txt\" ou \".rst\". Apenas arquivos com este sufixo são considerados\ndocumentos."
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Sufixo de arquivos-fonte"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1504,91 +1537,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr "Um documento é especial por ser considerado o nó superior da \"árvore de\nconteúdo\", ou seja, é a raiz da estrutura hierárquica dos documentos.\nNormalmente, isso é \"index\", mas se o documento \"index\" for um modelo\npersonalizado, você também poderá configurá-lo para outro nome de arquivo."
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Nome do seu documento mestre (sem sufixo)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Erro: o arquivo mestre %s já foi encontrado no caminho raiz selecionado."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart não vai sobrescrever o arquivo existente."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Insira um novo nome de arquivo, ou renomeie o arquivo existente e pressione Enter"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Indique qual das seguintes extensões do Sphinx devem ser habilitadas:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Nota: imgmath e mathjax não podem ser habilitados ao mesmo tempo. imgmath foi desmarcado."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Um Makefile e um arquivo de comando do Windows podem ser gerados para você,\npara que você só precise executar, p.ex., \"make html\" em vez de invocar o\nsphinx-build diretamente."
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Criar um Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "Criar um arquivo de comando do Windows? (y/n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Criando o arquivo %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "O arquivo %s já existe, ignorando."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Finalizado: uma estrutura de diretório inicial foi criada."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Agora você deve preencher seu arquivo mestre %s e criar outros arquivos-fonte\nda documentação. "
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Use o Makefile para compilar os documentos, assim:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Use o comando sphinx-build para compilar os documentos, assim:\n   sphinx-build -b compilador %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "sendo “compilador” um dos compiladores com suporte, p.ex., html, latex ou linkcheck."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1598,787 +1631,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nGera os arquivos necessários para um projeto Sphinx.\n\nO sphinx-quickstart é uma ferramenta interativa que faz algumas perguntas\nsobre o seu projeto e gera um diretório de documentação completo e um\nMakefile de amostra para ser usado com o sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "modo silencioso"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr "raiz do projeto"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "Opção Estrutura"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "se especificado, separa diretórios de fonte e de compilação"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr "se especificado, cria o dir de construção sob o dir fonte"
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "substituto para ponto em _templates etc."
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "Opções básicas do projeto"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "nome do projeto"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "nomes de autores"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "versão do projeto"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "lançamento do projeto"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "idioma dos documentos"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "sufixo de arquivos-fonte"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "nome do documento mestre"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "usa epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Opções extensão"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "habilita a extensão %s"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "habilita extensões arbitrárias"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Criação de Makefile e arquivo Batch"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "cria makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "não cria makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "cria arquivo batch"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "não cria arquivo batch"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "usa modo make para Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "não usa modo make para Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "Modelo de projeto"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "diretório para arquivos de modelos"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "define uma variável modelo"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "“quiet” está especificada, mas “project” ou “author” não foi."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Erro: o caminho especificado não é um diretório, ou arquivos sphinx já existem."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart só gera em um diretório vazio. Especifique um novo caminho raiz."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Variável de modelo inválida: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "Excesso de dedent foi detectado"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr "espaços não em branco eliminados por dedent"
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Legenda inválida: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "especificação de número de linha está fora da faixa(1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Não é possível usar as opções “%s” e “%s” juntas"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Arquivo incluído %r não encontrado ou sua leitura falhou"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "A codificação %r usada para ler o arquivo incluído %r parece estar errada, tente passar uma opção :encoding:"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "O objeto chamado %r não foi encontrado no arquivo incluído %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Não é possível usar “lineo-match” com um conjunto separado de “lines”"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Especificação de linha %r: nenhuma linha obtida do arquivo incluído %r"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor da seção: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor do módulo: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autor do código: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr "A opção \":file:\" para a diretiva csv-table agora reconhece um caminho absoluto como um caminho relativo do diretório de fontes. Por favor, atualize seu documento."
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr "Declaração C duplicada, também definida em %s:%s.\nA declaração é '.. c:%s:: %s'."
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parâmetros"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Retorna"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Tipo de retorno"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (função C)"
+msgid "%s (C %s)"
+msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (membro C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (macro C)"
-
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (tipo C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "membro"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (variável C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variável"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "função"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "membro"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr "struct"
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "união"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerador"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tipo"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variável"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
-msgstr "descrição duplicada de objeto C de %s, outra instância em %s, use :noindex: para um deles"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr "parâmetro de função"
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Novo na versão %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Alterado na versão %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsoleto desde a versão %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "citação duplicada %s, outra instância em %s"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "citação [%s] não é referenciada."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "Declaração duplicada, também definida em \"%s\".\nA declaração é \"%s\"."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr "Declaração C++ duplicada, também definida em %s:%s.\nA declaração é '.. cpp:%s:: %s'."
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Parâmetros do Modelo"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Lança"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "classe"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "união"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "conceito"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr "parâmetro de modelo"
 
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerador"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "Declaração duplicada, também definida em \"%s\".\nO nome da declaração é \"%s\"."
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (função interna)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (método %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (classe)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variável global ou constante)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atributo %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumentos"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (módulo)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "método"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "dado"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atributo"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "módulo"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "descrição duplicada de %s de %s, outro %s em %s"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "rótulo duplicado da equação %s, outra instância em %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "math_eqref_format inválido: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "palavra-chave"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operador"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objeto"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "exceção"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "comando"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "função interna"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variáveis"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Levanta"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (no módulo %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (variável interna)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (no módulo %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (variável interna)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe interna)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (classe em %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (método %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (método de classe %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (método estático %s.%s)"
+msgid "%s() (%s property)"
+msgstr "%s() (propriedade %s )"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (método estático %s)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (método de classe %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (método de classe %s)"
+msgid "%s (%s property)"
+msgstr "%s (propriedade %s )"
 
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atributo %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr "%s() (propriedade %s )"
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Índice de Módulos Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "módulos"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Obsoleto"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "método de classe"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "método estático"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr "propriedade"
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "descrição duplicada de objeto de %s, outra instância em %s, use :noindex: para um deles"
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "mais de um alvo localizado para referência cruzada %r: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (obsoleto)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (diretiva)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (opção diretiva)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (papel)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "diretiva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr "opção diretiva"
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "papel"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "descrição duplicada de %s %s, outra instância em %s"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "váriavel de ambiente; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Descrição de opção %r malformada, deve se parecer com “opt”, “-opt args”, “--opt args”, “/opt args” ou “+opt args”"
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr "%s opção de linha de comando"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr "opção de linha de comando"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr "um termo de glossário deve ser precedido por uma linha vazia"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr "termos de glossário não devem ser separados por linhas vazias"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "o glossário parece estar mal formatado, confira o recuo"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "Glossário de Termos"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "termo gramatical"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "marca referencial"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "váriavel de ambiente"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "opção do programa"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "documento"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Índice do Módulo"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Página de Busca"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "rótulo duplicada %s, outra instância em %s"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "descrição duplicada de %s de %s, outra instância em %s"
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig está desabilitado. :numref: é ignorado."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "nenhum número está atribuído para %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr "Falha ao criar uma referência cruzada. Qualquer número não foi atribuído: %s"
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "o link não possui legenda: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "numfig_format inválido: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "numfig_format inválido: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr "rótulo não definido: %s"
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr "Falha ao criar uma referência cruzada. Título ou legenda não encontrado: %s"
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "nova configuração"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "configuração alterada"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "extensões alteradas"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "a versão do ambiente de compilação não é a atual"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "diretório de fontes foi alterado"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Este ambiente é incompatível com o compilador selecionado, por favor escolha outro diretório de doctree."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Falha ao procurar documentos em %s: %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "O domínio %r ainda não está registrado"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr "toctree autorreferenciada encontrada. Ignorado."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "o documento não está incluído em nenhum toctree"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "veja %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "veja também %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "tipo desconhecido de entrada de índice %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Símbolos"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "referências circulares à toctree detectadas, ignorando: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree contém referência ao documento %r que não possui título: nenhum link será gerado"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree contém referência ao documento excluído %r"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree contém referência ao documento inexistente %r"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "arquivo de imagem não legível: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "arquivo de imagem %s não legível: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr "arquivo de download não legível: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s já tem números de seção atribuídos (toctree numerada aninhada?)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr "Criaria o arquivo %s."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2390,165 +2412,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr "\nProcura recursivamente em <MODULE_PATH> módulos e pacotes Python e cria um\narquivo reST com diretivas automodule por pacote no <OUTPUT_PATH>.\n\nOs <EXCLUDE_PATTERN>s podem ser padrões de arquivo e/ou diretório que serão\nexcluídos da geração.\n\nNota: Por padrão, este script não substituirá os arquivos já criados."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr "caminho para o módulo a ser documentado"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "padrões de diretório e/ou arquivo no estilo fnmatch para excluir da geração"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr "diretório para colocar toda a saída"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "profundidade máxima de submódulos para mostrar no TOC (padrão: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "sobrescreve arquivos existentes"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "segue links simbólicos. Poderoso quando combinado com collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "escreve o script sem criar arquivos"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr "coloca a documentação para cada módulo em sua própria página"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr "inclui módulos “_private”"
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr "nome de arquivo da tabela de conteúdo (padrão: modules)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "não cria um arquivo de tabela de conteúdo"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "não cria títulos para os pacotes de módulo/pacote (p.ex., quando as docstrings já os contêm)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr "coloca documentação de módulo antes da documentação do submódulo"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interpreta caminhos de módulos de acordo com a especificação de espaços de nomes implícitos PEP-0420"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "sufixo dos arquivos (padrão: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr "gera um projeto completo com sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "acrescenta module_path a sys.path, usando quando --full é fornecido"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr "nome do projeto (padrão nome do módulo raiz)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr "autor(e)s do projeto, usado quando --full é fornecido"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr "versão do projeto, usado quando --full é fornecido"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "lançamento do projeto, usado quando --full é fornecido, padrão é --doc-version"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "opções de extensão"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s não é um diretório."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "regex inválida %r em %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Teste de cobertura nos fontes finalizada, confira os resultados em %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "regex inválida %r em coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr "api c não documentada: %s [%s] no arquivo %s"
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "o módulo %s não pôde ser importado: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr "função python não documentada: %s :: %s"
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr "classe python não documentada: %s :: %s"
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr "método python não documentado: %s :: %s :: %s"
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "faltando “+” ou “-” na opção “%s”."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "“%s” não é uma opção válida."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "“%s” não é uma opção de pyversion válida"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "Tipo de TestCode inválido"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Teste de doctests nos fontes finalizada, confira os resultados em %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "nenhum código/saída no bloco %s em %s:%s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "ignorando código de doctest inválido: %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "=================== durações de leitura mais lentas ===================="
@@ -2562,11 +2604,11 @@ msgstr "A diretiva de Graphviz não pode ter conteúdo e argumento de nome de ar
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Arquivo externo de Graphviz %r não encontrado ou sua leitura falhou"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignorando diretiva “graphviz” sem conteúdo."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2576,14 +2618,14 @@ msgid ""
 "%r"
 msgstr "DOT não produziu um arquivo de saída:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "comando de DOT %r não pode ser executado (necessário para a saída do graphviz), verifique a configuração do graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2593,30 +2635,31 @@ msgid ""
 "%r"
 msgstr "DOT encerrado com erro:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format deve ser um entre “png” e “svg”, mas é %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr "código DOT %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[gráfico: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[gráfico]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr "comando de conversão %r não pode ser executado, verifique a configuração image_converter"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
+msgstr "comando de conversão %r não pode ser executado, verifique a configuração image_converter: %s"
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
 #, python-format
@@ -2628,148 +2671,158 @@ msgid ""
 "%r"
 msgstr "convert encerrado com erro:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "comando de conversão %r não pode ser executado, verifique a configuração image_converter"
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "o comando LaTeX %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_latex"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "o comando %s %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_%s"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr "exibe latex %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "latex em linha %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
-msgstr "Permalink para essa equação"
+msgstr "Link permanente para essa equação"
 
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "o inventário intersphinx foi movido: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "carregando inventário intersphinx de %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 "encontrados alguns problemas com alguns dos inventários, mas eles tem alternativas em funcionamento:"
 
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "falha ao alcançar todos os inventários com os seguintes problemas:"
 
-#: sphinx/ext/intersphinx.py:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(em %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(em %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "identificador intersphinx %r não é uma string. Ignorado"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr "Falha ao ler intersphinx_mapping[%s], ignorado: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[código fonte]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Por fazer"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Entrada de “TODO” encontrada: %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(A <<original entry>> está localizada na %s, linha %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "entrada original"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr "realçando código de módulo… "
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[documentos]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Código do módulo"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Código fonte para %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Visão geral: código do módulo"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Todos os módulos onde este código está disponível</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr "valor inválido para a opção member-order: %s"
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "assinatura inválida para auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "erro ao formatar argumentos para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "faltando atributo %s no objeto %s"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autodoc: falhou em determinar %r a ser documentado, a seguinte exceção foi levantada:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2777,104 +2830,157 @@ msgid ""
 "explicit module name)"
 msgstr "não sei qual módulo importar para documentação automática %r (tente colocar uma diretiva “module” ou “currentmodule” no documento ou forneça um nome explícito para o módulo)"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr "erro ao formatar assinatura para %s: %s"
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "“::” no nome de automodule não faz sentido"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "argumentos de assinatura ou anotação de retorno fornecidos para automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ deve ser uma lista de strings, não %r (no módulo %s) -- ignorando __all__"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr "faltando atributo mencionado em :members: ou __all__: módulo %s, atributo %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr "faltando atributo mencionado na opção :members: : módulo %s, atributo %s"
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr "Falha ao obter uma assinatura de função para %s: %s"
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr "Falha ao obter uma assinatura de construtor para %s: %s"
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Base: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr "apelido de %s"
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr "apelido de TypeVar(%s)"
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr "Falha ao obter uma assinatura de método para %s: %s"
+
+#: sphinx/ext/autodoc/__init__.py:2247
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "apelido de :class:`%s`"
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr "__slots__ inválido encontrado em %s. Ignorado."
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr "autodoc_member_order agora aceita \"alphabetical\" em vez de \"alphabetic\". Por favor, atualize sua configuração."
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr "Falha ao analisar um valor de argumento padrão para %r: %s"
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr "Falha ao atualizar a assinatura para %r: parâmetro não encontrado: %s"
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "Falha ao analisar type_comment para %r: %s"
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "referências de autosummmary excluíram o documento %r. Ignorado."
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary: arquivo stub não encontrado %r. Verifique sua configuração autosummary_generate."
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr "Um autosummary com legenda requer a opção :toctree:. Ignorado."
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "falha ao importar %s"
+msgid "autosummary: failed to import %s"
+msgstr "autosummary: falha ao importar %s"
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr "falha ao analisar o nome %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "falha ao importar o objecto %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: arquivo não encontrado: %s"
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary gera arquivos .rst internamente. Mas seu source_suffix não contém .rst. Ignorado."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autosummary: falhou em determinar %r a ser documentado, a seguinte exceção foi levantada:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr "[autosummary] gerando autosummary para: %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[autosummary] escrevendo em %s"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr "[autosummary] falha ao importar %r: %s"
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2889,107 +2995,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nGera ReStructuredText usando diretivas de resumo automático.\n\nsphinx-autogen é um frontend para sphinx.ext.autosummary.generate.\nEle gera os arquivos reStructuredText a partir de diretivas autosummary\ncontidas nos arquivos de entrada fornecidos.\n\nO formato da diretiva autosummary está documentado no módulo Python\n``sphinx.ext.autosummary`` e pode ser lido usando:\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "arquivos-fonte para gerar arquivos rST"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "diretório para colocar toda a saída"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "sufixo padrão para arquivos (padrão: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "diretório de modelos personalizado (padrão: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "documenta membros importados (padrão: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Argumentos de Palavras-chave"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Exemplo"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Exemplos"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Notas"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Outros Parâmetros"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr "Recebe"
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "Referências"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "Avisos"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr "Yields"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr "valor inválido definido (faltando chave de fechamento): %s"
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr "valor inválido definido (faltando chave de abertura): %s"
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr "string literal malformada (faltando aspas de fechamento): %s"
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr "string literal malformada (faltando aspas de abertura): %s"
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Atenção"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Cuidado"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Perigo"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Erro"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Dica"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Importante"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Ver também"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Dica"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Aviso"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "continuação da página anterior"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "continua na próxima página"
@@ -3006,181 +3136,181 @@ msgstr "Números"
 msgid "page"
 msgstr "página"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Tabela de Conteúdo"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Buscar"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Ir"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Exibir Fonte"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Visão geral"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Bem Vindo! É isso aí."
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "documentação para"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "última atualização"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Índices e Tabelas:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Tabela Completa dos Conteúdos"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "Listar todas seções e subseções"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "Buscar nessa documentação"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Índice Global de Módulos"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "acesso rápido para todos os módulos"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "todas funções, classes, termos"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Índice &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Índice completo em página única"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Páginas de índice por letra"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "pode ser enorme"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navegação"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Pesquisar dentro de %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Sobre esses documentos"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Última atualização em %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Criado usando <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr "Criada usando <a href=\"https://www.sphinx-doc.org/pt_BR/master\">Sphinx</a> %(sphinx_version)s."
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Buscar em %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Tópico anterior"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "capítulo anterior"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Próximo tópico"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "próximo capítulo"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Por favor, ativar JavaScript para habilitar a\nfuncionalidade de busca."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr "Pesquisando por várias palavras só mostra correspondências\nque contêm todas as palavras."
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "buscar"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Resultados da Busca"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Sua busca não encontrou nenhum documento. Por favor, confirme se todas as palavras estão grafadas corretamente e se você selecionou categorias suficientes."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Busca rápida"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Essa Página"
 
@@ -3212,19 +3342,19 @@ msgstr "Alterações na API C"
 msgid "Other changes"
 msgstr "Outras alterações"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Link permanente para este título"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Link permanente para esta definição"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Esconder Resultados da Busca"
 
@@ -3236,12 +3366,12 @@ msgstr "Buscando"
 msgid "Preparing search..."
 msgstr "Preparando a busca..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Busca concluída. %s página(s) que atendem a consulta."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", em "
 
@@ -3254,7 +3384,7 @@ msgstr "Expandir painel lateral"
 msgid "Collapse sidebar"
 msgstr "Recolher painel lateral"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Conteúdos"
 
@@ -3273,199 +3403,207 @@ msgstr "Nota de rodapé [%s] não é referenciada."
 msgid "Footnote [#] is not referenced."
 msgstr "Nota de rodapé [#] não é referenciada."
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referências de nota de rodapé inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "referências inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referências de citação inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referências de termo inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr "Não foi possível determinar o texto reserva para a referência cruzada. Pode ser um bug."
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "mais de um alvo localizado para “any” referência cruzada %r: poderia ser %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s alvo de referência não encontrado: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr "%s:alvo de referência %s não encontrado: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "%r alvo de referência não encontrado: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr "alvo de referência %r não encontrado: %s"
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "Não foi possível obter imagem remota: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr "Não foi possível obter imagem remota: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Formato de imagem desconhecido: %s…"
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "caracteres de origem não codificáveis, substituindo por “?”: %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr "ignorado"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr "falhou"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr "diretiva ou nome de papel desconhecida(o): %s:%s"
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "erro de leitura: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "erro de escrita: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Formato de data inválido. Envolva a string com aspas simples se desejar emiti-la diretamente: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree contém referência ao arquivo inexistente %r"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "exceção ao avaliar apenas a expressão da diretiva: %s"
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr "O suporte para a avaliação de sintaxe do Python 2 foi descontinuado e será removido no Sphinx 4.0. Converta %s para sintaxe do Python 3."
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
-msgstr "função padrão %s não encontrada"
+msgstr "papel padrão %s não encontrado"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format não está definido para %s"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Quaisquer IDs não atribuídos ao nó %s"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr "Link permanente para este termo"
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Link Permanente para essa tabela"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Link Permanente para esse código"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Link Permanente para essa imagem"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Link permanente para esse \"toctree\""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "Não foi possível obter o tamanho da imagem. A opção :scale: foi ignorada."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "toplevel_sectioning %r desconhecido para a classe %r"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: grande demais, ignorado."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr "título do documento não é um nó único em Text"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "nó de título encontrado não na section, topic, table, admonition ou sidebar"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Notas de rodapé"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "tabularcolumns e opção :widths: foram fornecidas. :widths: foi ignorada."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "a unidade de dimensão %s é inválida. Ignorada."
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "tipo desconhecido de entrada de índice %s encontrado"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[imagem: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[imagem]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "legenda não dentro de uma imagem."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "tipo de nó não implementado: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr "tipo de nó desconhecido: %r"
diff --git a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po
index 6c78b0813fd..07f743d09ec 100644
--- a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po
@@ -1,149 +1,154 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Pedro Algarvio <pedro@algarvio.me>, 2013
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Portuguese (Portugal) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_PT/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: pt_PT\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -151,12 +156,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -164,59 +169,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,58 +229,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -283,405 +281,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Internos"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Módulos"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -690,160 +713,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (em "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -853,18 +880,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -879,290 +906,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Índice Geral"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "índice"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "próximo"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "anterior"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "Documentação %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Índice"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Versão"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1181,277 +1220,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1460,15 +1493,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1478,21 +1511,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1500,91 +1533,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1594,787 +1627,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor da secção: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor do módulo: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autor do código: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parâmetros"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Retorno"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Tipo de retorno"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (função C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (membro C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (macro C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (tipo C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "membro"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (variável C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variável"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "função"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "membro"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tipo"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variável"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Novo na versão %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Alterado na versão %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsoleto desde a versão %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Gera"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "classe"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (função interna)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (método %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (classe)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variável global ou constante)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atributo %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Parâmetros"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (módulo)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "método"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "dados"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atributo"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "módulo"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "palavra-chave"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operador"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objecto"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "excepção"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "comando"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "função interna"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variáveis"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Levanta"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (no módulo %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (variável interna)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (no módulo %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (variável interna)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe interna)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (classe em %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (método %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (método de classe %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (método estático %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (método estático %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (método de classe %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (método de classe %s)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atributo %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Índice de Módulos do Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "módulos"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Obsoleto"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "método de classe"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "método estático"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (obsoleto)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directiva)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (papel)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "directiva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "papel"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "variável de ambiente; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "Termo de glossário"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "token de gramática"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "rótulo de referência"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "variável de ambiente"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "opção de programa"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Índice de Módulos"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Página de Pesquisa"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "ver %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "ver também %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Símbolos"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2386,165 +2408,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2558,11 +2600,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2572,14 +2614,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2589,29 +2631,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[gráfico: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[gráfico]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2624,148 +2667,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(em %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[código fonte]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Por fazer"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "entrada original"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[documentos]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Código do módulo"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Código fonte de %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Visão geral: código do módulo"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Todos os módulos onde este código está disponível</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2773,104 +2826,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "pseudónimo de :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2885,107 +2991,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Atenção"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Cuidado"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Perigo"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Erro"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Dica"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Importante"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Veja também"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Dica"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Aviso"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "continuação da página anterior"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3002,181 +3132,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Pesquisar"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Ir"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Exibir Fonte"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Visão geral"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Bem Vindo(a)! Esta é"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "a documentação de"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "última actualização"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Índices e tabelas:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Tabela de Conteúdos Completa"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "Listar todas as secções e subsecções"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "Pesquisar esta documentação"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Índice Global de Módulos"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "acesso rápido a todos os módulos"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "todas as funções, classes, termos"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Índice &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Índice completo numa página"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Paginas de índice por letra"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "pode ser enorme"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navegação"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Pesquisar dentro de %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Sobre estes documentos"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Última actualização em %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Criado utilizando <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Pesquisar %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Tópico anterior"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "capítulo anterior"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Próximo tópico"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "próximo capítulo"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Por favor ligue o JavaScript para habilitar a\nfuncionalidade de pesquisa."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "pesquisar"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Resultados da Pesquisa"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "A sua pesquisa não encontrou nenhum documento. Por favor, confirme que todas as palavras estão escritas corretamente e que selecionou categorias suficientes."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Pesquisa rápida"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Esta Página"
 
@@ -3208,19 +3338,19 @@ msgstr "Alterações na API C"
 msgid "Other changes"
 msgstr "Outras alterações"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Link permanente para este título"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Link permanente para esta definição"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Esconder Resultados da Pesquisa"
 
@@ -3232,12 +3362,12 @@ msgstr "A Pesquisar"
 msgid "Preparing search..."
 msgstr "A preparar a pesquisa..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Pesquisa concluída, foram encontrada(s) %s página(s) que combinam com a consulta feita."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", em"
 
@@ -3250,7 +3380,7 @@ msgstr "Expandir painel lateral"
 msgid "Collapse sidebar"
 msgstr "Recolher painel lateral"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Conteúdo"
 
@@ -3269,199 +3399,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Notas de rodapé"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[imagem: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[imagem]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/ro/LC_MESSAGES/sphinx.po b/sphinx/locale/ro/LC_MESSAGES/sphinx.po
index 721f8dcd250..9f75b026939 100644
--- a/sphinx/locale/ro/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ro/LC_MESSAGES/sphinx.po
@@ -1,149 +1,154 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Razvan Stefanescu <razvan.stefanescu@gmail.com>, 2015-2017
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Romanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ro/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: ro\n"
 "Plural-Forms: nplurals=3; plural=(n==1?0:(((n%100>19)||((n%100==0)&&(n!=0)))?2:1));\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Proiectul necesită minim Sphinx v%s și de aceea nu poate fi construit cu această versiune."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "eșuat: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "a reușit"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "a fost finalizat cu probleme"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -151,12 +156,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -164,59 +169,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,58 +229,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabelul %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Cod %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -283,405 +281,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Propuneri de Îmbunătățire Python; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Integrate"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Nivelul modul"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -690,160 +713,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(în"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -853,18 +880,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -879,290 +906,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Index General"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "următor"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "precedent"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s documentație"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Versiune"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1181,277 +1220,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1460,15 +1493,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1478,21 +1511,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1500,91 +1533,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1594,787 +1627,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autorul secțiunii:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autorul modulului:"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autorul codului:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametrii"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Întoarce"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Tipul întors"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (funcție C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (membru C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (macro C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (tip C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "membru"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (variabilă C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variabilă"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funcție"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "membru"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enumerator"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerator"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "tip"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variabilă"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nou în versiunea %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Schimbat în versiunea %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Învechit începând cu versiunea %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Generează"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "clasă"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enumerator"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerator"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funcție integrată)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metoda %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (clasă)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variabilă globală sau constantă)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumente"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metodă"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "cuvânt cheie"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "obiect"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "excepție"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "declarație"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "funcție integrată"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variabile"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Generează"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (în modulul %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (variabilă integrată)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (în modulul %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (variabilă integrată)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (clasă integrată)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (clasa în %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (metoda %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (metoda clasei %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (metoda statică %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (metoda statică %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (metoda clasei %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (metoda clasei %s)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atributul %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Indexul de Module Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "module"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Învechit"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "metoda clasei"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "metodă statică"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr "(învechit)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directivă)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "directivă"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rol"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "variabilă de mediu; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "termen de glosar"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "element de gramatică"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "etichetă de referință"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "variabilă de mediu"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "opțiune a programului"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Index al modulelor"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Pagină de Căutare"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "vezi %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "vezi și %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simboluri"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2386,165 +2408,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2558,11 +2600,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2572,14 +2614,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2589,29 +2631,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[grafic: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[grafic]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2624,148 +2667,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(în %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[sursă]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "De făcut"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "înregistrarea inițială"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[documentație]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Codul modulului"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Codul sursă pentru %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Prezentare generală: codul modulului"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Toate modulele pentru care este disponibil codul sursă</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2773,104 +2826,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias pentru :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2885,107 +2991,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Atenție"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Avertisment"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Pericol"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Eroare"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Sugestie"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Important"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Notă"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Vezi și"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Sfat"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Atenționare"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "continuare din pagina precedentă"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3002,181 +3132,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Căutare"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Caută"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Vezi Sursa"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Prezentare generală"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Bine ai venit! Acesta este"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "documentația pentru"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "ultima actualizare"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indici și tabele:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Cuprinsul Complet"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "lista tuturor secțiunilor si a subsecțiunilor"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "caută în această documentație"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Index Module Globale"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "acces rapid la toate modulele"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "toate funcțiile, clasele, termenii"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Index &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Index complet"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indexează paginile dupa literă"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "poate fi extrem de mare"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigare"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Caută în %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Despre aceste documente"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Drepturi de autor"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Ultima actualizare la %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Generat cu <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Caută %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Subiectul precedent"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "capitolul precedent"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Subiectul următor"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "capitolul următor"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Activează JavaScript pentru a permite\nfuncția de căutare."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "căutare"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Rezultatele Căutării"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Căutarea nu a identificat nici un document. Te rog să te asiguri că toate cuvintele sunt scrise corect și că ai selectat suficiente categorii."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Căutare rapidă"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Această Pagină"
 
@@ -3208,19 +3338,19 @@ msgstr "Schimbări în API C"
 msgid "Other changes"
 msgstr "Alte schimbări"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Link permanent la acest titlu"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Link permanent la această definiție"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Ascunde Rezultatele Căutării"
 
@@ -3232,12 +3362,12 @@ msgstr "Căutare"
 msgid "Preparing search..."
 msgstr "Se pregătește căutarea..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Căutare finalizată, au fost găsite %s pagini care au corespuns căutării."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", în"
 
@@ -3250,7 +3380,7 @@ msgstr "Expandare bară laterală"
 msgid "Collapse sidebar"
 msgstr "Ascundere bară laterală"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Cuprins"
 
@@ -3269,199 +3399,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Link permanent la acest tabel"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Link permanent la acest cod"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Link permanent la această imagine"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Link permanent la acest cuprins"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Note de subsol"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[figura: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[figură]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/ru/LC_MESSAGES/sphinx.po b/sphinx/locale/ru/LC_MESSAGES/sphinx.po
index d8572db5fbd..e3abf36e175 100644
--- a/sphinx/locale/ru/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ru/LC_MESSAGES/sphinx.po
@@ -1,7 +1,7 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Alex Salikov <Salikvo57@gmail.com>, 2019
 # Dmitry Shachnev <mitya57@gmail.com>, 2013
@@ -13,141 +13,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Russian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ru/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: ru\n"
 "Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n%100>=11 && n%100<=14)? 2 : 3);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "в конфигурационной папке нет файла conf.py file (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Проект требует версию Sphinx не ниже v%s и не может быть построен текущей версией."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "готово"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "ошибка: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Сборщик не указан, по умолчанию используется html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "успешно"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "с ошибками"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "сборка завершена %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -155,12 +160,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -168,59 +173,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Отсутствует ключ конфигурации %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Ключ конфигурации %r уже существует"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Файл конфигурации (или один из импортированных модулей) вызвал sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -228,58 +233,51 @@ msgid ""
 "%s"
 msgstr "В вашем файле конфигурации программная ошибка:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Раздел %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Рис. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Таблица %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Список %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -287,405 +285,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Событие %r уже существует"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Неизвестное событие: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Отсутствует аттрибут \"name\" у класса сборщика %s."
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Сборщик %r уже существует (в модуле %s)."
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Сборщик %s не зарегистрирован явно или через ресурсы пакетов."
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Сборщик %s не зарегистрирован."
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Изначальное исключение:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Не могу загрузить модуль расширения %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "расширение %r не определяет функцию setup(); это действительно модуль расширения Sphinx?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Предложения об улучшениях Python; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "Не получается считать файл изображение %r: скопируйте его"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "Не получается скопировать файл изображения %r: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "Не получается записать файл изображения %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "записывается %s файл..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "записывается %s файл..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Встроенные функции"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Модуль"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -694,160 +717,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (в "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -857,18 +884,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -883,290 +910,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Алфавитный указатель"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "указатель"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "вперёд"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "назад"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "документация %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Алфавитный указатель"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Выпуск"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1185,277 +1224,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "Не получается найти файлы %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "Невозможно совмещать ключ -a и названия файлов"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "Не получается открыть файл с предупреждениями %r:%s "
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1464,15 +1497,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Версия проекта"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Релиз проекта"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1482,21 +1515,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Язык проекта"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1504,91 +1537,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Создание файла %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Файл %s уже существует, пропускаем."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1598,787 +1631,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "имя проекта"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "имена авторов"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "версия проекта"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "релиз проекта"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "язык проекта"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "использовать epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Некорректная подпись: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Автор раздела: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Автор модуля: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Автор кода:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Автор: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Параметры"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Результат"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Тип результата"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (функция C)"
-
-#: sphinx/domains/c.py:189
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C member)"
-msgstr "%s (поле C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (макроподстановка C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (тип C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "поле"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (переменная C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "переменная"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "функция"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "поле"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "макрос"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "перечисляемый тип"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "перечислитель"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "тип"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "переменная"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Добавлено в версии %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Изменено в версии %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Не рекомендуется, начиная с версии %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Параметры шаблона"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Бросает исключение"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "класс"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "концепт"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "перечисляемый тип"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "перечислитель"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (встроенная функция)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (метод %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (класс)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (глобальная переменная или константа)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (атрибут %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Аргументы"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (модуль)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "метод"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "данные"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "атрибут"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "модуль"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "повторяющаяся метка уравнения %s, также используется в %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "ключевое слово"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "оператор"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "объект"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "исключение"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "команда"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "базовая функция"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Переменные"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Исключение"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (в модуле %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (встроенная переменная)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (в модуле %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (встроенная переменная)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (встроенный класс)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (класс в %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (метод %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (метод класса %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (статический метод %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (статический метод %s)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (метод класса %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (метод класса %s)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (атрибут %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Содержание модулей Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "модули"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Не рекомендуется"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "метод класса"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "статический метод"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr "(использование не рекомендуется)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (директива)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (роль)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "директива"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "роль"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "переменная окружения; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "элемент словаря"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "токен грамматики"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "текст ссылки"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "переменная окружения"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "опция программы"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "документ"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Состав модуля"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Поиск"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "новая конфигурация"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "конфигурация изменена"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "см. %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "также см. %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Символы"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2390,165 +2412,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2562,11 +2604,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2576,14 +2618,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2593,29 +2635,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[иллюстрация: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[иллюстрация]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2628,148 +2671,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(в %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[исходный код]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "План"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<исходная запись>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<Исходная запись>> находится в %s, строка %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "исходный элемент"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[документация]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Код модуля"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Исходный код %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Обзор: исходный код модуля"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Все модули, в которых есть код</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2777,104 +2830,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "   Базовые классы: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "псевдоним класса :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2889,107 +2995,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Именованные аргументы"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Пример"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Примеры"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Заметки"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Другие параметры"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "Предупрждения"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Внимание"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Осторожно"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Опасно"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Ошибка"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Подсказка"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Важно"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Примечание"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "См.также"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Совет"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Предупреждение"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "продолжение с предыдущей страницы"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3006,181 +3136,181 @@ msgstr "Числа"
 msgid "page"
 msgstr "страница"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Оглавление"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Поиск"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Искать"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Исходный текст"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Обзор"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Добро пожаловать! Это"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "документация"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "последнее изменение"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Таблицы и указатели:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Полное оглавление"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "список всех разделов и подразделов"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "поиск в документации"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Алфавитный указатель модулей"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "сводный список всех модулей"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "все функции, классы, переменные и константы"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Алфавитный указатель &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Полный алфавитный указатель на одной странице"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Указатели по буквам алфавита"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "может быть очень большим"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Навигация"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Поиск в документе «%(docstitle)s»"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Об этих документах"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Авторские права"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Обновлено: %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Создано с помощью <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Поиск в документе «%(docstitle)s»"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Предыдущий раздел"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "предыдущая глава"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Следующий раздел"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "следующая глава"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Для работы поиска включите JavaScript в браузере."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "искать"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Результаты поиска"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "По вашему поиску не найдено ни одного документа. Проверьте, что все слова написаны без ошибок, и что вы выбрали достаточно категорий."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Быстрый поиск"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Эта страница"
 
@@ -3212,19 +3342,19 @@ msgstr "Изменения в API C"
 msgid "Other changes"
 msgstr "Другие изменения"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Ссылка на этот заголовок"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Ссылка на это определение"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Снять выделение"
 
@@ -3236,12 +3366,12 @@ msgstr "Идёт поиск"
 msgid "Preparing search..."
 msgstr "Подготовка поиска…"
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Поиск завершён, найдено %s страниц, удовлетворяющих запросу."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", в"
 
@@ -3254,7 +3384,7 @@ msgstr "Развернуть боковую панель"
 msgid "Collapse sidebar"
 msgstr "Свернуть боковую панель"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Содержание"
 
@@ -3273,199 +3403,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Постоянная ссылка на таблицу"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Постоянная ссылка на код"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Постоянная ссылка на рисунок"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Постоянная ссылка на оглавление"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Сноски"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[рисунок: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[рисунок]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/si/LC_MESSAGES/sphinx.po b/sphinx/locale/si/LC_MESSAGES/sphinx.po
index d03be451e25..564ff2945cb 100644
--- a/sphinx/locale/si/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/si/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # callkalpa <callkalpa@gmail.com>, 2013
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Sinhala (http://www.transifex.com/sphinx-doc/sphinx-1/language/si/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: si\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "ඊළඟ"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "පෙර"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s ලේඛණය"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "නිකුත් කිරීම"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "කේත ලේඛක:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "ලේඛක:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "පරාමිතීන්"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr ""
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr ""
-
-#: sphinx/domains/c.py:191
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C macro)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr ""
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "සාමාජික"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr ""
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "විචල්‍යය"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "ක්‍රියාව"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "සාමාජික"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "මැක්‍රෝ"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "වර්ගය"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "විචල්‍යය"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "%s වෙළුමේ අලුත්"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "%s වෙළුමේ වෙනස් කල"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr ""
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "දත්ත"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "වස්තුව"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "විචල්‍ය"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "සෙවුම් පිටුව"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "%s බලන්න"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "%s ද බලන්න"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "සංකේත"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graph: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graph]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(%s හි%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[source]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "කිරීමට තිබෙන"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "දෝෂය"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "හැඟවීම"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "සටහන"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "මෙයද බලන්න"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "අනතුරු ඇඟවීම"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,124 +3131,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "සොයන්න"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "යන්න"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "මූලය පෙන්වන්න"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "අවසන්වරට යාවත්කාල කල"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "සම්පූර්ණ පටුන"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "විශාල විය හැක"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "ගමන් කිරීම"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "මෙම ලේඛණ ගැන"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3127,55 +3257,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr "%(docstitle)s සොයන්න"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "පෙර මාතෘකාව"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "පෙර පරිච්ඡේදය"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "ඊළඟ මාතෘකාව"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "ඊළඟ පරිච්ඡේදය"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "සොයන්න"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "සෙවුම් ප්‍රතිඵල"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "ඉක්මන් සෙවුම"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "මෙම පිටුව"
 
@@ -3207,19 +3337,19 @@ msgstr "C API වෙනස්කම්"
 msgid "Other changes"
 msgstr "වෙනත් වෙනස්කම්"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3231,12 +3361,12 @@ msgstr "සොයමින්..."
 msgid "Preparing search..."
 msgstr "සෙවුම සූදානම් කරමින්...."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "අන්තර්ගතය"
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[image: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[image]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/sk/LC_MESSAGES/sphinx.po b/sphinx/locale/sk/LC_MESSAGES/sphinx.po
index 07d654695f7..f4ac0b80e19 100644
--- a/sphinx/locale/sk/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sk/LC_MESSAGES/sphinx.po
@@ -1,150 +1,155 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2008
-# Slavko <linux@slavino.sk>, 2013-2019
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Slavko <linux@slavino.sk>, 2013-2019,2021
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-16 16:36+0000\n"
+"Last-Translator: Slavko <linux@slavino.sk>\n"
 "Language-Team: Slovak (http://www.transifex.com/sphinx-doc/sphinx-1/language/sk/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: sk\n"
 "Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n == 1 ? 0 : n % 1 == 0 && n >= 2 && n <= 4 ? 1 : n % 1 != 0 ? 2: 3);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "konfiguračný priečinok neobsahuje súbor conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Nemožno nájsť zdrojový priečinok (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr "Výstupný adresár (%s) nie je adresár"
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Zdrojový a cieľový priečinok nemôžu byť rovnaké"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Spúšťanie Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr ""
+msgstr "Z bezpečnostných dôvodov je paralelný režim na macOS s Python3.8 a novším vypnutý. ďalšie podrobnosti nájdete v https://github.com/sphinx-doc/sphinx/issues/6803"
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Tento projekt vyžaduje aspoň Sphinx v%s a preto s touto verziou nemôže byť zostavený."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "vytváranie výstupnej zložky"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "pri nastavovaní rozšírenia %s:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' definovaný v conf.py nie je funkciou. Prosím, upravte jeho definíciu tak, aby to bola funkcia. Je to potrebné, aby sa conf.py mohol správať ako rozšírenie Sphinx."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "načítanie prekladov [%s]…"
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "hotovo"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "nedostupné pre zabudované správy"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr "načítanie uloženého prostredia "
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "zlyhalo: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Nebol zvolený builder, bude použitý predvolený: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "úspešné"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "dokončené sproblémami"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
-msgstr ""
+msgstr "zostavenie %s, %s upozornenia/a (upozornenia považované za chyby)."
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
-msgstr ""
+msgstr "zostavenie %s, %s upozornenia/a (upozornenia považované za chyby)."
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "zostavenie %s, %s upozornenie."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
-msgstr ""
+msgstr "zostavenie %s, %s upozornenie/a."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "zostavenie %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "trieda uzla %r už je registrovaná, jej metódy (visitors) budú prepísané"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "direktíva %r už je registrovaná, bude prepísaná"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "rola %r už je registrovaná, bude prepísaná"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -152,12 +157,12 @@ msgid ""
 "explicit"
 msgstr "rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladá sa, že nie - prosím, požiadajte autora aby to skontroloval a explicitne to nastavil"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
-msgstr ""
+msgstr "rozšírenie %s nie je bezpečné pre paralelné zostavenie"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -165,59 +170,59 @@ msgid ""
 "explicit"
 msgstr "rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladáme, že nie je – prosím, požiadajte autora aby to skontroloval a explicitne to nastavil"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
-msgstr ""
+msgstr "rozšírenie %s nie je bezpečné pre paralelné zostavenie"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "sériové spracovanie %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "nemožno prepísať slovník nastavenia %r, ignorované (použite %r na nastavenie jednotlivých prvkov)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "neplatný počet %r pre konfiguračnú hodnotu %r, ignorované"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "nemožno prepísať konfiguračné nastavenie %r s nepodporovaným typom, ignorované"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "neznáma konfiguračná hodnota %r v prepísaní, ignorované"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Neznáma konfiguračná hodnota: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Konfiguračná hodnota %r už existuje"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Vo svojom konfiguračnom súbore máte chybu: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Konfiguračný súbor (alebo jeden z modulov, ktoré importuje) volal sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -225,57 +230,50 @@ msgid ""
 "%s"
 msgstr "V konfiguračnom súbore je programová chyba:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "Konfiguračná hodnota „source_suffix” očakáva reťazec, zoznam reťazcov alebo slovník, ale zadali ste „%r”."
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Sekcia %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Obr. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabuľka %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Výpis %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
-msgstr ""
+msgstr "Konfiguračná hodnota `{name}` má byť jedno z {candidates}, ale je zadané `{current}`."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
-msgstr ""
+msgstr "Konfiguračná hodnota `{name}' má typ `{current.__name__}'; očakávané {permitted}."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
-msgstr ""
-
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
+msgstr "Konfiguračná hodnota `{name}' má typ `{current.__name__}', predvolene `{default.__name__}'."
 
 #: sphinx/config.py:461
 #, python-format
@@ -284,567 +282,596 @@ msgstr "primary_domain %r nenájdená, ignorované."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "Od v2.0 Sphinx predvolene používa „index” ako master_doc. Prosím, pridajte „master_doc = 'contents'” do svojho conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr "Od v2.0 Sphinx predvolene používa „index” ako root_doc. Prosím, pridajte „root_doc = 'contents'” do svojho conf.py."
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Udalosť %r už existuje"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Neznáme meno udalosti %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr "Obsluha %r udalosti %r vyvolala výnimku"
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
-msgstr ""
+msgstr "Rozšírenie %s je vyžadované nastavením needs_extensions, ale nie je načítané."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Tento projekt vyžaduje rozšírenie %s s verziou minimálne %s, a teda ho nemožno zostaviť s načítanou verziou (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
-msgstr ""
+msgstr "Neznáme meno lexera Pygments %r"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
-msgstr ""
+msgstr "Nemožno spracovať literal_block ako \"%s\". Zvýraznenie syntaxe preskočené."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr "nájdených viacero súborov pre dokument \"%s\": %r\nNa zostavenie použite %r."
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
-msgstr ""
+msgstr "dokument nie je čitateľný. Ignorované."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Trieda builder %s nemá atribút „name”"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r už existuje (v module %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Builder s menom %s nie je registrovaný ani dostupný cez vstupný bod"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Builder s menom %s nie je registrovaný"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "doména %s už je zaregistrovaná"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "doména %s ešte nie je zaregistrovaná"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "Direktíva %r už je registrovaná v doméne %s"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Rola %r už je registrovaná v doméne %s"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "Index %r už je registrovaný v doméne %s"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr " object_type %r už je registrovaný"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "crossref_type %r už je registrovaný"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r  už je registrovaný"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser pre %r už je registrovaný"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Analyzátor pre %s nie je registrovaný"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Translator pre %r už existuje"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r  už je registrovaný"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "math renderer %s  už je registrovaný"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "rozšírenie %r bolo zlúčené so Sphinx od verzie %s; toto rozšírenie je ignorované."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Pôvodná výnimka:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Nemožno importovať rozšírenie %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "rozšírenie %r nemá funkciu setup(); je to naozaj modul rozšírenia Sphinx?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Rozšírenie %s použité týmto projektom vyžaduje aspoň Sphinx v%s; takže ho nemožno zostaviť s touto verziou."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "rozšírenie %r vrátilo so svojej funkcie setup() nepodporovaný objekt; musí vrátiť None alebo slovník metadát"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "téma %r nemá nastavenie „theme”"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "téma %r nemá nastavenie „inherit”"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "nebola nájdená téma s menom %r, dedená v %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "nastavenie %s.%s nenájdené v žiadnom z nastavení témy"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "zadaná nepodporovaná voľba témy %r"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "súbor %r v ceste témy nie je platný súbor ZIP alebo neobsahuje tému"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme viac nie je nutnou závislosťou od verzie 1.4.0. Prosím, nainštalujte ho manuálne. pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr "nájdená sphinx_rtd_theme (< 0.3.0). Táto nebude dostupná od Sphinx-6.0"
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "nebola nájdená téma  smenom %r (chýbajúci theme.conf?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "zostavenie [mo]: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "zápis výstupu…"
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "všetky z %d súborov po"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
-msgstr ""
+msgstr "ciele pre %d po súborov, ktoré boli zadané"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
-msgstr ""
+msgstr "ciele pre %d po súborov, ktoré sú zastarané"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "všetky zdrojové súbory"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
-msgstr ""
+msgstr "súbor %r zadaný v príkazovom riadku nie je v zdrojovom adresári, ignorujem"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
-msgstr ""
+msgstr "súbor %r zadaný v príkazovom riadku neexistuje, ignorujem"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
-msgstr ""
+msgstr "%d zdrojové súbory zadané v príkazovom riadku"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
-msgstr ""
+msgstr "ciele pre %d zdrojových súborov, ktoré sú zastarané"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "zostavovanie [%s]: "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "hľadanie zastaraných súborov…"
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "%d nájdené"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "nenájdené"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr "ukladanie prostredia"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr "kontrolovanie konzistencie"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "žiadne ciele nie sú zastarané."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "aktualizácia prostredia:"
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s pridané, %s zmenené, %s odstránené"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "čítanie zdrojov…"
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "čakanie na procesy…"
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
-msgstr ""
+msgstr "mená dokumentov na zapísanie: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "príprava dokumentov"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "nájdená duplicitná položka Obsahu: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "kopírovanie obrázkov…"
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "nemožno čítať súbor obrázku %r: jeho kopírovanie namiesto toho"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
-msgstr ""
+msgstr "nemožno kopírovať súbor obrázka %r: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
-msgstr ""
+msgstr "nemožno zapísať súbor obrázka %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr "Pillow nenájdené – kopírovanie súborov obrázkov"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "zapisovanie súboru %s…"
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr "zapisovanie súboru mimetype…"
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr "zapisovanie súboru META-INF/container.xml…"
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr "zapisovanie súboru content.opf..."
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "neznámy typ MIME pre %s, ignorovaný"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr "zapisovanie súboru toc.ncx..."
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "zapisovanie súboru %s…"
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Súbor prehľadu je v %(outdir)s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "žiadne zmeny vo verzii %s."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "zapisovanie súboru prehľadu…"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Zabudované funkcie"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Úroveň modulu"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "kopírovanie zdrojových súborov…"
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
-msgstr ""
+msgstr "nemožno čítať %r na vytvorenie položky záznamu zmien"
 
 #: sphinx/builders/dummy.py:22
 msgid "The dummy builder generates no files."
-msgstr ""
+msgstr "Zostavovač dummy negeneruje žiadne súbory."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Súbory ePub sú v %(outdir)s."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr "zapisovanie súboru nav.xhtml..."
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „epub_language” (alebo „language”) nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
-msgstr ""
+msgstr "konfiguračná hodnota „epub_uid” má byť XML NAME pre EPUB3"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
-msgstr ""
+msgstr "konfiguračná hodnota „epub_title” (alebo „html_title”) nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
-msgstr ""
+msgstr "konfiguračná hodnota „epub_author” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
-msgstr ""
+msgstr "konfiguračná hodnota „epub_contributor” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
-msgstr ""
+msgstr "konfiguračná hodnota „epub_description” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
-msgstr ""
+msgstr "konfiguračná hodnota „epub_publisher” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
-msgstr ""
+msgstr "konfiguračná hodnota „epub_copyright” (alebo „copyright”) nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
-msgstr ""
+msgstr "konfiguračná hodnota „epub_identifier” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
-msgstr ""
+msgstr "konfiguračná hodnota „version” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "neplatný css_file: %r, ignorovaný"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Katalógy správ sú v %(outdir)s."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "čítanie šablón… "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "zapisovanie katalógov správ…"
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
-msgstr ""
-
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "Kotva „%s” nenájdená"
+msgstr "Hľadajte akékoľvek chyby v predošlom výstupe alebo v %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "poškodený odkaz: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "Kotva „%s” nenájdená"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Manuálové stránky sú v %(outdir)s."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
-msgstr ""
+msgstr "nebola nájdená konfiguračná voľba „man_pages”; manuálové stránky nebudú zapísané"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "zapisovanie"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
-msgstr ""
+msgstr "konfiguračná voľba „man_pages” odkazuje na neznámy dokument %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Stránky HTML sú v %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "zostavovanie spoločného dokumentu"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "zapisovanie dodatočných súborov"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Súbory Texinfo sú v %(outdir)s."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
-msgstr ""
+msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou makeinfo\n(použite tu 'make info' aby to bolo spustené automaticky)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
-msgstr ""
+msgstr "nebola nájdená konfiguračná voľba „texinfo_documents”; dokumenty nebudú zapísané"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
-msgstr ""
+msgstr "konfiguračná voľba „texinfo_documents” odkazuje na neznámy dokument %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "spracovanie %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "riešenie odkazov…"
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(v"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "kopírovanie podporných súborov Texinfo"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "chyba zápisu súboru Makefile: %s"
@@ -854,18 +881,18 @@ msgstr "chyba zápisu súboru Makefile: %s"
 msgid "The text files are in %(outdir)s."
 msgstr "Textové súbory sú  v %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "chyba zápisu súboru %s: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Súbory XML sú v %(outdir)s."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Súbory pseudo-XML sú v %(outdir)s."
@@ -873,297 +900,309 @@ msgstr "Súbory pseudo-XML sú v %(outdir)s."
 #: sphinx/builders/html/__init__.py:144
 #, python-format
 msgid "build info file is broken: %r"
-msgstr ""
+msgstr "súbor info zostavenia je poškodený: %r"
 
 #: sphinx/builders/html/__init__.py:176
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Stránky HTML sú v %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
-msgstr ""
+msgstr "Čítanie súboru zostavenia info zlyhalo: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d. %b  %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "konfiguračná hodnota „html_use_opensearch” musí teraz byť reťazec"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Všeobecný index"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "ďalší"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "predošlý"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
-msgstr ""
+msgstr "generovanie indexov"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
-msgstr ""
+msgstr "zapisovanie dodatočných stránok"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "kopírovanie súborov na stiahnutie…"
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "nemožno kopírovať súbor na stiahnutie %r: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "kopírovanie statických súborov…"
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr "Kopírovanie súboru v html_static_file zlyhalo: %s: %r"
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr "kopírovanie statických súborov"
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "nemožno kopírovať statický súbor %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
-msgstr ""
+msgstr "kopírovanie extra súborov"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "nemožno kopírovať extra súbor %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
-msgstr ""
+msgstr "Zápis súboru zostavenia info zlyhal: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
-msgstr ""
+msgstr "index hľadania nemožno načítať, ale nebudú zostavované všetky dokumenty, takže index nebude kompletný."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
-msgstr ""
+msgstr "stránka %s vyhovuje dvom vzorom v html_sidebars: %r a %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
-msgstr ""
+msgstr "pri spracovaní stránky %s nastala chyba Unicode. Prosím, zaistite, že všetky konfiguračné hodnoty, ktoré obsahujú nieASCII hodnotu sú reťazce Unicode."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Nastala chyba pri spracovaní stránky %s.\nPríčina: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
-msgstr ""
+msgstr "generovanie inventára objektov…"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
-msgstr ""
+msgstr "generovanie indexu hľadania v %s"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "neplatné js_file: %r, ignorované"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Zaregistrovaných je viac math_renderer, ale žiadny nie je zvolený."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Zdaný neznámy math_renderer %r."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "položka „html_extra_path entry” %r neexistuje"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "položka html_extra_path %r je umiestnené vo vnútri výstupného adresára"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "položka „html_static_path” %r neexistuje"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "položka html_static_path %r je umiestnené vo vnútri výstupného adresára"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "súbor loga %r neexistuje"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "súbor favicon %r neexistuje"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr "html_add_permalinks bolo označené za zastarané od v3.5.0. Prosím, použite namiesto toho html_permalinks a html_permalinks_icon."
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dokumentácia %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Súbory LaTeX sú v %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
-msgstr ""
+msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou  (pdf)latex\n(použite tu 'make latexpdf' aby to bolo spustené automaticky)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
-msgstr ""
+msgstr "nebola nájdená konfiguračná voľba „latex_documents”; dokmenty nebudú zapísané"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
-msgstr ""
-
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+msgstr "konfiguračná voľba „latex_documents” odkazuje na neznámy dokument %s"
+
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Vydanie"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
-msgstr ""
+msgstr "žiadna známa voľba Babel pre jazyk %r"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "kopírovanie podporných súborov Tex"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "kopírovanie podporných súborov Tex…"
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "kopírovanie dodatočných súborov"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
-msgstr ""
+msgstr "Neznámy konfiguračný kľúč: latex_elements[%r], ignorovaný."
+
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr "Neznáma voľba témy: latex_theme_options[%r], ignorovaná."
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
-msgstr ""
+msgstr "%r nemá nastavenia „theme”"
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
-msgstr ""
+msgstr "téma %r nemá nastavenie „1%s”"
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
-msgstr ""
+msgstr "Počas zostavenia sa vyskytla výnimka, spúšťam ladenie:"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
-msgstr ""
+msgstr "Prerušené!"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "Chyba značky reST:"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Chyba kódovania:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
-msgstr ""
+msgstr "Úplný záznam chýb bol zapísaný v  %s, ak chcete nahlásiť problém vývojárom."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Chyba rekurzie:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr ""
+msgstr "Toto môže nastať s veľmi veľkými alebo príliš hlboko vnáranými zdrojovými súbormi. môžete opatrne zvýšiť predvolenú hodnotu limitu rekurzie Python z 1000 v conf.py, napr.:"
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "Nastala výnimka:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Prosím, nahláste to, i keď to bola chyba používateľa, aby mohla byť nabudúce poskytnutá lepšia chybová správa."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Hlásenie o chybe možno vyplniť na <https://github.com/sphinx-doc/sphinx/issues>. Ďakujeme!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "počet úloh musí byť kladné číslo"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Ďalšie informácie nájdete na <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,296 +1219,290 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr ""
+msgstr "\nGeneruje dokumentáciu zo zdrojových súborov.\n\nsphinx-build generuje dokumentáciu zo súborov v SOURCEDIR a umiestni ju\nv OUTPUTDIR. Konfiguračné voľby hľadá v 'conf.py' v SOURCEDIR.\nNa generovanie súborov šablón, vrátane 'conf.py' možno použiť nástroj\n'sphinx-quickstart'\n\nsphinx-build dokáže vytvoriť dokumentáciu v rôznych formátoch. Formát je\nzvolený zadaním mena zostavovača v príkazovom riadku; predvolene\nHTML. Zostavovače môžu vykonávať aj iné úlohy, ktoré súvisia so spracovaním\ndokuemntácie.\n\nPredvolene je zostavené všetko, čo bolo zmenené. Výstup len zvolených súborov\nmôže byť zostavený zadaním jednotlivých mien súborov.\n"
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "cesta k zdrojovým súborom dokumentácie"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "cesta k výstupnej zložke"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
-msgstr ""
+msgstr "zoznam špecifických súborov na zostavenie, ignorovaný ak je použité -a"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "všeobecné voľby"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "použitý zostavovač (predvolený: html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "zapísať všetky súbory (predvolene: zapísať len nové a zmenené súbory)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "nepoužívať uložené prostredie, vždy čítať všetky súbory"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
-msgstr ""
+msgstr "cesta uloženého prostredia a súbory doctree (predvolene: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
-msgstr ""
+msgstr "zostaviť paralelne s N procesmi možné (špeciálna hodnota „auto” nastaví N na počet CPU)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
-msgstr ""
+msgstr "cesta k adresáru s konfiguračným súborom (conf.py) (predvolene: rovnaké ako SOURCEDIR)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
-msgstr ""
+msgstr "vôbec nepoužiť konfiguračný súbor, len voľby -D"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
-msgstr ""
+msgstr "prepíše nastavenie konfiguračného súboru"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
-msgstr ""
+msgstr "pošle hodnotu do šablón HTML"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
-msgstr ""
+msgstr "hnidopichný režim, upozorniť na všetky chýbajúce prepojenia"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "voľby výstupu konzoly"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "zvýšiť rozvláčnosť (možno opakovať)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "žiadny výstup, len upozornenia na stderr"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "vôbec žiadny výstup, ani upozornenia"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "generovať farebný výstup (predvolene: automaticky detegovať)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "negenerovať farebný výstup (predvolene: automaticky detegovať)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
-msgstr ""
+msgstr "zapísať varovania  (a chyby) do zadaného súboru"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "prepnúť upozornenia na chyby"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
-msgstr ""
+msgstr "s -W, pokračovať po upozornení"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
-msgstr ""
+msgstr "pri výnimke zobraziť úplné chybové hlásenie"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
-msgstr ""
+msgstr "pri výnimke spustiť Pdb"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
-msgstr ""
+msgstr "nemožno nájsť súbory %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
-msgstr ""
+msgstr "nemožno kombinovať voľbu -a a mená súborov"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
-msgstr ""
+msgstr "nemožno otvoriť súbor varovaní %r: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
-msgstr ""
+msgstr "argument voľby -D musí byť v tvare meno=hodnota"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
-msgstr ""
+msgstr "argument voľby -A musí byť v tvare meno=hodnota"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
-msgstr ""
+msgstr "automaticky vložiť dokumentačné reťazce z modulov"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
-msgstr ""
+msgstr "automaticky testovať kúsky kódu v blokoch dokumentačných reťazcov"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
-msgstr ""
+msgstr "prepojenie medzi dokumentáciou Sphinx rôznych modulov"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
-msgstr ""
+msgstr "písať položky „todo”, ktoré môžu byť zobrazené alebo skryté pri zostavení"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
-msgstr ""
+msgstr "zahrnúť math, spracované ako obrázky PNG alebo SVG"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
-msgstr ""
+msgstr "zahrnúť math, spracované prehliadačom pomocou MathJax"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
-msgstr ""
+msgstr "podmienečné zahrnutie obsahu na základe konfiguračných volieb"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
-msgstr ""
+msgstr "zahrnúť odkazy na zdrojový kód dokumentovaných objektov Python"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
-msgstr ""
+msgstr "vytvoriť súbor .nojekyll na publikovanie dokumentu na GitHub"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "Prosím, zadajte platnú cestu."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Prosím, zadajte nejaký text."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Prosím, zadajte jedno z 1%s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
-msgstr ""
+msgstr "Prosím, zadajte buď 'y' alebo 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
-msgstr ""
+msgstr "Prosím, zadajte príponu súboru, napr. '.rst' alebo '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Vitajte v nástroji Sphinx %s quickstart."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
-msgstr ""
+msgstr "Zvolená cesta koreňa: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
-msgstr ""
+msgstr "Zadajte cestu koreňa tejto dokumentácie."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
-msgstr ""
+msgstr "Cesta koreňa dokumentácie"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
-msgstr ""
+msgstr "Chyba: nájdený existujúci conf.py v zadanej ceste koreňa."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
-msgstr ""
+msgstr "sphinx-quickstart neprepíše existujúce projekty Sphinx."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
-msgstr ""
+msgstr "Prosím, zadajte novú cestu koreňa (alebo len Enter na skončenie)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
-msgstr ""
+msgstr "Sú dve možnosti umiestnenia adresára zostavenia s výstupom Sphinx.\nMôžete použiť buď adresár „_build” v koreni alebo môžete mať oddelené\nadresáre „source” a „build” v ceste koreňa."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Oddeliť zdrojový a výstupný adresár (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
-msgstr ""
+msgstr "V koreňovom adresári budú vytvorená dva ďalšie adresáre; \"_templates\"\npre vlastné šablóny HTML a \"_static\" pre vlastné CSS a iné statické súbory\nMôžete zadať inú predponu (napr. „.”), ktorá nahradí podčiarkovník."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
-msgstr ""
+msgstr "Predpona mena adresárov templates a static"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
-msgstr ""
+msgstr "Meno projektu bude na viacerých miestach zostavenej dokumentácie."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Názov projektu"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Meno(á) autora(ov)"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr ""
+msgstr "Sphinx má predstavu o \"version\" a \"release\" softvéru. Každá\nverzia môže mať viacero vydaní. Napríklad, pre Python je verzia\nniečo ako 2.5 alebo 3.0, zatiaľčo vydanie je niečo ako 2.5.1\nalebo 3.0a1. Ak nepotrebuje dvojitú štruktúru, jednoducho nastavte\noboje na rovnakú hodnotu."
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Verzia projektu"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Vydanie projektu"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,115 +1510,115 @@ msgid ""
 "\n"
 "For a list of supported codes, see\n"
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
-msgstr ""
+msgstr "Ak má byť dokumentácia písaná v inom ako Anglickom jazyku,\nmôžete tu zvoliť jazyk pomocou jeho kódu. Sphinx bude potom\nprekladať text, ktorý generuje, do tohoto jazyka.\n\nZoznam podporovaných jazykov nájdete na\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Jazyk projektu"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr ""
+msgstr "Prípona mena zdrojových súborov. Zvyčajne to je buď „.txt”\nalebo „.rst”. Len súbory s touto príponou sú považované za dokumenty."
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Prípona zdrojových súborov"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
 "of the documents. Normally, this is \"index\", but if your \"index\"\n"
 "document is a custom template, you can also set this to another filename."
-msgstr ""
+msgstr "Jeden dokument je špeciálny v tom, že je považovaný za vrcholový uzol\n„stromu obsahu”, čiže je to koreň hierarchickej štruktúry dokumentov.\nBežne to je „index”, ale ak je Váš „index” vlastnou šablónou, môžete\npoužiť aj iné meno súboru."
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Meno hlavného dokumentu (bez prípony)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
-msgstr ""
+msgstr "Chyba: nájdený existujúci hlavný súbor %s v zadanej ceste koreňa."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
-msgstr ""
+msgstr "sphinx-quickstart neprepíše existujúci súbor."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
-msgstr ""
+msgstr "Prosím, zadajte nové meno súboru alebo premenujte existujúci súbor a stlačte Enter"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
-msgstr ""
+msgstr "Informuje, ktoré z nasledujúcich rozšírení Sphinx majú byť zapnuté:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
-msgstr ""
+msgstr "Pozor: imgmath a mathjax nemožno zapnúť naraz. výber imgmath bol zrušený."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
-msgstr ""
+msgstr "Súbory Makefile a príkazový súbor Windows môže byť pre Vás vygenerovaný\ntakže stačí spustiť napr. len `make html' namiesto priameho spúšťania sphinx-build."
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
-msgstr ""
+msgstr "Vytvoriť Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
-msgstr ""
+msgstr "Vytvoriť príkazový súbor Windows? (y/n) "
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Vytváranie súboru %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Súbor %s už existuje, preskočené."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Dokončené: Počiatočná štruktúra adresára bola vytvorená."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
-msgstr ""
+msgstr "Teraz môže vyplniť svoj hlavný súbor %s a vytvoriť ostatné zdrojové súbory\ndokumentácie. "
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
-msgstr ""
+msgstr "Na zostavenie dokumentácie použite Makefile, napr.:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
-msgstr ""
+msgstr "Na zostavenie dokumentácie použite príkaz sphinx-build, napr.:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
-msgstr ""
+msgstr "kde „builder” je jeden z podporovaných formátov, napr. html, latex alebo linkcheck."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,789 +1626,778 @@ msgid ""
 "sphinx-quickstart is an interactive tool that asks some questions about your\n"
 "project and then generates a complete documentation directory and sample\n"
 "Makefile to be used with sphinx-build.\n"
-msgstr ""
+msgstr "\nGenereuje požadované súbory projektu Sphinx.\n\nsphinx-quickstart je interaktívny nástroj, ktorý kladie niekoľko otázok o  Vašom\nprojekte a potom generuje kompletný adresár dokumentácie a vzorový\nMakefile, na použitie so sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "tichý režim"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
-msgstr ""
+msgstr "koreň projektu"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "Voľby štruktúry"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
-msgstr ""
+msgstr "ak je zadané, oddeliť zdrojový a výstupný adresár"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr "ak je zadané, vytvoriť výstupný adresár v zdrojovom"
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
-msgstr ""
+msgstr "náhrada za bodku v _templates apod."
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
-msgstr ""
+msgstr "Základné voľby projektu"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "názov projektu"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "mená autorov"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "verzia projektu"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "vydanie projektu"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "jazyk dokumentácie"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "prípona zdrojových súborov"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "meno hlavného dokumentu"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "použiť epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Voľby rozšírenia"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "zapnúť rozšírenie %s"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "zapnúť konkrétne rozšírenia"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Vytvorenie Makefile a Batchfile"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "vytvoriť makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "nevytvoriť makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "vytvoriť batchfile"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "nevytvoriť batchfile"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "použiť režim make pre Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "nepoužiť režim make pre Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "Šablóny projektu"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "adresár šablóny pre súbory šablóny"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "definovať premennú šablóny"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
-msgstr ""
+msgstr "bolo zadané „quiet”, ale nebol zadaný „project” alebo „author”."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Chyba: zadaná cesta nie je adresár alebo súbory sphinx už existujú."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart generuje len do prázdneho adresára. Prosím, zadajte novú cestu koreňa."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
-msgstr ""
+msgstr "Neplatná premenná šablóny: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Neplatný popis: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
-msgstr ""
+msgstr "špecifikácia čísla riadku je mimo rozsahu (1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Nemožno použiť obe voľby „%s” a „%s”"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Súbor na vloženie %r nebol nájdený alebo zlyhalo jeho čítanie"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Kódovanie %r použité pri čítaní vloženého súboru %r vyzerá ako zlé, skúste zadať voľbu :encoding:"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objekt s menom %r nebol nájdený vo vloženom súbore %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Nemožno použiť „lineno-match” s rozdelenou množinou „lines”"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Riadok %r: žiadne riadky z vloženého súboru %r"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor sekcie:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor modulu:"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autor kódu:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr "voľba \":file:\" direktívy csv-table teraz rozpoznáva absolútnu cestu ako relatívnu k zdrojovému adresáru. Prosím, aktualizujte svoj dokument."
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
-msgid "Parameters"
-msgstr "Parametre"
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr "Duplicitná deklarácia C, definovaná aj v %s:%s.\nDeklarácia je '.. c:%s:: %s'."
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
+msgid "Parameters"
+msgstr "Parametre"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Vracia"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Návratový typ"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (funkcia C)"
+msgid "%s (C %s)"
+msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (člen C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (makro C)"
-
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (typ C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "člen"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (premenná C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "premenná"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funkcia"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "člen"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerátor"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "typ"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "premenná"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr "parameter funkcie"
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
-msgstr ""
-
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nové vo verzii %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Zmenené vo verzii %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Zastarané od verzie %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
-msgstr ""
+msgstr "duplicitná citácia  %s, ďalší výskyt v %s"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
-msgstr ""
+msgstr "Citácia [%s] nie je odkazovaná."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr ""
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr "Duplicitná deklarácia C++, definovaná aj v %s:%s.\nDeklarácia je '.. cpp:%s:: %s'."
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Parametre šablóny"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Vyvoláva"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
-msgstr ""
+msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "trieda"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "koncept"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerátor"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr "parameter šablóny"
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (zabudovaná funkcia)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metóda %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (trieda)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globálna premenná alebo konštanta)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribút %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumenty"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metóda"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "dáta"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribút"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
-msgstr ""
+msgstr "duplicitný %s popis %s, ďalší výskyt%s v %s"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "duplicitná menovka vzorca %s, ďalší výskyt v %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
-msgstr ""
+msgstr "neplatný math_eqref_format: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "kľúč. slovo"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operátor"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "výnimka"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "príkaz"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "zabudovaná funkcia"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Premenné"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Vyzdvihuje"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (v module %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (zabudovaná premenná)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (v module %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (zabudovaná premenná)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (zabudovaná trieda)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (trieda v %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (metóda %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (metóda triedy %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (statická metóda %s.%s)"
+msgid "%s() (%s property)"
+msgstr "%s() (vlastnosť %s)"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statická metóda %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (metóda triedy %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (metóda triedy %s)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atribút %s.%s)"
+msgid "%s (%s property)"
+msgstr "%s (vlastnosť %s)"
 
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Index modulov Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduly"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Zastarané"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "metóda triedy"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statická metóda"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr "vlastnosť"
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
-msgstr ""
+msgstr "duplicitný popis objektu  %s, ďalší výskyt v %s, použite :noindex: pre jeden z nich"
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
-msgstr ""
+msgstr "nájdený viac ako jeden cieľ krížového odkazu %r: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (zastarané)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktíva)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
-msgstr ""
+msgstr "%s (voľba direktívy)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rola)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktíva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rola"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
-msgstr ""
+msgstr "duplicitný popis %s %s, ďalší výskyt v %s"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "premenná prostredia; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
-msgstr ""
+msgstr "Nesprávny popis voľby %r, má vyzerať ako „opt”, „-opt argumenty”, „--opt argumenty”, „/opt argumenty” alebo „+opt argumenty”"
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
-msgstr ""
+msgstr "%s voľba príkazového riadka"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
-msgstr ""
+msgstr "voľba príkazového riadka"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
-msgstr ""
+msgstr "položke glosára musí predchádzať prázdny riadok"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
-msgstr ""
+msgstr "položky glosára nesmú byť oddelené prázdnymi riadkami"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
-msgstr ""
+msgstr "glosár vyzerá byť zle naformátovaný, skontrolujte odsadenie"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "termín glosára"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "jazykový token"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "menovka odkazu"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "premenná prostredia"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "voľba programu"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Index modulov"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Stránka hľadania"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
-msgstr ""
+msgstr "duplicitná menovka  %s, ďalší výskyt v %s"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
-msgstr ""
+msgstr "duplicitný %s popis %s, ďalší výskyt v %s"
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig je vypnutý, :numref: je ignorované."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr ""
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr "Zlyhalo vytvorenie krížového odkazu. Nie je priradené žiadne číslo: %s"
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
-msgstr ""
+msgstr "odkaz nemá popisok: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
-msgstr ""
+msgstr "neplatný numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
-msgstr ""
+msgstr "neplatný numfig_format: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr "nedefinovaná menovka: %s"
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr "Zlyhalo vytvorenie krížového odkazu. nenájdení názov alebo titulok: %s"
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "nová konfigurácia"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "zmenená konfigurácia"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "zmenené rozšírenie"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "prostredie zostavenia nie je aktuálne"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "zdrojový adresár zmenený"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
-msgstr ""
+msgstr "Toto prostredie nie je kompatibilné zo zvoleným zostavovačom, prosím, zvoľte iný adresár doctree."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
-msgstr ""
+msgstr "Zlyhalo skenovanie dokumentov v %s: %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
-msgstr ""
+msgstr "Doména %r nie je zaregistrovaná"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
-msgstr ""
+msgstr "nájdený na seba odkazujúci strom obsahu. Ignorované."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
-msgstr ""
+msgstr "dokument nie je zahrnutý v žiadnom strome obsahu"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "viď %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "viď aj %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
-msgstr ""
+msgstr "neznámy typ položky indexu %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symboly"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
-msgstr ""
+msgstr "zistený cirkulárny odkaz stromu obsahu, ignorované: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
-msgstr ""
+msgstr "strom obsahu obsahuje odkaz na dokument %r, ktorý nemá názov, odkaz nebude generovaný"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
-msgstr ""
+msgstr "strom obsahu obsahuje odkaz na vylúčený dokument %r"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
-msgstr ""
+msgstr "strom obsahu obsahuje odkaz na neexistujúci dokument %r"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
-msgstr ""
+msgstr "súbor obrázku nemožno čítať: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
-msgstr ""
+msgstr " Súbor obrázku %s nemožno čítať: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
-msgstr ""
+msgstr "súbor na stiahnutie nemožno čítať: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
-msgstr ""
+msgstr "%s už je priradené číslo sekcie (vnorený číslovaný strom obsahu?)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2387,165 +2409,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
-msgstr ""
+msgstr "cesta k dokumentovanému modulu"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
-msgstr ""
+msgstr "adresár umiestnenia výstupu"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
-msgstr ""
+msgstr "maximálna hĺbka submodulov, ktorá má byť zobrazená v obsahu (predvolene: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
-msgstr ""
+msgstr "prepísať existujúce súbory"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
-msgstr ""
+msgstr "nasledovať symbolické odkazy. Vhodné v kombinácii s collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
-msgstr ""
+msgstr "spustí skript bez vytvorenia súborov"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
-msgstr ""
+msgstr "umiestniť dokumentáciu každého modulu vo vlastnej stránke"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
-msgstr ""
+msgstr "zahrnúť ”_súkromné” moduly"
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
-msgstr ""
+msgstr "meno súboru obsahu (predvolene: modules)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
-msgstr ""
+msgstr "nevytvárať súbor obsahu"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
-msgstr ""
+msgstr "vložiť dokumentáciu modulu pred dokumentáciou submodulu"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
-msgstr ""
+msgstr "interpretovať cesty modulov v zmysle implicitnej špecifikácie menných priestorov PEP-0420"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
-msgstr ""
+msgstr "prípona súboru (predvolene: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
-msgstr ""
+msgstr "generovať úplný projekt pomocou sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
-msgstr ""
+msgstr "pripojiť module_path do sys.path, použité pri --full"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
-msgstr ""
+msgstr "meno projektu (predvolene: meno koreňového modulu)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
-msgstr ""
+msgstr "autor(i) projektu, použité pri --full"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
-msgstr ""
+msgstr "verzia projektu, použité pri --full"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
-msgstr ""
+msgstr "vydanie projektu, použité pri --full, predvolene --doc-version"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "voľby rozšírenia"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
-msgstr ""
+msgstr "%s nie je adresár."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
-msgstr ""
+msgstr "neplatný regulárny výraz %r v %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
-msgstr ""
+msgstr "neplatný regulárny výraz %r v coverage_c_regexes"
+
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr "nedokumentované API C: %s [%s] v súbore %s"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
-msgstr ""
+msgstr "modul %s nemožno importovať: %s"
+
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr "nedokumentovaná funkcia Python: %s :: %s"
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr "nedokumentovaná trieda Python: %s :: %s"
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr "nedokumentovaná metóda Python: %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "chýbajúce „+” alebo „-” vo voľbe „%s”."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' nie je platná voľba."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "„%s” nie je platná voľba pyversion"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
-msgstr ""
+msgstr "neplatný typ TestCode"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2559,11 +2601,11 @@ msgstr "Direktíva graphviz nemôže mať naraz argumenty content a filename"
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Externý súbor Graphviz %r nebol nájdený alebo zlyhalo jeho čítanie"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignorovaná direktíva „graphviz” bez obsahu."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,16 +2613,16 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "dot nevytvoril výstupný súbor:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "príkaz dot %r nemožno spustiť (nutný kvôli výstupu graphviz), skontrolujte nastavenie graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,32 +2630,33 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "dot skončil chybou:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format musí byť „png” alebo „svg”, ale je %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
-msgstr ""
+msgstr "kód dot %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graf: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[graf]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr ""
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
+msgstr "príkaz convert %r nemožno spustiť, skontrolujte nastavenia image_converter: 1%s"
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
 #, python-format
@@ -2623,150 +2666,160 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "convert skončil chybou:\n[stderr]\n%r\n[stdout]\n%r"
+
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "príkaz convert %r nemožno spustiť, skontrolujte nastavenie image_converter"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
-msgstr ""
+msgstr "Nemožno spustiť príkaz LaTeX %r (potrebný na zobrazenie math), skontrolujte nastavenia imgmath_latex"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
-msgstr ""
+msgstr "zobrazený latex %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
-msgstr ""
+msgstr "vnorený latex %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Trvalý odkaz na tento vzorec"
 
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
-msgstr ""
+msgstr "inventár intersphinx bol presunutý: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
-msgstr ""
+msgstr "načítanie inventára intersphinx z %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 ""
+msgstr "nastali problémy s niektorými inventármi, ale boli nájdené funkčné alternatívy:"
 
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
 msgid "failed to reach any of the inventories with the following issues:"
-msgstr ""
+msgstr "nemožno získať žiadne inventáre kvôli týmto problémom:"
 
-#: sphinx/ext/intersphinx.py:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(v %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
-msgstr ""
+msgstr "(v %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
-msgstr ""
+msgstr "identifikátor intersphinx %rnie je raťzec, ignorované"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
-msgstr ""
+msgstr "Zlyhalo čítanie intersphinx_mapping[%s], ignorované: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[zdroj]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "ToDo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
-msgstr ""
+msgstr "Nájdená položka TODO: %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<pôvodná položka>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> je umiestnená v %s, riadok %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "pôvodná položka"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
-msgstr ""
+msgstr "zvýrazňovanie syntaxe kódu modulu... "
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dokumenty]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Kód modulu"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Zdrojový kód %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Prehľad: kód modulu"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Všetky moduly, pre ktoré je dostupný kód</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
-msgstr ""
+msgstr "chyba formátovania argumentov %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
-msgstr ""
+msgstr "chýba atribút %s objektu %s"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2774,104 +2827,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
-msgid "\"::\" in automodule name doesn't make sense"
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:999
+msgid "\"::\" in automodule name doesn't make sense"
+msgstr "„::” v automodule nedáva zmysel"
+
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
-msgstr ""
+msgstr "__all__ má byť zoznam reťazcov, nie %r (v module %s) -- ignorované __all__"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr "chýbajúci atribút spomenutý vo voľbe :members: : modul %s, atribút %s"
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "Základ: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr "alias pre %s"
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr "alias pre TypeVar(%s)"
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr "Neplatné __slots__ nájdené v %s. Ignorované."
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr "Zlyhalo spracovanie predvolenej hodnoty argumentu %r: %s"
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias pre :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr "Autosummary s popiskom vyžaduje voľbu :toctree: , ignorované."
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
-msgstr ""
+msgstr "zlyhalo spracovanie mena %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
-msgstr ""
+msgstr "zlyhal import objektu %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
-msgstr ""
+msgstr "autosummary_generate: súbor nenájdený: %s"
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
-msgstr ""
+msgstr "autosummary interne generuje súbory .rst. Ale Váš source_suffix neobsahuje .rst. Preskočené."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2886,107 +2992,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
-msgstr ""
+msgstr "adresár umiestnenia výstupu"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
-msgstr ""
+msgstr "predvolená prípona súboru (predvolene: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
-msgstr ""
+msgstr "vlastný adresár šablón (predvolene: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
-msgstr ""
+msgstr "dokumentovať importovaných členov (predvolene: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Argumenty kľúčových slov"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
-msgstr ""
+msgstr "Príklad"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
-msgstr ""
+msgstr "Príklady"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
-msgstr ""
+msgstr "Poznámky"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
+msgstr "Ostatné parametre"
+
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
-msgstr ""
+msgstr "Varovania"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr "neplatná hodnota množiny (chýba koncová zátvorka): %s"
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr "neplatná hodnota množiny (chýba začiatočná zátvorka): %s"
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr "neplatná textová konštanta (chýba koncová úvodzovka): %s"
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr "neplatná textová konštanta (chýba začiatočná úvodzovka): %s"
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Výstraha"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Upozornenie"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Nebezpečné"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Chyba"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Rada"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Dôležité"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Poznámka"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Viď aj"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Varovanie"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "pokračovanie z predošlej strany"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "pokračuje na ďalšej strane"
@@ -2997,187 +3127,187 @@ msgstr ""
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:12
 msgid "Numbers"
-msgstr ""
+msgstr "Čísla"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:13
 msgid "page"
 msgstr "strana"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Obsah"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Hľadať"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "OK"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Zobraziť zdroj"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Prehľad"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Vitajte! Toto je"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "dokumentácia"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "posledná aktualizácia"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Indexy a tabuľky"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Celkový obsah"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "zoznam všetkých sekcií a podsekcií"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "hľadať v tejto dokumentácii"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Celkový index modulov"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "rýchly prístup ku všetkým modulom"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "všetky funkcie, triedy, termíny"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Index &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Celý index na jednej strane"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indexové stránky po písmenách"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "môže byť rozsiahle"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigácia"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Hľadať v %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "O dokumentácii"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Autorské právo"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Naposledy aktualizované %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Vytvorené pomocou <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr "Vytvorené pomocou <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Hľadať v %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Predošlá téma"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "predošlá kapitola"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Ďalšia téma"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "ďalšia kapitola"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Prosím, na zapnutie funkcie hľadania,aktivujte\nJavaScript ."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
-msgstr ""
+msgstr "Hľadanie viacerých slov vracia len zhody, ktoré obsahujú\n    všetky slová."
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "hľadať"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Výsledky hľadania"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Vášmu hľadaniu nezodpovedá žiadny dokument. Prosím, skontrolujte, že všetky zadané slová sú správne napísané a že ste zvolili vhodné kategórie."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Rýchle hľadanie"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Táto stránka"
 
@@ -3209,19 +3339,19 @@ msgstr "Zmeny API C"
 msgid "Other changes"
 msgstr "Ostatné zmeny"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Trvalý odkaz na tento nadpis"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Trvalý odkaz na túto definíciu"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Skryť výsledky hľadania"
 
@@ -3233,12 +3363,12 @@ msgstr "Hľadanie"
 msgid "Preparing search..."
 msgstr "Príprava hľadania..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Hľadanie dokončené, nájdené %s strana(y), ktoré vyhovujú hľadanému výrazu."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", v "
 
@@ -3251,7 +3381,7 @@ msgstr "Rozbaliť bočný panel"
 msgid "Collapse sidebar"
 msgstr "Zbaliť bočný panel"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Obsah"
 
@@ -3264,205 +3394,213 @@ msgstr ""
 #: sphinx/transforms/__init__.py:263
 #, python-format
 msgid "Footnote [%s] is not referenced."
-msgstr ""
+msgstr "Poznámka pod čiarou [%s] nie je odkazovaná."
 
 #: sphinx/transforms/__init__.py:269
 msgid "Footnote [#] is not referenced."
-msgstr ""
+msgstr "Poznámka pod čiarou [#] nie je odkazovaná."
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "viac ako jeden cieľ krížového odkazu %r: môže byť %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s cieľ odkazu nenájdený: %%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "Cieľ odkazu %r nebol nájdený: %%(target)s"
+msgid "%r reference target not found: %s"
+msgstr "%r cieľ odkazu nenájdený: %s"
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
-msgstr ""
+msgstr "Nemožno získať vzdialený obrázok: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
-msgstr ""
+msgstr "Nemožno získať vzdialený obrázok: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
-msgstr ""
+msgstr "Neznámy formát obrázku: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
-msgstr ""
+msgstr "nedekódovateľné zdrojové znaky, nahradené „?”: %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
-msgstr ""
+msgstr "preskočené"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
-msgstr ""
+msgstr "zlyhalo"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr "neznáma direktíva alebo meno role: %s:%s"
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
-msgstr ""
+msgstr "chyba čítania: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
-msgstr ""
+msgstr "chyba zápisu: %s: %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
-msgstr ""
+msgstr "Neplatný formát dátumu. Použije jednoduché úvodzovky, ak ho chcete priamo vo výstupe: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
-msgstr ""
+msgstr "strom obsahu obsahuje neexistujúci súbor %r"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
-msgstr ""
+msgstr "predvolená rola  %s nenájdená"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
-msgstr ""
+msgstr "nie je definovaný numfig_format pre %s"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
-msgstr ""
+msgstr "Žiadne ID nie je priradené uzlu %s"
+
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr "Trvalý odkaz na tento termín"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Trvalý odkaz na túto tabuľku"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Trvalý odkaz na tento kód"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Trvalý odkaz na tento obrázok"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
-msgstr "Trvalý odkaz na tento obsah"
+msgstr "Trvalý odkaz na tento strom obsahu"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
-msgstr ""
+msgstr "Nemožno získať veľkosť obrázku. voľba :scale: je ignorovaná."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
-msgstr ""
+msgstr "príliš veľké :maxdepth:, ignorované."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
-msgstr ""
+msgstr "názov dokumentu nie je jeden uzol Text"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Poznámky pod čiarou"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
-msgstr ""
+msgstr "sú zadané obe, tabularcolumns aj voľba :widths:. :widths: je ignorované."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[obrázok: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[obrázok]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
-msgstr ""
+msgstr "titulok nie je vo vnútri figure."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
-msgstr ""
+msgstr "neimplementovaný typ uzla: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
-msgstr ""
+msgstr "neznámy typ uzla: %r"
diff --git a/sphinx/locale/sl/LC_MESSAGES/sphinx.po b/sphinx/locale/sl/LC_MESSAGES/sphinx.po
index 6ceca74a05b..b729b4737c9 100644
--- a/sphinx/locale/sl/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sl/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Slovenian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sl/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: sl\n"
 "Plural-Forms: nplurals=4; plural=(n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Vgrajeni deli"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Nivo modula"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (v "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Splošni abecedni seznam"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "abecedni seznam"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "naprej"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "nazaj"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Abecedni seznam"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Izdaja"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Avtor sekcije: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Avtor modula: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Avtor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametri"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Vrne"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Vrne tip"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C funkcija)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C član)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C makro)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C tip)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "član"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C spremenljivka)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funkcija"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "član"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
-msgstr "tip"
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
+msgstr "tip"
+
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr ""
+
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Novo v verziji %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Spremenjeno v verziji %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Zastarelo od verzije %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "razred"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (vgrajene funkcije)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metoda)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (razred)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atribut)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "ključna beseda"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "izjema"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "izjava"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "vgrajene funkcije"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Sproži izjemo"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (v modulu %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (vgrajene spremenljivke)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (v modulu %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (vgrajene spremenljivke)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (vgrajen razred)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (razred v %s)"
 
-#: sphinx/domains/python.py:613
-#, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metoda)"
-
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s statična metoda)"
-
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
-#, python-format
-msgid "%s() (%s static method)"
-msgstr "%s() (%s statična metoda)"
-
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s class method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:745
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s atribut)"
+msgid "%s() (%s static method)"
+msgstr "%s() (%s statična metoda)"
 
-#: sphinx/domains/python.py:709
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "Moduli"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Zastarelo"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statična metoda"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (zastarelo)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "okoljska spremenljivka; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "okoljska spremenljivka"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Seznam modulov"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Iskalnik"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "vzdevek za :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Pozor"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Previdno"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Nevarno"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Napaka"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Nasvet"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Pomembno"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Opomba"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Poglej Tudi"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Nasvet"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Opozorilo"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "nadaljevanje iz prejšnje strani"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,181 +3130,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Išči"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Potrdi"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Prikaži izvorno kodo"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Pregled"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Kazalo in seznami:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Popoln Seznam Vsebine"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "prikazi vse sekcije in podsekcije"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "išči po dokumentaciji"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Splošen seznam modulov"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "hiter dostop do vseh modulov"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "vse funkcije, razredi, izrazi"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Seznam &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Poln indeks na eni strani"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Indeksiraj strani po črki"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "lahko je veliko"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigacija"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Išči med %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "O dokumentih"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Vse pravice pridržane"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Zadnjič posodobljeno %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Narejeno s <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Išči %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Prejšnja tema"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "prejšnje poglavje"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Naslednja tema"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "naslednje poglavje"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Za pravilno delovanje Iskanja morete vklopiti\n    JavaScript."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "išči"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Rezultati Iskanja"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Hitro iskanje"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Trenutna stran"
 
@@ -3206,19 +3336,19 @@ msgstr "C API spremembe"
 msgid "Other changes"
 msgstr "Ostale spremembe"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Povezava na naslov"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Povezava na to definicijo"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Skrij resultate iskanja"
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Opombe"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[slika]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/sq/LC_MESSAGES/sphinx.po b/sphinx/locale/sq/LC_MESSAGES/sphinx.po
index fb1b0e26ca2..3bb7836deac 100644
--- a/sphinx/locale/sq/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sq/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-15 09:14+0000\n"
-"Last-Translator: Besnik <besnik@programeshqip.org>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 19:43+0000\n"
+"Last-Translator: Besnik Bleta <besnik@programeshqip.org>\n"
 "Language-Team: Albanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sq/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: sq\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "drejtoria e formësimeve nuk përmban një kartelë conf.py (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "S’gjendet dot drejtori burim (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr "Drejtoria e përfundimeve (%s) s’është drejtori"
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Drejtoria burim dhe drejtoria vendmbërritje s’mund të jenë identike"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Po xhirohet Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr "Për arsye sigurie, mënyra paralele është e çaktivizuar në macOS dhe python3.8 dhe më sipër. Për më tepër hollësi, ju lutemi, lexoni https://github.com/sphinx-doc/sphinx/issues/6803"
+msgstr "Për arsye sigurie, mënyra paralele është e çaktivizuar në macOS dhe python3.8 dhe më sipër.  Për më tepër hollësi, ju lutemi, lexoni https://github.com/sphinx-doc/sphinx/issues/6803"
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Ky projekt lyp të paktën Sphinx v%s, ndaj s’mund të montohet me këtë version."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "po krijohet drejtori përfundimesh"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "teksa ujdiset zgjerimi %s:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' siç është përcaktuar aktualisht te conf.py s’është funksion Python që mund të thirret. Ju lutemi, ndryshojeni përcaktimin e tij që ta bëni një funksion që mund të thirret. Kjo është e nevojshme që conf.py të sillet si një zgjerim Sphinx."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "po ngarkohen përkthime [%s]… "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "u bë"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "s’është i passhëm për mesazhe të brendshëm"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "dështoi: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "S’u përzgjodh montues, po përdoret parazgjedhja: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "doli me sukses"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "u përfundua me probleme"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "montimi %s, % sinjalizim (me sinjalizime të trajtuara si gabime)."
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "montimi %s, %s sinjalizime (me sinjalizime të trajtuara si gabime)."
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "build %s, %s warning."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
-msgstr "montimi %s, %s sinjalizime"
+msgstr "montimi %s, %s sinjalizime."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "montimi %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "klasa %r e nyjeve është e regjistruar tashmë, vizitorët e saj do të anashkalohen"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "direktiva %r është e regjistruar tashmë, do të anashkalohet"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "roli %r është e regjistruar tashmë, do të anashkalohet"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr "zgjerimi %s nuk deklaron nëse është i parrezik për lexim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "zgjerimi %s s’është i sigurt për lexim paralel"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr "zgjerimi %s nuk deklaron nëse është i parrezik për shkrim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "zgjerimi %s s’është i sigurt për shkrim paralel"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "s’mund të anashkalohet rregullim formësimi fjalorthi %r, po shpërfillet (për të ujdisur elemente individuale, përdorni %r)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "numër %r i pavlefshëm për vlerë formësimi %r, po shpërfillet"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "s’mund të anashkalohet rregullim formësimi %r me një lloj të pambuluar, po shpërfillet"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "vlerë e panjohur formësimi %r te anashkalimi, po shpërfillet"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "S’ka vlerë të tillë formësimi: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Vlerë formësimi %r e pranishme tashmë"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Ka një gabim sintakse te kartela juaj e formësimit: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Kartela e formësimit (ose një nga modulet që ajo importon) thirri sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr "Ka një gabim të programueshëm te kartela juaj e formësimit:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "Vlera e formësimit `source_suffix' pret një varg, një listë vargjesh, ose një fjalor. Por është dhënë `%r'."
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Ndarja %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Figura %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tabela %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "Vlera e formësimit `{name}` duhet të jetë një nga {candidates}, por është dhënë `{current}`."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "Vlera e formësimit `{name}' është e llojit `{current.__name__}'; pritej {permitted}."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "Vlera e formësimit `{name}' është e llojit `{current.__name__}', si parazgjedhje merr `{default.__name__}'."
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "vlera e formësimit %r është caktuar si një varg me shenja jo ASCII; kjo mund të shpjerë në gabime Unikodi. Ju lutemi, përdorni vargje Unikod, p.sh., %r."
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr "s’u gjet primary_domain %r, po shpërfillet."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "Që prej v2.0, Sphinx përdor \"index\" për master_doc, si parazgjedhje. Ju lutemi, shtoni \"master_doc = 'contents'\" te conf.py juaj."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr "Që prej v2.0, Sphinx përdor \"index\" për root_doc, si parazgjedhje. Ju lutemi, shtoni \"root_doc = 'contents'\" te conf.py juaj."
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Vlerë formësimi %r e pranishme tashmë"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Emër i panjohur akti: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr "Trajtuesi %r për aktin %r u përgjigj me një përjashtim"
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "Zgjerimi %s është i domosdoshëm për needs_extensions settings, por s’është ngarkuar."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Ky projekt lyp zgjerimin %s të paktën nën versionin %s dhe prandaj s’mund të montohet me versionin e ngarkuar (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr "u gjetën shumë kartela për dokumentin \"%s\": %r\nPërdorni %r për montimin."
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "dokument i palexueshëm. U shpërfill."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Klasa %s e montuesit nuk ka atribut \"name\""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Montuesi %r ekziston tashmë (te moduli %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Emër %s montuesi jo i regjistruar ose i passhëm përmes pike hyrjeje"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Emër montuesi %s jo i regjistruar"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "përkatësi %s e regjistruar tashmë"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "përkatësi %s ende e paregjistruar"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "Direktiva %r është e regjistruar tashmë te përkatësia %s"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Roli %r është i regjistruar tashmë te përkatësia %s"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "Treguesi %r është i regjistruar tashmë te përkatësia %s"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "object_type %r është i regjistruar tashmë"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "crossref_type %r është i regjistruar tashmë"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r është i regjistruar tashmë"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser për %r është i regjistruar tashmë"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Përtypës burimesh për %s jo i regjistruar"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Përkthyesi për %r ekziston tashmë"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "kwargs për add_node() duhet të jetë një çift funksioni (visit, depart): %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r tashmë i regjistruar"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
-msgstr ""
+msgstr "vizatuesi i simboleve matematikore %s është i regjistruar tashmë"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "zgjerimi %r qe shkrirë me Sphinx-in që me versionin %s; ky zgjerim është shpërfillur."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Përjashtimi origjinal:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "S’u importua dot zgjerimi %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "zgjerimi %r s’ka funksion setup(); a është vërtet një modul zgjerimi Sphinx-i?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Zgjerimi %s i përdorur nga ky projekt lyp të paktën Sphinx v%s; prandaj s’mund të montohet me këtë version."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "zgjerimi %r u përgjigj me një objekt të pambuluar prej funksionit të vet setup(); duhet të përgjigjet me Asnjë ose një fjalorth tejtëdhënash"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "tema %r s’ka rregullimin \"theme\""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "tema %r s’ka rregullimin \"inherit\""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "s’u gjet temë e emërtuar %r, u trashëgua nga %r"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "rregullimi %s.%s nuk haset në asnjë prej formësimeve temash ku u kërkua"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "është dhënë mundësi teme %r e pambuluar"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "kartela %r te shteg teme s’është kartelë zip e vlefshme ose nuk përmban temë"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme s’është më një varësi e ngulitur në program, që prej versionit 1.4.0. Ju lutemi, instalojeni dorazi. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr "U gjet sphinx_rtd_theme (< 0.3.0). S’do të jetë e passhme që prej Sphinx-6.0"
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "s’u gjet temë e emërtuar %r (mos mungon theme.conf?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "po montohet [mo]: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "po shkruhet përfundim… "
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "krejt kartelat po %d"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "objektiva për kartela po %d që janë specifikuar"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "objektiva për kartela po %d që janë të papërditësuara"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "krejt kartelat burim"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "kartela %r e dhënë te rresht urdhrash s’gjendet te drejtori burim, po shpërfillet"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "kartela %r e dhënë te rresht urdhrash s’ekziston, po shpërfillet"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "kartela burim %d dhënë te rresht urdhrash"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "objektiva për kartela burim %d që janë të papërditësuara"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "po montohet [%s]: "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "po shihet për kartela të sapovjetruara… "
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "U gjet %d"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "s’u gjet gjë"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
-msgstr ""
+msgstr "po kontrollohet njëtrajtshmëria"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "s’ka objektiva të vjetruar."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "po përditësohet mjedisi: "
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s të shtuar, %s të ndryshuar, %s të hequr"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "po lexohen burime… "
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "po pritet për workers…"
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "emra dokumentesh për shkrim: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "po përgatiten dokumente"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "u gjet zë TeL i përsëdytur: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "po kopjohen figura… "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "s’lexohet dot kartelë figure %r: në vend të tij, po kopjohet"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "s’kopjohet dot kartelë figure %r: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "s’shkruhet dot kartelë figure %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
-msgstr ""
+msgstr "S’u gjet Pillow - po kopjohen kartela figurë"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "po shkruhet kartelë %s…"
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr "po shkruhet kartelë llojesh MIME…"
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr "po shkruhet kartelë META-INF/container.xml…"
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr "po shkruhet kartelë content.opf…"
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "lloj MIME i panjohur për %s, po shpërfillet"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr "po shkruhet kartelë toc.ncx…"
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "po shkruhet kartelë %s…"
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Kartela përmbledhje gjendet te %(outdir)s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "s’ka ndryshime në version %s."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "po shkruhet kartelë përmbledhje…"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
-msgstr ""
+msgstr "Të brendshme"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Shkallë moduli"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "po kopjohen kartela burim…"
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "s’u lexua dot %r për krijim regjistrimi ndryshimesh"
@@ -688,160 +711,164 @@ msgstr "s’u lexua dot %r për krijim regjistrimi ndryshimesh"
 msgid "The dummy builder generates no files."
 msgstr "Montuesi provë nuk prodhon kartela."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Kartela ePub gjendet te %(outdir)s."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr "po shkruhet kartelë nav.xhtml…"
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_language\" (ose \"language\") s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "vlera e formësimit \"epub_uid\" duhet të jetë XML NAME për EPUB3"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_title\" (ose \"html_title\") s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_author\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_contributor\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_description\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_publisher\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_copyright\" (ose \"copyright\") s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_identifier\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"version\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "css_file e pavlefshme: %r, u shpërfill"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Katalogët e mesazheve gjenden te %(outdir)s."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "objektiva për kartela gjedhe %d"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "po lexohen gjedhe… "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "po shkruhen katalogë mesazhesh… "
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Shihni për çfarëdo gabimesh te përfundimi më sipër ose te %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "S’u gjet spirancë '%s'"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "lidhje e dëmtuar: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "S’u gjet spirancë '%s'"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Faqet e doracakut gjenden në %(outdir)s."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "s’u gjet vlerë formësimi \"man_pages\"; s’do të shkruhet ndonjë faqe doracaku"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
-msgstr ""
+msgstr "po shkruhet"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "vlera e formësimit \"man_pages\" i referohet një dokumenti të panjohur %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Faqja HTML gjenden në %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "po montohet dokument njësh"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "po shkruhen kartela shtesë"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Kartelat Texinfo gjenden në %(outdir)s."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nXhironi 'make' te ajo drejtori, që të xhirohen këto përmes makeinfo-s\n(përdorni këtu 'make info' që kjo të kryhet automatikisht)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "po përpunohet %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "po shquhen referencat…"
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (në "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "po kopjohen kartela mbulimi Texinfo"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "gabim në shkrim kartele Makefile: %s"
@@ -851,18 +878,18 @@ msgstr "gabim në shkrim kartele Makefile: %s"
 msgid "The text files are in %(outdir)s."
 msgstr "Kartelat tekst gjenden në %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "gabim në shkrim kartele %s: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Kartelat XML gjenden në %(outdir)s."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Kartelat pseudo-XML gjenden në %(outdir)s."
@@ -877,290 +904,302 @@ msgstr "kartela e të dhënave të montimit është e dëmtuar: %r"
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Faqet HTML gjenden në %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "S’u arrit të lexohet kartelë të dhënash montimi: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "vlera e formësimit html_use_opensearch tani duhet të jetë një varg"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Tregues i Përgjithshëm"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "tregues"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "pasuesi"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "i mëparshmi"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr "po prodhohen tregues"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr "po shkruhen faqe shtesë"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "po kopjohen kartela të shkarkueshme… "
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "s’kopjohet dot kartelë e shkarkueshme %r: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "po kopjohen kartela statike… "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr "S’u arrit të kopjohet një kartelë te html_static_file: %s: %r"
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr "po kopjohen kartela statike"
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "s’kopjohet dot kartelë statike %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr "po kopjohen kartela ekstra"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "s’kopjohet dot kartelë ekstra %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "S’u arrit të shkruhet kartelë të dhënash montimi: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "treguesi i kërkimi s’u ngarkua dot, por jo krejt dokumentet do të montohen: treguesi do të jetë i paplotë."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "faqja %s ka përputhje me dy rregullsi te html_sidebars: %r dhe %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "ndodhi një gabim Unikod, kur vizatohej faqja %s. Ju lutemi, siguroni që krejt vlerat e formësimit që përmbajnë lëndë jo-ASCII të jenë vargje Unikod."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Ndodhi një gabim gjatë vizatimit të faqes %s.\nArsye: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
-msgstr ""
+msgstr "po shkruhet lënda e treguesit të kërkimeve në %s"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "js_file e pavlefshme: %r, u shpërfill"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Janë të regjistruar plot math_renderers. Por s’u përzgjodh math_renderer."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "U dha math_renderer %r i panjohur."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "zëri html_extra_path %r s’ekziston"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "zëri %r i html_extra_path entry është vendosur jashtë outdir-it"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "zëri html_static_path %r s’ekziston"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "zëri %r i html_extra_path entry është vendosur brenda outdir-it"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "kartela stemë %r s’ekziston"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "kartela favikonë %r s’ekziston"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr "html_add_permalinks është nxjerrë nga përdorimi që me v3.5.0. Ju lutemi, në vend të tyre përdorni html_permalinks dhe html_permalinks_icon."
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dokumentim i %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Kartelat LaTeX gjenden në %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nXhironi 'make' te ajo drejtori që të xhirohen këto përmes (pdf)latex\n(që të bëhet kjo automatikisht, përdorni `make latexpdf' këtu)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Tregues"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Hedhje Në Qarkullim"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "s’ka mundësi Babel të njohur për gjuhën %r"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "po kopjohen kartela mbulimi TeX"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "po kopjohen kartela mbulimi TeX…"
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "po kopjohen kartela shtesë"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr "Kyç i panjohur formësimi: latex_elements[%r], u shpërfill."
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr "Mundësi e panjohur teme: latex_theme_options[%r], u shpërfill."
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r s’ka rregullimin \"theme\""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r s’ka rregullimin \"%s\""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Ndodhi një përjashtim gjatë montimit, po niset diagnostikuesi:"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr "U ndërpre!"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "Gabim markup-i reST:"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Gabim kodimi:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Traceback-u i plotë është ruajtur te %s, nëse doni t’ua raportoni problemin zhvilluesve."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Gabim përsëritje:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "Kjo mund të ndodhë me kartela burim shumë të mëdha ose të futura thellë brenda njëra-tjetrës. Mund të rrisni me kujdes kufirin parazgjedhje për ripërsëritje Python prej 1000 te conf.py me p.sh.:"
+msgstr "Kjo mund të ndodhë me kartela burim shumë të mëdha ose të futura thellë brenda njëra-tjetrës. Mund të rrisni me kujdes kufirin parazgjedhje për ripërsëritje Python prej 1000, te conf.py, me p.sh.:"
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "Ndodhi një përjashtim:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Ju lutemi, njoftojeni nëse qe një gabim përdoruesi, që kështu herës tjetër të mund të furnizohet një mesazh më i mirë gabimi."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Një njoftim të mete mund të depozitohet te gjurmuesi në <https://github.com/sphinx-doc/sphinx/issues>. Faleminderit!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "numri i aktit duhet të jetë një numër pozitiv"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Për më tepër të dhëna, vizitoni <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1177,296 +1216,290 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nProdhoni dokumentim nga kartela burim.\n\nsphinx-build prodhon dokumentim prej kartelash te SOURCEDIR dhe e vendos\nte OUTPUTDIR. Kërkon për 'conf.py' te SOURCEDIR për rregullime formësimi.\nMjeti 'sphinx-quickstart' mund të përdoret për të prodhuar kartela gjedhe,\npërfshi 'conf.py'\n\nsphinx-build mund të krijojë dokumentim në formate të ndryshëm. Një format\npërzgjidhet duke specifikuar te rreshti i urdhrave emrin e montuesit; HTML-ja,\nsi parazgjedhje. Montuesit mund të kryejnë gjithashtu veprime të tjera të lidhura\nme përpunim dokumentimi.\n\nSi parazgjedhje, gjithçka që është e papërditësuar, është e montuar. Nëse doni\nmontim vetëm për kartela të përzgjedhura, kjo mund të bëhet duke specifikuar\nemra kartelash individuale.\n"
+msgstr "\nProdhoni dokumentim nga kartela burim.\n\nsphinx-build prodhon dokumentim prej kartelash te SOURCEDIR dhe e vendos\nte OUTPUTDIR. Kërkon për 'conf.py' te SOURCEDIR për rregullime formësimi.\nMjeti 'sphinx-quickstart' mund të përdoret për të prodhuar kartela gjedhe,\npërfshi 'conf.py'\n\nsphinx-build mund të krijojë dokumentim në formate të ndryshëm. Një format\npërzgjidhet duke specifikuar te rreshti i urdhrave emrin e montuesit; HTML-ja,\nsi parazgjedhje. Montuesit mund të kryejnë gjithashtu veprime të tjera të lidhura\nme përpunim dokumentimi.\n\nSi parazgjedhje, gjithçka që është e papërditësuar, montohet. Nëse doni\nmontim vetëm për kartela të përzgjedhura, kjo mund të bëhet duke\nspecifikuar emra kartelash individuale.\n"
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "shteg për te kartela burimi dokumentimi"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "shteg për te drejtori përfundimesh"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "një listë kartelash specifike për rimontim. E shpërfillur, nëse jepet -a"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "mundësi të përgjithshme"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "montues për t’u përdorur (parazgjedhje: html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "shkruaj krejt kartelat (parazgjedhje: shkruaj vetëm kartela të reja dhe ato të ndryshuara)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "mos përdor një mjedis të ruajtur, lexo përherë krejt kartelat"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "shteg për mjedis të ruajtur në fshehtinë dhe kartela doctree (parazgjedhje: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
-msgstr ""
+msgstr "montoje në paralel me N procese, kur është e mundur (vlera speciale “auto”\" do ta vërë N-në sa cpu-count)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "shteg ku gjendet kartelë formësimi (conf.py) (parazgjedhje: i njëjtë me SOURCEDIR)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "mos përdor fare kartelë formësimesh, vetëm mundësitë -D"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "anashkalo një rregullim te kartelë formësimi"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "jep një vlerë te gjedhe HTML"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
-msgstr ""
+msgstr "përcaktoni etiketë: përfshi blloqe “only” me TAG"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "mënyrë gërricëse, sinjalizo mbi krejt referencat që mungojnë"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
-msgstr ""
+msgstr "mundësi për ç’prodhon konsola"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "pa output në stdout, thjesht sinjalizime në stderr"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "pa output fare, madje as sinjalizime"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "shkruaj sinjalizime (dhe gabime) te kartela e dhënë"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "shndërroji sinjalizimet në gabime"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr "me -W, vazhdo punën, kur merren sinjalizime"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
-msgstr ""
+msgstr "xhiro Pdb, në rast përjashtimesh"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "s’gjenden dot kartela %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "s’mund të ndërthuret një mundësi -a dhe emra kartelash"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "s’hapet dot kartelë sinjalizimesh %r: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "argumenti i mundësisë -D duhet të jetë në formën emër=vlerë"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "argumenti i mundësisë -A duhet të jetë në formën emër=vlerë"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "fut automatikisht docstrings prej modulesh"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "testo automatikisht copëza kodi te blloqe doctest"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "lidhje mes dokumentimi Sphinx projektesh të ndryshëm"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "shkruaj zëra \"todo\" që mund të shfaqen ose fshihen te montimi"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
-msgstr ""
+msgstr "kontrolle për mbulim dokumentimi"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "përfshi formula matematikore, të vizatuara si figura PNG ose SVG"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "përfshi formula matematikore, të vizatuara te shfletuesi nga MathJax"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "përfshirje e kushtëzuar lënde, bazuar në vlera formësimi"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "përfshi lidhje te kodi burim i objekteve Python të dokumentuara"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "krijo kartelë .nojekyll për të botuar dokumentin në faqe GitHub"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "Ju lutemi, jepni një emër shtegu të vlefshëm."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Ju lutemi, jepni ca tekst."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Ju lutemi, jepni një nga %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Ju lutemi, jepni 'y' ose 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Ju lutemi, jepni një prapashtesë kartele, për shembull, '.rst' ose '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "* Shënim: janë dhënë shenja jo-ASCII dhe kodim i panjohur terminali -- po konsiderohen UTF-8 ose Latin-1."
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Mirë se vini te mjeti për fillim të shpejtë me Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Ju lutemi, jepni vlera për rregullimet vijuese (thjesht shtypni tastin\nEnter që të pranohet një vlerë parazgjedhje, nëse është një e tillë\nbrenda kllapave)."
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Shteg rrënjë i përzgjedhur: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr "Jepni shtegun rrënjë për te dokumenti."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "Shteg rrënje për te dokumenti"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Gabim: te shtegu rrënjë i përzgjedhur u gjet një conf.py ekzistues."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart s’do të mbishkruajë projekte ekzistuese Sphinx."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Ju lutemi, jepni një shteg të ri rrënjë (ose thjesht shtypni tastin Enter, që të dilet)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Keni dy mundësi për vendosjen e drejtorisë së montimeve për çka prodhon Sphinx-i.\nPërdorni një drejtori \"_build\" brenda shtegut rrënjë, ose i ndani\ndrejtoritë \"burim\" dhe \"montim\" brenda shtegut rrënjë."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Nda veçmas drejtoritë burim dhe montim (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "Brenda drejtorisë rrënjë do të krijohen dy drejtori të tjera; \"_templates\" për\ngjedhe vetjake HTML, dhe \"_static\" për fletëstile vetjakë dhe kartela të tjera statike.\nMund të krijoni një tjetër parashtesë (bie fjala, \".\") në vend të nënvijës."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "Parashtesë emrash për drejtori gjedhesh dhe statikesh"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "Emri i projektit do të shfaqet në disa vende te dokumentimi i montuar."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Emër projekti"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Emër(a) autori(ësh)"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr "Sphinx-i përdor nocionet e një \"versioni\" dhe një \"hedhjeje në qarkullim\" për\nsoftware-in. Çdo version mund të ketë hedhje të shumta në qarkullim. Bie\nfjala, për Python-in versionet ngjajnë me 2.5 ose 3.0, teksa hedhja në\nqarkullim ngjan me 2.5.1 ose 3.0a1. Nëse s’ju hyn në punë kjo strukturë\nduale, thjesht vëruni të dyjave të njëjtën vlerë."
+msgstr "Sphinx-i përdor nocionet e “versionit” dhe “hedhjes në qarkullim” për\nsoftware-in. Çdo version mund të ketë hedhje të shumta në qarkullim.\nBie fjala, për Python-in versionet ngjajnë me 2.5 ose 3.0, teksa hedhja\nnë qarkullim ngjan me 2.5.1 ose 3.0a1.  Nëse kjo strukturë duale s’ju\nhyn në punë, thjesht vëruni të dyjave të njëjtën vlerë."
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Version projekti"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Hedhje në qarkullim e projektit"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Nëse dokumentet janë shkruan në gjuhë tjetër nga anglishtja,\nmund të përzgjidhni një gjuhë këtu, përmes kodit të asaj gjuhe. Sphinx-i mandej\ndo të përkthejë në atë gjuhë tekstin që prodhon.\n\nPër një listë kodesh të mbuluar, shihni\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Gjuhë projekti"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr "Prapashtesa e emrave të kartelave për kartela burim. Zakonisht, kjo\nështë ose \".txt\", ose \".rst\". Vetëm kartelat me këtë prapashtesë\nmerren si dokumente."
+msgstr "Prapashtesa e emrave të kartelave për kartela burim. Zakonisht, kjo\nështë ose \".txt\", ose \".rst\".  Vetëm kartelat me këtë prapashtesë\nmerren si dokumente."
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Prapashtesë kartele burim"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr "Një dokument është i veçantë, për faktin se konsiderohet si nyja e epërme\ne  \"pemës së lëndës\", domethënë, është rrënja e strukturës hierarkike\ntë dokumenteve. Zakonisht, ky është \"index\", por nëse dokumenti juaj \"index\"\nështë një gjedhe vetjake, si të tillë mund të caktoni një tjetër emër kartele."
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Emër i dokumentit tuaj kryesor (pa prapashtesë)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Gabim: kartela master %s është gjetur tashmë një herë në shtegun rrënjë të përzgjedhur."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart s’do të mbishkruajë kartelën ekzistuese."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Ju lutemi, jepni një emër të ri kartele, ose riemërtojeni kartelën ekzistuese dhe shtypni tastin Enter"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Përcaktoni se cilët nga zgjerimet vijuese Sphinx duhen aktivizuar:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Shënim: imgmath dhe mathjax s’mund të aktivizohen në të njëjtën kohë. U hoqë përzgjedhja e imgmath-it."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Për ju mund të prodhohen një kartelë makefile dhe një urdhrash Windows, që\nkështu t’ju duhet vetëm të xhironi, për shembull, `make html', në vend se\ntë thirret drejtpërsëdrejti sphinx-build."
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Të krijohet Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "Të krijohet kartelë urdhrash Windows? (y/n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "Po krijohet kartela %s."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Ka tashmë një kartelë %s, po anashkalohet."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Përfundoi: U krijua një strukturë fillestare drejtorish."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Tani duhet të populloni kartelën tuaj master file %s dhe të krijoni kartela të tjera\nburim të dokumentimit. "
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Përdorni Makefile-in që të montohen dokumentet, kështu:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Përodrni urdhrin sphinx-build që të montohen dokumentet, kështu:\n   sphinx-build -b montues %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "ku montues është një nga montuesin e mbuluar, p.sh., html, latex ose linkcheck."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nProdho kartelat e domosdoshme për një projekt Sphinx.\n\nsphinx-quickstart është një mjet ndërveprues që bën disa pyetje rreth projektit\ntuaj dhe mandej prodhon një drejtori të plotë dokumentimi dhe një shembull\nMakefile për t’u përdorur me sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "mënyra pa zhurmë"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr "rrënjë e projektit"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "Mundësi strukture"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "nëse është kërkuar, nda veçmas drejtoritë burim dhe montim"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr "në u përcaktoftë, krijo drejtori montimi nën drejtorinë burim"
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "zëvendësim për pikën te _templates, etj."
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "Mundësi bazë të projektit"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "emër projekti"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "emra autorësh"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "version i projektit"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "hedhje në qarkullim e projektit"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "gjuhë dokumenti"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "prapashtesë kartele burim"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
-msgstr ""
+msgstr "emër dokumenti bazë"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "përdor epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Mundësi zgjerimi"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "aktivizo zgjerimin %s"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
-msgstr ""
+msgstr "aktivizo zgjerime arbitrare"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Krijim makefile-i dhe batchfile-i"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "krijo makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "mos krijo makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "krijo batchfile"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "mos krijo batchfile"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "përdor make-mode për Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "mos përdor make-mode për Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
-msgstr ""
+msgstr "Gjedhe projekti"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "drejtori gjedhesh për kartela gjedhe"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "përkufizoni një ndryshore gjedheje"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"quiet\" është specifikuar, por s’është specifikuar ndonjë \"projekt\" ose \"autor\"."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Gabim:shtegu i dhënë s’është drejtori, ose kartelat sphinx ekzistojnë tashmë."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart prodhon vetëm te një drejtori e zbrazët. Ju lutemi, specifikoni një shteg rrënjë të ri."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Ndryshore e pavlefshme gjedheje: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Titull i pavlefshëm: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "numri i specifikuar për rreshtin është jashtë intervali (1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "S’mund të përdoren në të njëjtën kohë të dyja mundësitë \"%s\" \"%s\""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
-msgstr ""
+msgstr "S’u gjet kartelë “include” %r, ose leximi i saj dështoi"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
-msgstr "Kodimi %r i përdorur për lexim të kartelës include %r duket të jetë i gabuar, provoni të jepni një mundësi :encoding:"
+msgstr "Kodimi %r i përdorur për lexim të kartelës “include” %r duket të jetë i gabuar, provoni të jepni një mundësi :encoding:"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objekti i emërtuar %r s’u gjet te kartelë include %r"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Autor ndarjeje: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Autor moduli: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Autor kodi: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr "Mundësia \":file:\" për direktivë csv-table tani njeh një shteg absolut si shteg relativ prej drejtorisë burim. Ju lutemi, përditësoni dokumentin tuaj."
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr "Deklarim C i përsëdytur, përkufizuar edhe te %s:%s.\nDeklarimi është '.. c:%s:: %s'."
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametra"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Kthime"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Lloj kthimi"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (funksion C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (anëtar C)"
-
-#: sphinx/domains/c.py:191
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C macro)"
-msgstr "%s (makro C)"
+msgid "%s (C %s)"
+msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (lloj C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "anëtar"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (ndryshore C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "ndryshore"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funksion"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "anëtar"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "ndryshore"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "bashkim"
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
-msgstr "përshkrim i përsëdytur objekti C i %s, tjetër instancë në %s, përdorni :noindex: për një prej tyre"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
+msgstr "lloj"
+
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr "parametër funksioni"
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Të reja në versionin %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Ndryshuar në versionin %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Nxjerrë nga përdorimi që me versionin %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "citim i përsëdytur %s, tjetër instancë te %s"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "Përmendja [%s] s’është në referencë."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "Deklarim i përsëdytur, i përcaktuar edhe te '%s'.\nDeklarimi është '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr "Deklarim C++ i përsëdytur, përkufizuar edhe te %s:%s.\nDeklarimi është '.. cpp:%s:: %s'."
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Parametra Gjedhesh"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klasë"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "koncept"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr ""
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "Deklarim i përsëdytur, i përcaktuar edhe te '%s'.\nEmri i deklarimit është '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr "parametër gjedheje"
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funksion i brendshëm)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metodë %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasë)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s ( ndryshore globale ose konstante)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argumente"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metodë"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "të dhëna"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "përshkrim %s i përsëdytur i %s, tjetër %s në %s"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "etiketë e përsëdytur ekuacioni %s, instancë tjetër te %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "math_eqref_format i pavlefshëm: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "fjalëkyç"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "përjashtim"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "deklarim"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "funksion i brendshëm"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Ndryshore"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (te moduli %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (ndryshore e brendshme)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (te moduli %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (ndryshore e brendshme)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (klasë e brendshme)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasë te %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (metodë %s.%s)"
+msgid "%s() (%s class method)"
+msgstr "%s() (metodë klase %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (metodë statike %s.%s)"
+msgid "%s() (%s property)"
+msgstr "%s() (veti %s)"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (metodë statike %s)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (metodë klase %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (metodë klase %s)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (atribut %s.%s)"
-
-#: sphinx/domains/python.py:709
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s property)"
-msgstr "%s() (veti %s)"
+msgid "%s (%s property)"
+msgstr "%s (veti %s)"
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Tregues Modulesh Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "module"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Nxjerrë nga përdorimi"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "metodë klase"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "metodë statike"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr "veti"
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "përshkrim i përsëdytur objekti për %s, instancë tjetër te %s, përdorni :noindex: për një prej tyre"
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
-msgstr ""
+msgstr "për ndërreferencën %r u gjet më shumë se një objektiv: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (nxjerrë nga përdorimi)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktivë)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (mundësi direktive)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktivë"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rol"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "përshkrim i përsëdytur %s %s, instancë tjetër te %s"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "ndryshore mjedisi; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Përshkrim i keqformuar mundësie %r, duhet të duket si \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" ose \"+opt args\""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr "Mundësi për rresht urdhrash %s"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr "mundësi për rresht urdhrash"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr "termi i fjalorthit duhet të paraprihet nga një rresht i zbrazët"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr "termat e fjalorthit s’duhet të paraprihet nga rreshta të zbrazët"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "fjalorthi duket të jetë i keformatuar, kontrolloni shmangie kryeradhe"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "term fjalorthi"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "etiketë reference"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "ndryshore mjedisi"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "mundësi programi"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Tregues Modulesh"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Faqe Kërkimesh"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "etiketë %s e përsëdytur, tjetër instancë te %s"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "përshkrim %s i përsëdytur për %s, tjetër instancë te %s"
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig është i çaktivizuar. :numref: është shpërfillur."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "s’është caktuar numër për %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "lidhja s’ka titull: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "numfig_format i pavlefshëm: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "numfig_format i pavlefshëm: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr "etiketë e papërcaktuar: %s"
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "formësim i ri"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "formësimi ndryshoi"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
-msgstr ""
+msgstr "zgjerimet u ndryshuan"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
-msgstr ""
+msgstr "version jo i tanishëm i mjedisit të montimit"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "drejtoria burim ka ndryshuar"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Ky mjedis është i papërputhshëm me montuesin e përzgjedhur, ju lutemi, zgjidhni një tjetër drejtori doctree."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "S’u arrit të skanohen dokumente te %s: %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Përkatësia %r s’është e regjistruar"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
-msgstr ""
+msgstr "U gjet “toctree” që i referohet vetes. U shpërfill."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "dokumenti s’është i përfshirë në ndonjë toctree"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "shihni %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "shihni edhe %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
-msgstr ""
+msgstr "lloj i panjohur zëri treguesi: %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simbole"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
-msgstr ""
+msgstr "u pikasën referenca rrethore toctree-je, po shpërfllen: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree përmban referencë ndaj dokumenti %r që s’ka titull: s’do të prodhohet ndonjë lidhje"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree përmban referencë ndaj dokumenti %r të përjashtuar"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree përmban referencë ndaj dokumenti %r që s’ekziston"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "kartelë figure jo e lexueshme: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "kartelë figure %s jo e lexueshme: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr "kartelë shkarkimi jo e lexueshme: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
-msgstr ""
+msgstr "Do të krijonte kartelë %s."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2382,185 +2404,205 @@ msgid ""
 "excluded from generation.\n"
 "\n"
 "Note: By default this script will not overwrite already created files."
-msgstr ""
+msgstr "\nShih në mënyrë rekursive te <MODULE_PATH> për module dhe\npaketa Python dhe krijo një kartelë reST me direktiva\nautomodulesh për paketë te <OUTPUT_PATH>.\n\n<EXCLUDE_PATTERN>s mund të jetë shprehje kartelash dhe/ose\ndrejtorish që mund të përjashtohen nga prodhimi.\n\nShënim: Si parazgjedhje, ky programth s’do të anashkalojë\nkartela të krijuara tashmë."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr "shteg për te modul për te dokumenti"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "kartelë fnmatch-style dhe/ose rregullsi drejtorish për t’u përjashtuar prej prodhimit"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr "drejtori ku të vendosen krejt përfundimet"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "thellësi maksimum nënmodulesh për shfaqje te TEL (parazgjedhje: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "mbishkruaj kartela ekzistuese"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "ndiq lidhje simbolike. E fuqishme, kur ndërthuret me collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "xhiroje programthin pa krijuar kartela"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr "vendose dokumentim për çdo modul në faqe më vete"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr "përfshi modulet \"_private\""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr "emër kartele për tryezën e lëndës (parazgjedhje: modules)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "mos krijo një kartelë tryeze lënde"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "mos krijo krye për paketat modul/paketë (për shembull, kur ato i përmban tashmë docstrings)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr "vendose dokumentimin e modulit përpara dokumentimit të nënmodulit"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interpreto shtigje modulesh sipas specifikimeve impicite PEP-0420 për emërhapësira"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "prapashtesë kartele (parazgjedhje: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr "prodho me sphinx-quickstart një projekt të plotë"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "shto module_path pas sys.path, e përdorur kur është dhënë --full"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr "emër projekti (parazgjedhje: emër moduli rrënjë)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr "autor(ë) projekti, e përdorur kur është dhënë --full"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr "version projekti, e përdorur kur është dhënë --full"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "hedhje në qarkullim e projektit, e përdorur kur është dhënë --full, si parazgjedhje merr --doc-version"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "mundësi zgjatimi"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s s’është drejtori."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "shprehje e rregullt e pavlefshme %r te %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Testimi i mbulimit te burimet përfundoi, shihni te përfundimet në %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "shprehje e rregullt %r e pavlefshme te coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr "API C e padokumentuar: %s [%s] te kartela %s"
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "moduli %s s’u importua dot: %s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr "funksion python i padokumentuar: %s :: %s"
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr "klasë python e padokumentuar: %s :: %s"
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr "metodë python e padokumentuar: %s :: %s :: %s"
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "mungon '+' ose '-' te mundësia '%s'."
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' s’është mundësi e vlefshme."
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' s’është mundësi pyversion e vlefshme"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "lloj TestCode i pavlefshëm"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Testimi i doctests-eve te burimet përfundoi, shihni te përfundimet në %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
-msgstr ""
+msgstr "s’ka kod/dhënie te blloku %s në %s:%s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
-msgstr ""
+msgstr "po shpërfillet kod “doctest” i pavlefshëm: %r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "=================== kohëzgjatjet më të ngadalta të leximit ==================="
 
 #: sphinx/ext/graphviz.py:132
 msgid "Graphviz directive cannot have both content and a filename argument"
-msgstr ""
+msgstr "Një direktivë Graphviz s’mund të ketë edhe lëndë, edhe argument emri kartelash"
 
 #: sphinx/ext/graphviz.py:142
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
-msgstr ""
+msgstr "S’u gjet kartelë e jashtme Graphviz %r, ose dështoi leximi i saj"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
-msgstr ""
+msgstr "Po shpërfillet direktivë “graphviz” pa lëndë."
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2568,16 +2610,16 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "dot s’prodhoi kartelë përfundim:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
-msgstr ""
+msgstr "urdhri dot %r s’mund të xhirohet (i nevojshëm për çka prodhon graphviz), kontrolloni rregullimin graphviz_dot"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2585,32 +2627,33 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "dot përfundoi me gabim:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
-msgstr ""
+msgstr "graphviz_output_format duhet të jetë një nga 'png', 'svg', por është %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
-msgstr ""
+msgstr "kod dot %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[grafik: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[grafik]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr ""
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
+msgstr "s’mund të xhirohet urdhër shndërrimi %r, kontrolloni rregullimin image_converter: %s"
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
 #, python-format
@@ -2620,150 +2663,160 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "shndërrimi përfundoi me gabimin:\n[stderr]\n%r\n[stdout]\n%r"
+
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "s’mund të xhirohet urdhër shndërrimi %r, kontrolloni rregullimin image_converter"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "Urdhri LaTeX %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_late"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "Urdhri %s %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_%s"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Permalidhje te ky ekuacion"
 
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
-msgstr ""
+msgstr "inventari intersphinx është lëvizur: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
-msgstr ""
+msgstr "po ngarkohet inventari intersphinx prej %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 ""
+msgstr "u hasën disa probleme me disa nga inventare, por kishin alternativa funksionale:"
 
-#: sphinx/ext/intersphinx.py:224
+#: sphinx/ext/intersphinx.py:225
 msgid "failed to reach any of the inventories with the following issues:"
-msgstr ""
+msgstr "s’u arrit të kapej ndonjë inventar me problemet vijuese:"
 
-#: sphinx/ext/intersphinx.py:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(te %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(te %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
-msgstr ""
+msgstr "identifikuesi intersphinx %r s’është varg. U shpërfill"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
-msgstr ""
+msgstr "S’u arrit të lexohej intersphinx_mapping[%s], u shpërfill: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[burim]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
-msgstr ""
+msgstr "Për T’u Bërë"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
-msgstr ""
+msgstr "U gjet zë Për T’u Bërë: %s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
-msgstr ""
+msgstr "<<zëri origjinal>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> gjendet te %s, rreshti %d.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
-msgstr ""
+msgstr "zëri origjinal"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
-msgstr ""
+msgstr "po theksohet kod moduli… "
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[dokumente]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Kod moduli"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kod burim për %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Përmbledhje: kod moduli"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Krejt modulet për të cilët ka kod të gatshëm</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr "vlerë e pavlefshme mundësie për member-order: %s"
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "nënshkrim i pavlefshëm për auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "gabim gjatë formatimi argumentesh për %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "atribut %s që mungon te objekt %s"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autodoc: s’u arrit të përcaktohet %r për dokumentim, u shfaq përjashtimi vijues:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr "s’dihet cili modul të importohet për vetëdokumentim të %r (provoni të vendosni te dokumenti një direktivë \"module\" ose \"currentmodule\", ose të jepni shprehimisht një emër moduli)"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr "gabim gjatë formatimi nënshkrimesh për %s: %s"
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" në emër automoduli nuk ka kuptim"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
-msgstr ""
+msgstr "__all__ should duhet të jetë një listë vargjesh, jo %r (në module %s) -- ignoring __all__"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr ""
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr "u përmend atribut që mungon në :members: mundësi: modul %s, atributi %s"
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr "S’u arrit të merret një nënshkrim funksioni për %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr "S’u arrit të merrej nënshkrim konstruktori për %s: %s"
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
-msgstr ""
+msgstr "Baza: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias i :class:`%s`"
+msgid "alias of %s"
+msgstr "alias për %s"
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr "alias për TypeVar(%s)"
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr "S’u arrit të merre një nënshkrim metode për %s: %s"
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr "U gjet __slots__ i pavlefshëm në %s. U shpërfill."
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr "autodoc_member_order tani pranon \"alphabetical\", në vend se \"alphabetic\". Ju lutemi, përditësoni rregullimin tuaj."
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr "S’u arrit të përtypej një vlerë parazgjedhje argumenti për %r: %s"
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr "S’u arrit të përditësohet nënshkrim për %r: s’u gjet parametër: %s"
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "S’u arrit të përtypet type_comment për %r: %s"
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "s’u arrit të importohej %s"
+msgid "autosummary: failed to import %s"
+msgstr "vetëpërmbledhje: s’u arrit të importohej %s"
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr "s’u arrit të përtypej emri %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "s’u arrit të importohej objekti %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: s’u gjet kartelë: %s"
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
-msgstr ""
+msgstr "vetëpërmbledhja prodhon së brendshmi kartela .rst. Por source_suffix juaj s’përmban .rst. U anashkalua."
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "vetëpërmbledhje: s’u arrit të përcaktohet %r për t’u dokumentuar, u shfaq përjashtimi vijues:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
-msgstr ""
+msgstr "[vetëpërmbledhje] prodhim vetëpërmbledhje për: %s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[vetëpërmbledhje] po shkruhet te %s"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr "[vetëpërmbledhje] s’u arrit të importohej %r: %s"
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2881,109 +2987,133 @@ msgid ""
 "``sphinx.ext.autosummary`` Python module and can be read using::\n"
 "\n"
 "  pydoc sphinx.ext.autosummary\n"
-msgstr ""
+msgstr "\nProdhoni ReStructuredText duke përdorur direktiva vetëpërmbledhje.\n\nsphinx-autogen është një ndërfaqe pamore për sphinx.ext.autosummary.generate. Prodhon\nkartela reStructuredText nga direktiva vetëpërmbledhjeje që përmbahen te\nkartelat e dhëna.\n\nFormati i direktivës vetëpërmbledhje dokumentohet te\nmoduli Python ``sphinx.ext.autosummary`` dhe mund të lexohet duke përdorur::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "kartela burim për të cilat të krijohen kartela rST"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "drejtori ku të vendosen krejt përfundimet"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "prapashtesë parazgjedhje për kartela (parazgjedhje: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "drejtori gjedhesh vetjake (parazgjedhje: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
-msgstr ""
+msgstr "pjesë të importuara të dokumentit (parazgjedhje: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "Argumente Fjalëkyçi"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Shembull"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Shembuj"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Shënime"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Parametra të Tjerë"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "Referenca"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
-msgstr ""
+msgstr "Sinjalizime"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr "u caktua vlerë e pavlefshme (mungon kllapë mbyllëse): %s"
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr "u caktua vlerë e pavlefshme (mungon kllapë hapëse): %s"
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr "shprehje vargu e keqformuar (mungon thonjëz mbyllëse): %s"
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr "shprehje vargu e keqformuar (mungon thonjëz hapëse): %s"
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Vëmendje"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Kujdes"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Rrezik"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Gabim"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Ndihmëz"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "E rëndësishme"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Shënim"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Shihni edhe"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Ndihmëz"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Sinjalizim"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "vazhduar nga faqja e mëparshme"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "vazhdon në faqen pasuese"
@@ -3000,181 +3130,181 @@ msgstr "Numra"
 msgid "page"
 msgstr "faqe"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "Tryeza e Lëndës"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
-msgstr ""
+msgstr "Kērko"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
-msgstr ""
+msgstr "Shko"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Shfaq Burimin"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Përmbledhje"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Mirë se vini! Ky është"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "dokumentimi për"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "përditësuar së fundi më"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Tregues dhe tabela:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Tryezë e Plotë e Lëndës"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "paraqet krejt ndarjet dhe nënndarjet"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "kërkoni te ky dokumentim"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Tregues Global Modulesh"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "hyrje e shpejtë te krejt modulet"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "krejt funksionet, klasat, termat"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Tregues &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Tregues i plotë në një faqe"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Faqe treguesi sipas shkronjash"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "mund të jetë i stërmadh"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Lëvizje"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Kërkoni brenda %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Mbi këto dokumente"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Të drejta kopjimi"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Të drejta kopjimi</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Të drejta kopjimi %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Përditësuar së fundi më %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr ""
+msgstr "Krijuar duke përdorur <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Kërkoni te %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Subjekti i mëparshëm"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "kapitulli i mëparshëm"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Subjekti pasues"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "kapitulli pasues"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
-msgstr ""
+msgstr "Që të aktivizohet funksioni i kërkimit, ju lutemi, aktivizoni\n    JavaScript-in."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
-msgstr ""
+msgstr "Kërkimi për disa fjalë njëherësh shfaq vetëm përputhje që\n    përmbajnë krejt fjalët."
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "kërko"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Përfundime Kërkimi"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
-msgstr ""
+msgstr "Kërkimi juaj s’gjeti përputhje me ndonjë dokument. Ju lutemi, sigurohuni se janë shkruar saktë krejt fjalët dhe se keni përzgjedhur aq kategori sa duhen."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Kërkim i shpejtë"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Kjo Faqe"
 
@@ -3182,7 +3312,7 @@ msgstr "Kjo Faqe"
 #: sphinx/themes/basic/changes/versionchanges.html:12
 #, python-format
 msgid "Changes in Version %(version)s &#8212; %(docstitle)s"
-msgstr ""
+msgstr "Ndryshe në Versionin %(version)s &#8212; %(docstitle)s"
 
 #: sphinx/themes/basic/changes/rstsource.html:5
 #, python-format
@@ -3192,7 +3322,7 @@ msgstr "%(filename)s &#8212; %(docstitle)s"
 #: sphinx/themes/basic/changes/versionchanges.html:17
 #, python-format
 msgid "Automatically generated list of changes in version %(version)s"
-msgstr ""
+msgstr "Listë ndryshime në versionin %(version)s e prodhuar automatikisht"
 
 #: sphinx/themes/basic/changes/versionchanges.html:18
 msgid "Library changes"
@@ -3206,38 +3336,38 @@ msgstr "Ndryshime API C"
 msgid "Other changes"
 msgstr "Ndryshime të tjera"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Permalidhje te ky titull"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Permalidhje për te ky përkufizim"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Fshih Përputhje Kërkimi"
 
 #: sphinx/themes/basic/static/searchtools.js:136
 msgid "Searching"
-msgstr ""
+msgstr "Kërkim"
 
 #: sphinx/themes/basic/static/searchtools.js:141
 msgid "Preparing search..."
 msgstr "Po përgatitet kërkim..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
+msgstr "Kërkimi përfundoi, u gjetën %s page(s) me përputhje me shprehjen e kërkuar."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
-msgstr ""
+msgstr ", në "
 
 #: sphinx/themes/classic/static/sidebar.js_t:83
 msgid "Expand sidebar"
@@ -3248,7 +3378,7 @@ msgstr "Zgjeroje anështyllën"
 msgid "Collapse sidebar"
 msgstr "Tkurre anështyllën"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Lëndë"
 
@@ -3256,7 +3386,7 @@ msgstr "Lëndë"
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
-msgstr ""
+msgstr "U gjet tregues me bazë 4 shtylla. Mund të jetë një e metë e zgjerimeve që përdorni: %r"
 
 #: sphinx/transforms/__init__.py:263
 #, python-format
@@ -3267,199 +3397,207 @@ msgstr "Poshtëshënimi [%s] s’është në referencë."
 msgid "Footnote [#] is not referenced."
 msgstr "Poshtëshënimi [#] s’është në referencë."
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
-msgstr ""
+msgstr "referenca pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
-msgstr ""
+msgstr "referenca pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
-msgstr ""
+msgstr "referenca citimi pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
+msgstr "referenca citimi pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}"
+
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
-msgstr ""
+msgstr "u gjet më shumë se një objektiv për ndërreferencën 'any' %r: mund të ishte %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr ""
+msgid "%s:%s reference target not found: %s"
+msgstr "s’u gjet objektiv reference %s:%s: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr ""
+msgid "%r reference target not found: %s"
+msgstr "s’u gjet objektiv reference %r: %s"
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "S’u pru dot figurë e largët: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
-msgstr ""
+msgstr "S’u soll dot figurë e largët: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Format i panjohur figure: %s…"
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "shenja burimi të padeshifrueshme, po zëvendësohen me \"?\": %r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
-msgstr ""
+msgstr "e anashkaluar"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
-msgstr ""
+msgstr "e dështuar"
+
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr "emër direktive ose roli të panjohur: %s:%s"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "gabim leximi: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "gabim shkrimi: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Format i pavlefshëm datash. Quote the string by single quote Nëse doni të jepet drejtpërsëdrejti, përdorni për vargun thonjëza njëshe: %s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
-msgstr ""
+msgstr "“toctree” përmban referencë për te një kartelë joekzistuese %r"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
-msgstr ""
-
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
+msgstr "përjashtim teksa vlerësohej vetëm shprehje direktive: %s"
 
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "s’u gjet rol parazgjedhje %s"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format s’është i përcaktuar për %s"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Çfarëdo ID-sh jo të përshoqëruara për nyjën %s"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr "Permalidhje për te ky term"
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Permalidhje te kjo tabelë"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Permalidhje te ky kod"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Permalidhje te kjo figurë"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Permalidhje te kjo toctree"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "S’u mor dot madhësi figure. Mundësia :scale: u shpërfill."
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "toplevel_sectioning %r i panjohur për klasën %r"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: shumë i madh, u shpërfill."
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr "titulli i dokumentit s’është nyje njëshe Teksti"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "u has nyje titulli jo në ndarje, temë, tabelë, paralajmërim ose anështyllë"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Poshtëshënime"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
-msgstr ""
+msgstr "janë dhënë që të dyja mundësitë, “tabularcolumns” dhe “:widths:”. shpërfillet :widths:."
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "njësia e përmasave %s është e pavlefshme. U shpërfill."
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
-msgstr ""
+msgstr "u gjet lloj i panjohur %s zërash treguesi"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[figurë: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[figurë]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "titull jo brenda një figure."
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "lloj nyjeje i pasendërtuar: %r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr "lloj i panjohur nyjeje: %r"
diff --git a/sphinx/locale/sr/LC_MESSAGES/sphinx.po b/sphinx/locale/sr/LC_MESSAGES/sphinx.po
index 2bcfcf51cf8..d1cd2f0644e 100644
--- a/sphinx/locale/sr/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sr/LC_MESSAGES/sphinx.po
@@ -1,148 +1,154 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Risto Pejasinovic <risto.pejasinovic@gmail.com>, 2019
+# Vladimir Milovanović <vmilovanovic@gmail.com>, 2020
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Serbian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: sr\n"
 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "Конфигурациони директоријум не садржи conf.py датотеку (%s)."
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Нема изворног директоријума (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Изворни и одредишни директоријум не могу бити једнаки"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Покрећем Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Овај пројекат захтева верзију Sphinx v%s или већу, не може се изградити инсталираном верзијом."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
-msgstr ""
+msgstr "учитавање превода [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
-msgstr "Готово"
+msgstr "готово"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "Неуспешно: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
-msgstr "Успешно"
+msgstr "успешно"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
-msgstr ""
+msgstr "са грешкама"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +156,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +169,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +229,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
-msgstr ""
+msgstr "Одељак %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
-msgstr ""
+msgstr "Сл. %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Табела %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
-msgstr ""
+msgstr "Списак %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +281,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
-msgstr ""
+msgstr "Догађај %r већ постоји"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
+msgstr "Непознат догађај: %s"
+
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
-msgstr ""
+msgstr "Преводилац за %r већ постоји"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
-msgstr ""
+msgstr "све изворне датотеке"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
-msgstr ""
+msgstr "ажурирање окружења: "
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
-msgstr ""
+msgstr "припремање докумената"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
-msgstr ""
+msgstr "пребацивање слика... "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
-msgstr ""
+msgstr "пребацивање изворних датотека..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +713,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
-msgstr ""
+msgstr " (у "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +880,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +906,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
-msgstr ""
+msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
-msgstr ""
+msgstr "индекс"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
-msgstr ""
+msgstr "напред"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
-msgstr ""
+msgstr "назад"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
-msgstr ""
+msgstr "документација %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
-msgstr ""
+msgstr "LaTeX датотеке су у %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
-msgstr ""
+msgstr "\nПокрените 'make' у том директоријуму да бисте их пропустили кроз (pdf)latex\n(или употребите `make latexpdf' овде да се то одради аутоматски)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
-msgstr ""
+msgstr "Индекс"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
-msgstr ""
+msgstr "Издање"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
-msgstr ""
+msgstr "За више информација, посетите <http://sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1220,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
-msgstr ""
+msgstr "Име пројекта"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
-msgstr ""
+msgstr "Име(на) аутора"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1493,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
-msgstr ""
+msgstr "Верзија пројекта"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
-msgstr ""
+msgstr "Издање пројекта"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1511,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
-msgstr ""
+msgstr "Језик пројекта"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
-msgstr ""
+msgstr "Суфикс изворне датотеке"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1533,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1627,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
-msgstr ""
+msgstr "име пројекта"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
-msgstr ""
+msgstr "имена аутора"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
-msgstr ""
+msgstr "верзија пројекта"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
-msgstr ""
+msgstr "издање пројекта"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
-msgstr ""
+msgstr "језик пројекта"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
-msgstr ""
+msgstr "суфикс изворне датотеке"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
-msgstr ""
+msgstr "користи epub"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
-msgstr ""
+msgstr "Аутор одељка: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
-msgstr ""
+msgstr "Аутор модула: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
-msgstr ""
+msgstr "Аутор кода: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
+msgstr "Аутор: "
+
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
+msgstr "%s %s"
+
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
-msgstr ""
+msgstr "Параметри"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
-msgstr ""
+msgstr "Резултат"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
-msgstr ""
+msgstr "Тип резултата"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr ""
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "променљива"
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr ""
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
+msgstr "функција"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr ""
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
+msgstr "тип"
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
-msgstr ""
+msgstr "Додато у верзији %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
-msgstr ""
+msgstr "Измењено у верзији %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
-msgstr ""
+msgstr "Застарело почевши од верзије %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
-msgstr ""
+msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
+msgstr "класа"
 
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
-msgstr ""
+msgstr "%s() (уграђена функција)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
-msgstr ""
+msgstr "%s() (%s метода)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
-msgstr ""
+msgstr "%s() (класа)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
-msgstr ""
+msgstr "%s (глобална променљива или константа)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
-msgstr ""
+msgstr "%s (атрибут %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
-msgstr ""
+msgstr "Аргументи"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
-msgstr ""
+msgstr "%s (модул)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
-msgstr ""
+msgstr "метода"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
-msgstr ""
+msgstr "атрибут"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
-msgstr ""
+msgstr "модул"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
-msgstr ""
+msgstr "кључна реч"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
-msgstr ""
+msgstr "оператор"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
-msgstr ""
+msgstr "објекат"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
-msgstr ""
+msgstr "изузетак"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
-msgstr ""
+msgstr "наредба"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
-msgstr ""
+msgstr "уграђена функција"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
-msgstr ""
+msgstr "Променљиве"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
-msgstr ""
+msgstr "%s() (у модулу %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
-msgstr ""
+msgid "%s (in module %s)"
+msgstr "%s (у модулу %s)"
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
-msgstr ""
+msgid "%s (built-in variable)"
+msgstr "%s (уграђена променљива)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
-msgstr ""
+msgstr "%s (уграђена класа)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
-msgstr ""
+msgstr "%s (класа у %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr ""
+msgid "%s() (%s class method)"
+msgstr "%s() (метода класе %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
-msgstr ""
-
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
+msgstr "%s() (статичка метода %s)"
 
-#: sphinx/domains/python.py:709
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
-msgstr ""
+msgstr "модули"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
-msgstr ""
+msgstr "Застарело"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
-msgstr ""
+msgstr "метода класе"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
+msgstr "статичка метода"
+
+#: sphinx/domains/python.py:1098
+msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
-msgstr ""
+msgstr "директива"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
-msgstr ""
+msgstr "променљива окружења; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
-msgstr ""
+msgstr "документ"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
-msgstr ""
+msgstr "погледајте %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
-msgstr ""
+msgstr "такође погледајте %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
-msgstr ""
+msgstr "Симболи"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2408,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
-msgstr ""
+msgstr "суфикс датотеке (подразумевани: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2600,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2614,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2631,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2667,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
-msgstr ""
+msgstr "(у %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
-msgstr ""
+msgstr "(у %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
-msgstr ""
+msgstr "[изворни код]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
-msgstr ""
+msgstr "План"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
-msgstr ""
+msgstr "[документација]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
-msgstr ""
+msgstr "Код модула"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
-msgstr ""
+msgstr "<h1>Изворни код %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
-msgstr ""
+msgstr "Преглед: код модула"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2826,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,110 +2991,134 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
-msgstr ""
+msgstr "Пример"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
-msgstr ""
+msgstr "Примери"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
-msgstr ""
+msgstr "Белешке"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
-msgstr ""
+msgstr "Упозорења"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
-msgid "Attention"
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
-msgid "Caution"
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
-msgid "Danger"
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
+#: sphinx/locale/__init__.py:252
+msgid "Attention"
+msgstr "Пажња"
+
 #: sphinx/locale/__init__.py:253
-msgid "Error"
+msgid "Caution"
 msgstr ""
 
 #: sphinx/locale/__init__.py:254
-msgid "Hint"
+msgid "Danger"
 msgstr ""
 
 #: sphinx/locale/__init__.py:255
-msgid "Important"
-msgstr ""
+msgid "Error"
+msgstr "Грешка"
 
 #: sphinx/locale/__init__.py:256
-msgid "Note"
-msgstr ""
+msgid "Hint"
+msgstr "Путоказ"
 
 #: sphinx/locale/__init__.py:257
+msgid "Important"
+msgstr "Важно"
+
+#: sphinx/locale/__init__.py:258
+msgid "Note"
+msgstr "Белешка"
+
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
-msgstr ""
+msgstr "Савет"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
-msgstr ""
+msgstr "Упозорење"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
-msgstr ""
+msgstr "настављено са претходне стране"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
-msgstr ""
+msgstr "наставак на следећој страни"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:10
 msgid "Non-alphabetical"
@@ -2995,130 +3126,130 @@ msgstr ""
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:12
 msgid "Numbers"
-msgstr ""
+msgstr "Бројеви"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:13
 msgid "page"
-msgstr ""
+msgstr "страна"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
-msgstr ""
+msgstr "Садржај"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
-msgstr ""
+msgstr "Претрага"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
-msgstr ""
+msgstr "Тражи"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
-msgstr ""
+msgstr "Изворни код"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
-msgstr ""
+msgstr "Преглед"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
-msgstr ""
+msgstr "Добро дошли! Ово је"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
-msgstr ""
+msgstr "документација"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
-msgstr ""
+msgstr "последња измена"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Навигација"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3127,68 +3258,68 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
-msgstr ""
+msgstr "Претходни одељак"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "претходна глава"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
-msgstr ""
+msgstr "Следећи одељак"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "наредна глава"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
-msgstr ""
+msgstr "тражи"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
-msgstr ""
+msgstr "Резултати претраге"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
-msgstr ""
+msgstr "Брза претрага"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
-msgstr ""
+msgstr "Ова страница"
 
 #: sphinx/themes/basic/changes/frameset.html:5
 #: sphinx/themes/basic/changes/versionchanges.html:12
 #, python-format
 msgid "Changes in Version %(version)s &#8212; %(docstitle)s"
-msgstr ""
+msgstr "Измене у верзији %(version)s &#8212; %(docstitle)s"
 
 #: sphinx/themes/basic/changes/rstsource.html:5
 #, python-format
 msgid "%(filename)s &#8212; %(docstitle)s"
-msgstr ""
+msgstr "%(filename)s &#8212; %(docstitle)s"
 
 #: sphinx/themes/basic/changes/versionchanges.html:17
 #, python-format
@@ -3197,7 +3328,7 @@ msgstr ""
 
 #: sphinx/themes/basic/changes/versionchanges.html:18
 msgid "Library changes"
-msgstr ""
+msgstr "Измене у библиотеци"
 
 #: sphinx/themes/basic/changes/versionchanges.html:23
 msgid "C API changes"
@@ -3205,40 +3336,40 @@ msgstr ""
 
 #: sphinx/themes/basic/changes/versionchanges.html:25
 msgid "Other changes"
-msgstr ""
+msgstr "Друге измене"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
 #: sphinx/themes/basic/static/searchtools.js:136
 msgid "Searching"
-msgstr ""
+msgstr "Претражује се"
 
 #: sphinx/themes/basic/static/searchtools.js:141
 msgid "Preparing search..."
-msgstr ""
+msgstr "Припрема претраге..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
-msgstr ""
+msgstr ", у "
 
 #: sphinx/themes/classic/static/sidebar.js_t:83
 msgid "Expand sidebar"
@@ -3249,9 +3380,9 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
-msgstr ""
+msgstr "Садржај"
 
 #: sphinx/transforms/__init__.py:224
 #, python-format
@@ -3268,199 +3399,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
-msgstr ""
+msgstr "[слика: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
-msgstr ""
+msgstr "[слика]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po b/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po
index 574d218de8d..e530fd2bfb4 100644
--- a/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Serbian (Latin) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr@latin/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: sr@latin\n"
 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,124 +3130,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3126,55 +3256,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3206,19 +3336,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po b/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po
index 3e7ac5ba491..25f56b4b466 100644
--- a/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Serbian (Serbia) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr_RS/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: sr_RS\n"
 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,124 +3130,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3126,55 +3256,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3206,19 +3336,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/sv/LC_MESSAGES/sphinx.po b/sphinx/locale/sv/LC_MESSAGES/sphinx.po
index af26ab2f1a1..f9b67d08ed2 100644
--- a/sphinx/locale/sv/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sv/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Swedish (http://www.transifex.com/sphinx-doc/sphinx-1/language/sv/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: sv\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Inbyggda"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Modulnivå"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(i "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Huvudindex"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "nästa"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "föregående"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Utgåva"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Sektionsförfattare"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Modulförfattare"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Källkodsförfattare"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Upphovsman:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametrar"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Returnerar"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Returtyp"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C-funktion)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C-medlem)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C-makro)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C-typ)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "medlem"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C-variabel)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "variabel"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "funktion"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "medlem"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "typ"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "variabel"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Nyheter i version %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Förändrat i version %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Ersatt sedan version %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Kastar"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "klass"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (inbyggd funktion)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metod)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klass)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (global variabel eller konstant)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribut)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Argument"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "metod"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "attribut"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "nyckelord"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "undantag"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "uttryck"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "inbyggda funktioner"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Variabler"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Väcker"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (i modul %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (inbyggd variabel)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (i modul %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (inbyggd variabel)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (inbyggd klass)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klass i %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s metod)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s klassmetod)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s statisk metod)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statisk metod)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s klassmetod)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s klassmetod)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s attribut)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python Modulindex"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "moduler"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Ersatt"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "klassmetod"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "statisk metod"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiv)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (roll)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "direktiv"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "roll"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "miljövariabel; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "ordlista"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "grammatisk token"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "referensetikett"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "miljövariabel"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "programväxel"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Modulindex"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Söksida"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "se %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "se även %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[source]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Att göra"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "ursprungsvärde"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Modulkällkod"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Källkod för %s</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Översikt: modulkällkod"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alla moduler där källkod finns</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "alias för :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Uppmärksamma"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Varning"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Risk"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Fel"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Råd"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Viktigt"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Observera"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Se även"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tips"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Varning"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "fortsättning från föregående sida"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,181 +3130,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Sök"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Gå"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Visa källfil"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Översikt"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Index och tabeller"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Komplett Innehållsförteckning"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "lista över alla paragrafer och underparagrafer"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "sök i det här dokumentet"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Global Modulindex"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "genväg till alla moduler"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "alla funktioner, klasser, villkor"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Index &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Hela innehållsförteckningen på en sida"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Innehållsförteckning per inledande bokstav"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "kan bli stort"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Navigation"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Sök bland %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Om dessa dokument"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Senast uppdaterad %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Skapad med <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Sök %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Föregående titel"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "Föregående kapitel"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Nästa titel"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "Nästa kapitel"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Var god aktivera JavaScript för sökfunktionalitet."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "sök"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Sökresultat"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Snabbsök"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Denna Sida"
 
@@ -3206,19 +3336,19 @@ msgstr "Förändringar i C-API"
 msgid "Other changes"
 msgstr "Övriga förändringar"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Permalink till denna rubrik"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Permalink till denna definition"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Dölj Sökresultat"
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr "Expandera sidolist"
 msgid "Collapse sidebar"
 msgstr "Dölj sidolist"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Innehåll"
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Fotnoter"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[image]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/ta/LC_MESSAGES/sphinx.po b/sphinx/locale/ta/LC_MESSAGES/sphinx.po
index cc19b6dfaf3..d3dafb1fd43 100644
--- a/sphinx/locale/ta/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ta/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Julien Malard <julien.malard@mail.mcgill.ca>, 2019
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Tamil (http://www.transifex.com/sphinx-doc/sphinx-1/language/ta/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: ta\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "%d கண்டு ப்பிடித்த விட்டது"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "அடுத்த"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,124 +3131,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3127,55 +3257,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3207,19 +3337,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/te/LC_MESSAGES/sphinx.po b/sphinx/locale/te/LC_MESSAGES/sphinx.po
index 32c1fc59eaa..43d8fd3a730 100644
--- a/sphinx/locale/te/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/te/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Telugu (http://www.transifex.com/sphinx-doc/sphinx-1/language/te/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: te\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,124 +3130,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3126,55 +3256,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3206,19 +3336,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/tr/LC_MESSAGES/sphinx.po b/sphinx/locale/tr/LC_MESSAGES/sphinx.po
index b37c18d50f3..d942c115cda 100644
--- a/sphinx/locale/tr/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/tr/LC_MESSAGES/sphinx.po
@@ -1,150 +1,156 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # BouRock, 2020
 # Fırat Özgül <ozgulfirat@gmail.com>, 2013-2016
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2011
+# tamer ba <tamerb2050@gmail.com>, 2020
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-21 09:56+0000\n"
-"Last-Translator: BouRock\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Turkish (http://www.transifex.com/sphinx-doc/sphinx-1/language/tr/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: tr\n"
 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "config dizini bir conf.py dosyası içermiyor (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Kaynak dizin bulunamıyor (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Kaynak dizin ve hedef dizin aynı olamaz"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx s%s çalışıyor"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
-msgstr "Güvenlik nedeni ile macOS ve python 3.8 ve üzerinde paralel kip etkisizleştirildi. Daha fazla bilgi için lütfen https://github.com/sphinx-doc/sphinx/issues/6803 adresindekileri okuyun"
+msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Bu proje en az Sphinx s%s gerektirir ve bu nedenle bu sürüm ile oluşturulamaz."
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "çıktı dizini yapılıyor"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "%s uzantısı ayarlanırken:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "Şu anda conf.py dosyasında tanımlanan 'kurulum' çağrılabilir bir Python değil. Lütfen tanımını çağrılabilir bir işlev yapmak için değiştirin. Bunun, Sphinx uzantısı gibi davranması için conf.py dosyasına ihtiyacı vardır."
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "çeviriler yükleniyor [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "bitti"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "yerleşik iletiler için kullanılamaz"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
-msgstr "salamura ortamı yükleniyor"
+msgstr "derin temizlenen ortam yükleniyor"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "başarısız olan: %s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "Seçilen oluşturucu yok, varsayılan kullanılıyor: html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "başarılı oldu"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "sorunlarla tamamlandı"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "yapım %s, %s uyarı (hata olarak kabul edilen uyarılarla)."
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "yapım %s, %s uyarı (hatalar olarak kabul edilen uyarılarla)."
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "yapım %s, %s uyarı."
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "yapım %s, %s uyarı."
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "yapım %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "düğüm sınıfı %r zaten kayıtlı, ziyaretçileri geçersiz kılınacaktır"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "yönerge %r zaten kayıtlı, geçersiz kılınacaktır"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "rol %r zaten kayıtlı, geçersiz kılınacaktır"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -152,12 +158,12 @@ msgid ""
 "explicit"
 msgstr "%s uzantısı paralel okuma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "%s uzantısı paralel okuma için güvenli değil"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -165,59 +171,59 @@ msgid ""
 "explicit"
 msgstr "%s uzantısı paralel yazma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "%s uzantısı paralel yazma için güvenli değil"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "%s seri nosu yapılıyor"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "sözlük yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor (tek tek öğeleri ayarlamak için %r kullanın)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "geçersiz sayı %r; yapılandırma değeri %r için; yoksayılıyor"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "desteklenmeyen tür ile yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "geçersiz kılmada bilinmeyen yapılandırma değeri %r, yoksayılıyor"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "Böyle bir yapılandırma değeri yok: %s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "Yapılandırma değeri %r zaten mevcut"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Yapılandırma dosyanızda bir sözdizimi hatası var: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Yapılandırma dosyası (veya içe aktarılan modüllerden biri) sys.exit() olarak adlandırılır"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -225,58 +231,51 @@ msgid ""
 "%s"
 msgstr "Yapılandırma dosyanızda programlanabilir bir hata var:\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "'source_suffix' yapılandırma değeri bir dizgi, dizgiler listesi ya da sözlük bekler. Ama '%r' verilir."
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "Bölüm %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "Şekil %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "Tablo %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "Listeleme %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "`{name}` yapılandırma değeri, {candidates} geğerlrinden biri olmak zorundadır, ancak `{current}` değeridir."
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "`{name}' yapılandırma değeri `{current.__name__}' türüne sahip; beklenen {permitted}."
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "`{name}' yapılandırma değeri `{current.__name__}' türüne sahip, vassayılanları `{default.__name__}'."
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "Yapılandırma değeri %r, ASCII olmayan karakterlere sahip bir dizgiye ayarlı; bu, Evrensel kod hatalarını meydana gertirmesine neden olabilir. Lütfen Evrensel kod dizgilerini kullanın, örn. %r."
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -284,405 +283,430 @@ msgstr "primary_domain %r bulunamadı, yoksayıldı."
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "s2.0 sürümünden bu yana, Sphinxi varsayılanı master_doc olarak \"index\" kullanır. Lütfen conf.py dosyanıza \"master_doc = 'contents'\" parametresini ekleyin."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "Olay %r zaten mevcut"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Bilinmeyen olay adı: %s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "%s uzantısı needs_extensions ayarları tarafından gereklidir, ancak yüklü değildir."
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Bu projenin %s uzantısına ve en az %s sürümüne ihtiyacı vardır ve bu nedenle yüklenen sürümle oluşturulamaz (%s)."
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Pygments lexer adı %r bilinmiyor"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "\"%s\" olarak literal_block lex yapılamadı. Vurgulama atlandı."
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "belge okunabilir değil. Yoksayıldı."
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Oluşturucu sınıfı %s \"ad\" özniteliğine sahip değil"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Oluşturucu %r zaten mevcut (%s modülünde)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Oluşturucu adı %s kayıtlı veya giriş noktası aracılığıyla kullanılabilir değil"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Oluşturucu adı %s kayıtlı değil"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "etki alanı %s zaten kayıtlı"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "etki alanı %s henüz kayıtlı değil"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "%r yönergesi zaten %s etki alanına kayıtlı"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "%r rolü zaten %s etki alanına kayıtlı"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "%r dizini zaten %s etki alanına kayıtlı"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "%r object_type zaten kayıtlı"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "%r crossref_type zaten kayıtlı"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r zaten kayıtlı"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "%r için source_parser zaten kayıtlı"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "%s için kaynak ayrıştırıcı kayıtlı değil"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "%r için çevirmen zaten mevcut"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node() için kwargs bir (visit, depart) tanımlama grubu işlevi olmak zorundadır: %r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r zaten kayıtlı"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "matematik işleyici %s zaten kayıtlı"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "%r uzantısı zaten %s sürümünden bu yana Sphinx ile birleştirildi; bu uzantı yoksayıldı."
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "Özgün özel durumu:\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr " %s uzantısı içe aktarılamadı"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "%r uzantısı setup() işlevine sahip değil; bu gerçekten bir Sphinx uzantısı modülü mü?"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Bu proje tarafından kullanılan %s uzantısının en az Sphinx s%s sürümüne ihtiyacı var; bu nedenle bu sürümle oluşturulamaz."
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "%r uzantısı, setup() işlevinden desteklenmeyen bir nesne döndürdü; Hiçbir şey veya üstveri sözlüğü döndürmeli"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Geliştirme Önerileri; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "%r temasının \"theme\" ayarı yok"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "%r temasının \"inherit\" ayarı yok"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "%r adında bulunan tema yok, %r tarafından devralındı"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "%s.%s ayarı, aranan tema yapılandırmalarının hiçbirinde meydana gelmiyor"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "desteklenmeyen tema seçeneği %r verildi"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "tema yolundaki %r dosyası geçerli bir zip dosyası değil ya da hiç tema içermiyor"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme, 1.4.0 sürümünden bu yana artık zorunlu bir bağımlılık değil. Lütfen el ile yükleyin. (pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "%r adında bulunan tema yok (eksik theme.conf?)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "[mo] oluşturuluyor: "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "çıktı yazılıyor..."
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "%d po dosyasının tümü"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "belirtilen %d po dosyası için hedefler"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "güncel olmayan %d po dosyası için hedefler"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "tüm kaynak dosyaları"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "komut satırında verilen %r dosyası kaynak dizinin altında değil, yoksayılıyor"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "komut satırında verilen %r dosyası mevcut değil, yoksayılıyor"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "komut satırında verilen %d kaynak dosyası"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "güncel olmayan %d kaynak dosyası için hedefler"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "[%s] oluşturuluyor:"
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "şimdi güncel olmayan dosyalar aranıyor..."
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "%d tane bulundu"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "hiç bulunamadı"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
-msgstr "ortam temizleniyor"
+msgstr "ortam derin temizleniyor"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr "tutarlılık denetleniyor"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "hiçbir hedef güncel değil."
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "güncellenen ortam:"
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s eklendi, %s değiştirildi, %s kaldırıldı"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "kaynaklar okunuyor..."
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "çalışanlar için bekleniyor..."
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "yazmak için belge adları: %s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "belgeler hazırlanıyor"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "kopyalanmış ToC girişi bulundu: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "resimler kopyalanıyor..."
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "resim dosyası %r okunamıyor: bunun yerine kopyalanıyor"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "resim dosyası %r kopyalanamıyor: %s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "resim dosyası %r yazılamıyor: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr "Yastık bulunamadı - resim dosyaları kopyalanıyor"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "%s dosyası yazılıyor..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "%s için bilinmeyen mime türü, yoksayılıyor"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "%s dosyası yazılıyor..."
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Genel bakış dosyası %(outdir)s içinde."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "%s sürümünde değişiklik yok."
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "özet dosyası yazılıyor..."
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Yerleşikler"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Modül seviyesi"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "kaynak dosyalar kopyalanıyor..."
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "değişiklikler günlüğü oluşturma için %r okunamadı"
@@ -691,160 +715,164 @@ msgstr "değişiklikler günlüğü oluşturma için %r okunamadı"
 msgid "The dummy builder generates no files."
 msgstr "Taklit oluşturucu hiçbir dosya oluşturmaz."
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "ePub dosyası %(outdir)s içinde."
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_language\" (veya \"language\"), EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "yapılandırma değeri \"epub_uid\", EPUB3 için XML NAME olmalıdır"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_title\" (veya \"html_title\"), EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_author\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_contributor\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_description\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_publisher\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_copyright\" (veya \"copyright\"), EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_identifier\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"version\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "geçersiz css_file: %r, yoksayıldı"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "İleti katalogları %(outdir)s içinde."
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "%d şablon dosyası için hedefler"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "şablonlar okunuyor..."
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "ileti katalogları yazılıyor..."
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Yukarıdaki çıktıda veya %(outdir)s/output.txt içinde herhangi bir hata arayın"
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "Bağlayıcı '%s' bulunamadı"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "bozuk bağlantı: %s (%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "Bağlayıcı '%s' bulunamadı"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Rehber sayfaları %(outdir)s içinde."
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "hiçbir \"man_pages\" yapılandırma değeri bulunamadı; hiçbir rehber sayfası yazılmayacaktır"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "yazılıyor"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "\"man_pages\" yapılandırma değeri bilinmeyen %s belgesine başvurur"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML sayfası %(outdir)s içinde."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "tek bir belgede toplanıyor"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "ilave dosyalar yazılıyor"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Texinfo dosyaları %(outdir)s içinde."
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nMakeinfo aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make info' komutunu kullanın)."
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "hiçbir \"texinfo_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "\"texinfo_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "%s işleniyor"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "başvurular çözümleniyor..."
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (şurada:  "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "Texinfo destek dosyaları kopyalanıyor..."
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "Makefile dosyası yazılırken hata oldu: %s"
@@ -854,18 +882,18 @@ msgstr "Makefile dosyası yazılırken hata oldu: %s"
 msgid "The text files are in %(outdir)s."
 msgstr "Metin dosyaları %(outdir)s içinde."
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "%s dosyası yazılırken hata oldu: %s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "XML dosyaları %(outdir)s içinde."
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Pseudo-XML dosyaları %(outdir)s içinde."
@@ -880,290 +908,302 @@ msgstr "oluşturma bilgisi dosyası bozuldu: %r"
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTML sayfaları %(outdir)s içinde."
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "oluşturma bilgisi dosyasını okuma başarısız: %r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "html_use_opensearch yapılandırma değeri artık bir dizgi olmak zorundadır"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Genel Dizin"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "dizin"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "sonraki"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "önceki"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr "dizinler oluşturuluyor"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr "ilave sayfalar yazılıyor"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "indirilebilir dosyalar kopyalanıyor..."
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "indirilebilir dosya %r kopyalanamıyor: %s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "sabit dosyalar kopyalanıyor..."
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "sabit dosya %r kopyalanamıyor"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr "fazladan dosyalar kopyalanıyor"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "fazladan dosya %r kopyalanamıyor..."
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "oluşturma bilgisi dosyasını yazma başarısız: %r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "arama dizini yüklenemedi, ancak tüm belgeler oluşturulmayacaktır: dizin tamamlanmamış olacaktır."
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
-msgstr "sayfa %s html_sidebars içinde iki desenle eşleşiyor: %r ve %r"
+msgstr "sayfa %s html_sidebars içinde iki şekille eşleşiyor: %r ve %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "%s sayfasını işlerken bir Evrensel kod hatası meydana geldi. Lütfen ASCII olmayan içerik içeren tüm yapılandırma değerlerinin Evrensel kod dizgiler olduğundan emin olun."
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "%s sayfasını işlerken bir hata oldu.\nSebep: %r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr "nesne envanteri dökümleniyor"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr "%s içinde arama dizini dökümleniyor"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "geçersiz js_file: %r, yoksayıldı"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Birçok math_renderers kayıtlı. Ama hiç math_renderer seçilmedi."
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Bilinmeyen math_renderer %r verildi."
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path girişi %r mevcut değil"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "html_extra_path girişi %r, çıktı dizini içine yerleştirildi"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "html_static_path girişi %r mevcut değil"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "html_static_path girişi %r, çıktı dizini içine yerleştirildi"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "logo dosyası %r mevcut değil"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "favicon dosyası %r mevcut değil"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s belgelendirmesi"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTeX dosyaları %(outdir)s içinde."
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\n(pdf)latex aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make latexpdf' komutunu kullanın)."
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "hiçbir \"latex_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "\"latex_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Dizin"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Yayım"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "%r dili için bilinen hiç Babel seçeneği yok"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "TeX destek dosyaları kopyalanıyor"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "TeX destek dosyaları kopyalanıyor..."
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "ilave dosyalar kopyalanıyor"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr "Bilinmeyen yapılandırma anahtarı: latex_elements[%r], yoksayıldı."
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r, \"theme\" ayarına sahip değil"
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r, \"%s\" ayarına sahip değil"
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Oluşturulurken meydana gelen özel durum, hata ayıklayıcı başlatılıyor:"
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr "Yarıda kesildi!"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "reST biçimlendirme hatası:"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "Kodlama hatası:"
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Sorunu geliştiricilere bildirmek istiyorsanız, tam geri izleme %s içine kaydedildi."
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "Tekrarlama hatası:"
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "Bu, çok büyük veya çok fazla iç içe girmiş kaynak dosyaları ile olabilir. Varsayılan Python tekrarlama sınırını conf.py dosyasında şu örnekle 1000'e kadar dikkatlice artırabilirsiniz:"
+msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "Özel durum meydana geldi:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Bir dahaki sefere daha iyi bir hata iletisi sağlanabilmesi için lütfen bunu bir kullanıcı hatasıysa da bildirin."
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Bir hata raporu <https://github.com/sphinx-doc/sphinx/issues> adresindeki izleyicide dosyalanabilir. Teşekkürler!"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "iş numarası pozitif bir sayı olmalıdır"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "Daha fazla bilgi için <http://sphinx-doc.org/> sitesini ziyaret edin."
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,296 +1220,290 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\nKaynak dosyalardan belgelendirme oluşturun.\n\nsphinx-build, SOURCEDIR içindeki dosyalardan belgelendirme oluşturur ve OUTPUTDIR\niçine yerleştirir. Yapılandırma ayarları için SOURCEDIR içinde 'conf.py' dosyasını arar. 'sphinx-quickstart'' aracı, şablon dosyaları oluşturmak için kullanılabilir,\n'conf.py' dosyası dahil olmak üzere\n\nsphinx-build, farklı biçimlerde belgelendirme oluşturabilir. Komut satırında oluşturucu adı belirtilerek bir biçim seçilir; HTML varsayılandır.\nOluşturucular, belgelendirme işlemeyle ilgili diğer görevleri de\ngerçekleştirebilir.\n\nVarsayılan olarak, güncel olmayan her şey oluşturulur. Sadece seçilen\ndosyalar için çıktı, tek tek dosya adları belirtilerek oluşturulabilir.\n"
+msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "belgelendirme kaynak dosyaları için yol"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "çıktı dizini için yol"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "yeniden oluşturmak için belirli dosyaların listesi. Belirtildiyse yoksayıldı"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "genel seçenekler"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "kullanmak için oluşturucu (varsayılan: html)"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "tüm dosyaları yaz (varsayılan: sadece yeni ve değiştirilmiş dosyaları yaz)"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "kaydedilmiş bir ortam kullanma, her zaman tüm dosyaları oku"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "önbelleklenen ortam ve doctree dosyaları için yol (varsayılan: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "mümkünse N işlem ile paralel olarak oluştur (özel değer \"auto\" N miktarını cpu-count değerine ayarlayacak)"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "yapılandırma dosyasının (conf.py) bulunduğu yol (varsayılan: SOURCEDIR ile aynı)"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "hiç yapılandırma dosyası kullanmadan, sadece -D seçenekleri"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "yapılandırma dosyasındaki bir ayarı geçersiz kıl"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "HTML şablonlarına bir değer geçir"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "etiketi tanımla: \"sadece\" TAG'li blokları dahil et"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "nit-picky kipi, tüm eksik kaynaklar hakkında uyar"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "konsol çıktısı seçenekleri"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "ayrıntı seviyesini artır (tekrarlanabilir)"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "stdout üzerinde çıktı yok, stderr üzerinde sadece uyarılar"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "hiç çıktı yok, hatta uyarılarda bile"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "renkli çıktı yayımı yap (varsayılan: otomatik algıla)"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "renkli çıktı yayımı yapma (varsayılan: otomatik algıla)"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "verilen dosyaya uyarıları (ve hataları) yaz"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "uyarıları hatalara dönüştür"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr "-W ile, uyarıları alırken devam et"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "özel durumda tam geri izleme göster"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "özel durumda Pdb çalıştır"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "%r dosyaları bulunamıyor"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "-a seçeneği ve dosya adları birleştirilemiyor"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "uyarı dosyası %r açılamıyor: %s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "-D seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "-A seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "modüllerden otomatik olarak docstrings ekle"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "doctest bloklarında kod parçacıklarını otomatik olarak dene"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "farklı projelerin Sphinx begelendirmeleri arasında bağlantıla"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "oluşturmada gösterilebilen veya gizlenebilen \"yapılacaklar\" girişlerini yaz"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "belgelendirme kapsamı için denetlemeler"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "PNG veya SVG resimleri olarak işleneni, matematiği dahil et"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "MathJax ile tarayıcıda işleneni, matematiği dahil et"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "yapılandırma değerlerine dayalı içeriğin koşullu olarak eklenmesi"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "belgelenmiş Python nesnelerinin kaynak koduna bağlantıları dahil et"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "belgeyi GitHub sayfalarında yayımlamak için .nojekyll dosyası oluştur"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "Lütfen geçerli bir yol adı girin."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "Lütfen biraz metin girin."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Lütfen %s seçeneklerinden birini girin."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "Lütfen ya 'y' ya da 'n' girin."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Lütfen bir dosya soneki girin, örn. '.rst' veya '.txt'."
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "* Not: ASCII olmayan karakterler girildi ve terminal kodlama bilinmiyor -- UTF-8 veya Latin-1 varsayılıyor."
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Sphinx %s hızlı başlangıç yardımcı uygulamasına hoş geldiniz."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Lütfen aşağıdaki ayarlar için değerleri girin (parantez içinde verilirse\nvarsayılan değeri kabul etmek için yalnızca Enter tuşuna basın)."
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Seçilen kök dizin yolu: %s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr "Belgelendirme için kök dizin yolunu girin."
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "Belgelendirme için kök dizin yolu"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Hata: seçilen kök dizin yolunda varolan bir conf.py bulundu."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sfenks-quickstart varolan Sphinx projelerinin üzerine yazmayacak."
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Lütfen yeni bir kök dizin yolu girin (ya da çıkmak için yalnızca Enter'a basın)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Sphinx çıktısının oluşturma dizinini yerleştirmek için iki seçeneğiniz var.\nYa, kök dizin yolu içinde bir \"_build\" dizini kullanın, ya da kök dizin yolu\niçinde \"source\" ve \"build\" dizinlerini ayırın."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "Source ve build dizinlerini ayır (y/n)"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "Kök dizinin içinde, iki dizin daha oluşturulacaktır; özel HTML şablonları için \"_templates\"\nve özel stil sayfaları ve diğer sabit dosyalar için \"_static\".\nAlt çizgi yerine başka bir önek (\".\" gibi) girebilirsiniz."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "Templates ve static dizinleri için ad öneki"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "Proje adı, oluşturulan belgelendirmedeki çeşitli yerlerde oluşacak."
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "Proje adı"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "Hazırlayan ad(ları)ı"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr "Sphinx, yazılım için bir \"sürüm\" ve bir \"yayım\" kavramına sahiptir.\nHer sürümün birden çok yayımı olabilir. Örneğin, Python için\nsürüm 2.5 veya 3.0 gibi bir şeydir, yayım ise 2.5.1 veya 3.0a1 gibi\nbir şeydir. Eğer bu çift yapıya ihtiyacınız yoksa, her ikisini de aynı\ndeğere ayarlayın."
+msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "Proje sürümü"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "Proje yayımı"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1479,21 +1513,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Eğer belgeler İngilizce dışında bir dilde yazıldıysa, bunun dil koduna\ngöre burada bir dil seçebilirsiniz. Sphinx daha sonra, ürettiği metni o\ndile çevirecektir.\n\nDesteklenen kodların listesi için\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language adresine bakın."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "Proje dili"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr "Kaynak dosyalar için dosya adı soneki. Genellikle, bu ya \".txt\" ya da\n\".rst\"dir. Sadece bu soneki içeren dosyalar belgeler olarak kabul edilir."
+msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "Kaynak dosya soneki"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1501,91 +1535,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr "Bir belge, \"içindekiler ağacı\"nın üst düğümü olarak kabul edilmesi, yani\nbelgelerin hiyerarşik yapısının kökü olması açısından özeldir.\nNormalde bu \"dizin\"dir, ancak \"dizin\" belgeniz özel bir şablonsa,\nbunu başka bir dosya adına da ayarlayabilirsiniz."
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "Asıl belgenizin adı (sonek olmadan)"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Hata: %s asıl dosyası zaten seçilen kök dizin yolunda bulundu."
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sfenks-quickstart varolan dosyanın üzerine yazmayacak."
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Lütfen yeni bir dosya adı girin ya da varolan dosyayı yeniden adlandırın ve Enter tuşuna basın"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Aşağıdaki Sphinx uzantılarından hangisinin etkinleştirilmesi gerektiğini gösterir:"
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Not: imgmath ve mathjax aynı anda etkinleştirilemez. imgmath seçimi kaldırıldı."
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Makefile ve Windows komut dosyası sizin için oluşturulabilir,\nböylece doğrudan örn. sphinx-build çağırmak yerine sadece\n`make html' komutu çalıştırılmak zorundadır."
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "Makefile oluşturulsun mu? (y/n)"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "Windows komut satırı oluşturulsun mu? (y/n)"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "%s dosyası oluşturuluyor."
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "%s dosyası zaten var, atlanıyor."
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "Tamamlandı: İlk dizin yapısı oluşturuldu."
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Artık %s asıl dosyanızı doldurmalı ve diğer belgelendirme kaynak dosyalarını\noluşturmalısınız."
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Belgeleri oluşturmak için Makefile'ı kullanın, aşağıdaki gibi:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Belgeleri oluşturmak için sphinx-build komutunu kullanın, aşağıdaki gibi:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "\"builder\" burada desteklenen oluşturuculardan biridir, örn. html, latex veya linkcheck."
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1595,787 +1629,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nBir Sphinx projesi için gerekli dosyaları oluşturun.\n\nsphinx-quickstart, projeniz hakkında bazı sorular soran ve ardından tam bir\nbelgelendirme dizini ve örnek oluşturan etkileşimli bir araçtır\nMakefile, sphinx-build ile kullanılır.\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "sessiz kipi"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr "proje kök dizini"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "Yapı seçenekleri"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "eğer belirtildiyse, kaynak ve oluşturma dizinlerini ayırın"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "_templates vb. içinde nokta için değiştirme"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "Proje temel seçenekleri"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "proje adı"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "hazırlayan adları"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "projenin sürümü"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "projenin yayımı"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "belge dili"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "kaynak dosya soneki"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "asıl belge adı"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "epub kullan"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "Uzantı seçenekleri"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "%s uzantısını etkinleştir"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "rasgele uzantıları etkinleştir"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "Makefile ve Batchfile oluşturma"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "makefile oluştur"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "makefile oluşturma"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "batchfile oluştur"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "batchfile oluşturma"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat için make-mode kullan"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat için make-mode kullanma"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "Proje şablonlama"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "şablon dosyaları için şablon dizini"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "bir şablon değişkeni tanımla"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"sessiz\" belirtilmiş, ancak herhangi bir \"proje\" veya \"hazırlayan\" belirtilmemiş."
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Hata: belirtilen yol bir dizin değil ya da sphinx dosyaları zaten var."
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sfenks-quickstart sadece boş bir dizin içine oluşturur. Lütfen yeni bir kök dizin yolu belirtin."
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Geçersiz şablon değişkeni: %s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "Aşırı alıkoyma algılandı"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Geçersiz resim yazısı: %s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "satır numarası özellikleri aralık dışında (1-%d): %r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Hem \"%s\" hem de \"%s\" seçeneği kullanılamıyor"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Dahil edilen %r dosyası bulunamadı ya da dosyayı okuma başarısız oldu"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "%r kodlamasının kullanıldığı, dahil edilen %r dosyasını okuma yanlış gibi görünüyor, bir :encoding: seçeneği vermeyi deneyin"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "%r adlı nesne, dahil edilen %r dosyasında bulunamadı"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Ayrık bir \"satır\" kümesiyle \"lineno-match\" kullanılamıyor"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Satır özelliği %r: dahil edilen %r dosyasından çekilen hiç satır yok"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Bölümü hazırlayan: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Modülü hazırlayan: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Kodu hazırlayan: "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Hazırlayan: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Parametreler"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Dönüşler"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Dönüş türü"
 
-#: sphinx/domains/c.py:187
-#, python-format
-msgid "%s (C function)"
-msgstr "%s (C işlevi)"
-
-#: sphinx/domains/c.py:189
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C member)"
-msgstr "%s (C üyesi)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C makrosu)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C türü)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "üyesi"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C değişkeni)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "değişkeni"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "işlevi"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "üyesi"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "makrosu"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "birliği"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "numaralandırıcı"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "türü"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "değişkeni"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
-msgstr "%s kopya C nesnesi açıklaması, %s içindeki diğer örnek, bunlardan biri için :noindex: kullanın"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "%s sürümünde geldi"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "%s sürümünde değişti"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "%s sürümünden beri kullanım dışı"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "%s kopya alıntısı, %s içindeki diğer örnek"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "Alıntı [%s] kaynak gösterilmedi."
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "Kopya bildiri, ayrıca '%s' içinde tanımlı.\nBildiri '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "Şablon Parametreleri"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Şunu verir: "
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "sınıfı"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "birliği"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "kavramı"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "numaralandırıcı"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "Kopya bildiri, ayrıca '%s' içinde tanımlı.\nBildirinin adı '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (yerleşik işlev)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s yöntemi)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (sınıf)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (genel değişken veya sabit)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s özniteliği)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Bağımsız Değişkenler"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modül)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "yöntemi"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "verisi"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "özniteliği"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "modülü"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "kopya %s açıklamasına ait %s, diğer %s, %s içinde"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "%s denkleminin kopya etiketi, %s içindeki diğer örnek"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Geçersiz math_eqref_format: %r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "anahtar kelime"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "işleç"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "nesne"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "özel durum"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "ifade"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "yerleşik işlev"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Değişkenler"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Harekete geçirir"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s modülü içinde)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (yerleşik değişken)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s modülü içinde)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (yerleşik değişken)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (yerleşik sınıf)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s içindeki sınıf)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s yöntemi)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s sınıf yöntemi)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s sabit yöntemi)"
+msgid "%s() (%s property)"
+msgstr "%s() (%s özelliği)"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s sabit yöntemi)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s sınıf yöntemi)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s sınıf yöntemi)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s özniteliği)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr "%s() (%s özelliği)"
+msgid "%s (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python Modül Dizini"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "modülleri"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Kullanım dışı"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "sınıf yöntemi"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "sabit yöntemi"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "%s kopya nesne açıklaması, %s içindeki diğer örnek, bunlardan biri için :noindex: kullanın"
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "çapraz referans %r için birden fazla hedef bulundu: %s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (kullanım dışı)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (yönerge)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (yönerge seçeneği)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "yönergesi"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr "yönerge seçeneği"
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "rolü"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "%s %s kopya açıklaması, %s içindeki diğer örnek"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "ortam değişkeni; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Hatalı biçimlendirilmiş seçenek açıklaması %r, \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" veya \"+opt args\" şeklinde görünmelidir"
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr "%s komut satırı seçeneği"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr "komut satırı seçeneği"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr "sözlük teriminden önce boş satır gelmek zorundadır"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr "sözlük terimleri boş satırlarla ayrılmamak zorundadır"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "sözlük yanlış biçimlendirilmiş gibi görünüyor, girintiyi gözden geçirin"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "sözlük terimi"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "dilbilgisi belirteci"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "başvuru etiketi"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "ortam değişkeni"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "program seçeneği"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "belge"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Modül Dizini"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Arama Sayfası"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "%s kopya etiketi, %s içindeki diğer örnek"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "kopya %s açıklamasına ait %s, %s içindeki diğer örnek "
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig etkisizleştirildi. :numref: yoksayıldı."
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "%s için atanan numara yok: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "bağlantının resim yazısı yok: %s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "geçersiz numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "geçersiz numfig_format: %s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "yeni yapılandırma"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "yapılandırma değişti"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "uzantılar değişti"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "yapım ortamı sürümü şu anki değil"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "kaynak dizin değişti"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Bu ortam seçilen oluşturucuyla uyumsuzdur, lütfen başka bir belge ağacı dizini seçin."
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "%s içinde belgeleri tarama başarısız oldu: %r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Etki alanı %r kayıtlı değil"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr "kendinden kaynaklı toctree bulundu. Yoksayıldı."
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "belge herhangi bir toctree içine dahil değil"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "bakınız %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "ayrıca bakınız %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "bilinmeyen dizin girişi türü %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Semboller"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "dairesel toctree kaynakları algılandı, yoksayılan: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
-msgstr ""
+msgstr "toctree, başlığı olmayan %r belgesine başvuru içeriyor: hiç bağlantı oluşturulmayacaktır"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
-msgstr ""
+msgstr "toctree, hariç tutulan %r belgesine başvuru içeriyor"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
-msgstr ""
+msgstr "toctree, varolmayan %r belgesine başvuru içeriyor"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
-msgstr ""
+msgstr "resim dosyası okunabilir değil: %s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
-msgstr ""
+msgstr "%s resim dosyası okunabilir değil: %s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
-msgstr ""
+msgstr "indirme dosyası okunabilir değil: %s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
-msgstr ""
+msgstr "%s zaten atanmış bölüm numaralarıdır (iç içe numaralı toctree mi?)"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
-msgstr ""
+msgstr "%s dosyası oluşturur."
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,167 +2408,187 @@ msgid ""
 "excluded from generation.\n"
 "\n"
 "Note: By default this script will not overwrite already created files."
-msgstr ""
+msgstr "\nPython modülleri ve paketleri için <MODULE_PATH> içine art arda bakın ve <OUTPUT_PATH> içindeki\npaket başına otomodül talimatlarını içeren bir reST dosyası oluşturun.\n\n<EXCLUDE_PATTERN>'ler, nesilden hariç tutulacak olan dosya ve/veya dizin şekilleri olabilir.\n\nNot: Varsayılan olarak bu betik zaten oluşturulmuş dosyaların üzerine yazmayacak."
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
-msgstr ""
+msgstr "belge için modüle giden yol"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
-msgstr ""
+msgstr "nesilden hariç tutmak için fnmatch-style dosyası ve/veya dizin şekilleri"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
-msgstr ""
+msgstr "tüm çıktıların yerleştirileceği dizin"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
-msgstr ""
+msgstr "TOC'da gösterilecek alt modüllerin en fazla derinliği (varsayılan: 4)"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
-msgstr ""
+msgstr "varolan dosyaların üzerine yaz"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
-msgstr ""
+msgstr "sembolik bağlantıları takip edin. Collective.recipe.omelette ile birleştirildiğinde güçlü."
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
-msgstr ""
+msgstr "dosyaları oluşturmadan betiği çalıştır"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
-msgstr ""
+msgstr "her modül için belgelendirmeyi kendi sayfasına koy"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
-msgstr ""
+msgstr "\"_private\" modülleri dahil"
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
-msgstr ""
+msgstr "içindekiler dosyası adı (varsayılan: modüller)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
-msgstr ""
+msgstr "içindekiler tablosu oluşturma"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
-msgstr ""
+msgstr "modül/paket paketleri için başlıklar oluşturma (örn. docstrings zaten bunları içerdiğinde)"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
-msgstr ""
+msgstr "modül belgelerini alt modül belgelerinin önüne koyun"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
-msgstr ""
+msgstr "modül yollarını PEP-0420 kapalı ad alanları özelliklerine göre yorumla"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
-msgstr ""
+msgstr "dosya soneki (varsayılan: rst)"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
-msgstr ""
+msgstr "sphinx-quickstart ile tam bir proje oluştur"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
-msgstr ""
+msgstr "--full yazıldığında, append module_path to sys.path, kullanılır"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
-msgstr ""
+msgstr "proje adı (varsayılan: kök modül adı)"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
-msgstr ""
+msgstr "--full yazıldığında, proje hazırlayan(lar)ı kullanılır"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
-msgstr ""
+msgstr "--full yazıldığında, proje sürümü kullanılır"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
-msgstr ""
+msgstr "--full yazıldığında, varsayılanı to --doc-version, proje yayımı kullanılır"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
-msgstr ""
+msgstr "uzantı seçenekleri"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
-msgstr ""
+msgstr "%s bir dizin değil."
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2559,11 +2602,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2573,14 +2616,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2590,29 +2633,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
-msgstr ""
+msgstr "nokta kodu %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[grafik: %s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[grafik]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,150 +2667,160 @@ msgid ""
 "%r\n"
 "[stdout]\n"
 "%r"
-msgstr ""
+msgstr "dönüştürmeden hata ile çıkıldı:\n[stderr]\n%r\n[stdout]\n%r"
+
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "dönüştürme komutu %r çalıştırılamaz, image_converter ayarını gözden geçirin"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
-msgstr ""
+msgstr "LaTeX komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_latex ayarını gözden geçirin"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
-msgstr ""
+msgstr "%s komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_%s ayarını gözden geçirin"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
-msgstr ""
+msgstr "görüntü latex %r: %s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
-msgstr ""
+msgstr "satır içi latex %r: %s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 msgid "Permalink to this equation"
 msgstr "Bu denklem için kalıcı bağlantı"
 
-#: sphinx/ext/intersphinx.py:173
+#: sphinx/ext/intersphinx.py:174
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
-msgstr ""
+msgstr "intersphinx envanteri taşındı: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
-msgstr ""
+msgstr "%s konumundan intersphinx envanteri yükleniyor..."
 
-#: 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 ""
+msgstr "aşağıdaki sorunlardan dolayı envanterlerden herhangi birine ulaşılamadı:"
 
-#: sphinx/ext/intersphinx.py:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(%s v%s içinde)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(%s içinde)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[kaynak]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Yapılacaklar"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>>, %s içinde, %d. satırda bulunur.)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "özgün giriş"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[belgeler]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "Modül kodu"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s öğesinin kaynak kodu</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "Genel bakış: modül kodu"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Kodları mevcut bütün modüller</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2774,104 +2828,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "şunun takma adı: :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2886,107 +2993,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "Örnek"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Örnekler"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "Notlar"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "Diğer Parametreler"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "Kaynaklar"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "Uyarılar"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr "Getiriler"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Dikkat"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Uyarı"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Tehlike"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Hata"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "İpucu"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Önemli"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Not"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Ayrıca bakınız"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Tüyo"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Uyarı"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "önceki sayfadan devam"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "sonraki sayfaya devam"
@@ -3003,181 +3134,181 @@ msgstr "Numaralar"
 msgid "page"
 msgstr "sayfa"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "İçindekiler"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Ara"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Git"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Kaynağı Göster"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Genel Bakış"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Hoş Geldiniz! Karşınızda"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "belgelendirme konusu: "
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "son güncelleme"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Dizinler ve tablolar:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Tam İçindekiler"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "tüm bölümleri ve alt bölümleri listeler"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "bu belgelendirmeyi ara"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Genel Modül Dizini"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "tüm modüllere hızlı erişim"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "tüm işlevler, sınıflar, terimler"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Dizin &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Tek sayfada tam dizin"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Harfe göre dizin sayfaları"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "çok büyük olabilir"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Gezinti"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s içinde ara"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Bu belgeler hakkında"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Telif hakkı"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Telif hakkı</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Telif hakkı %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Son güncelleme: %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "<a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s kullanılarak oluşturuldu."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "%(docstitle)s ara"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Önceki konu"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "önceki bölüm"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Sonraki konu"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "sonraki bölüm"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Arama işlevini kullanabilmek için lütfen JavaScript'i\n    etkinleştirin."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "ara"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Arama Sonuçları"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "Arama sonucunda herhangi bir belge bulunamadı. Bütün kelimeleri doğru yazdığınızdan ve gerekli bütün kategorileri seçtiğinizden emin olun."
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Hızlı Arama"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Bu Sayfa"
 
@@ -3209,19 +3340,19 @@ msgstr "C API'sindeki değişiklikler"
 msgid "Other changes"
 msgstr "Diğer değişiklikler"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Bu başlık için kalıcı bağlantı"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Bu tanım için kalıcı bağlantı"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Arama Eşleşmelerini Gizle"
 
@@ -3233,12 +3364,12 @@ msgstr "Aranıyor"
 msgid "Preparing search..."
 msgstr "Aramaya hazırlanıyor..."
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "Arama tamamlandı. Sorguyu içeren %s sayfa bulundu."
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ", şunun içinde:"
 
@@ -3251,7 +3382,7 @@ msgstr "Yan çubuğu genişlet"
 msgid "Collapse sidebar"
 msgstr "Yan çubuğu daralt"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "İçindekiler"
 
@@ -3270,199 +3401,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Bilinmeyen resim biçimi: %s..."
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr "atlandı"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr "başarısız oldu"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "okuma hatası: %s, %s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "yazma hatası: %s, %s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "varsayılan rol %s bulunamadı"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "Bu tablonun kalıcı bağlantısı"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "Bu kodun kalıcı bağlantısı"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "Bu resmin kalıcı bağlantısı"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "Bu içindekiler tablosunun kalıcı bağlantısı"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "Dipnotlar"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[resim: %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[resim]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
index 791426dd715..5fc97a727da 100644
--- a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Petro Sasnyk <petro@sasnyk.name>, 2009
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Ukrainian (Ukraine) (http://www.transifex.com/sphinx-doc/sphinx-1/language/uk_UA/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: uk_UA\n"
 "Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n % 10 == 1 && n % 100 != 11 ? 0 : n % 1 == 0 && n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14) ? 1 : n % 1 == 0 && (n % 10 ==0 || (n % 10 >=5 && n % 10 <=9) || (n % 100 >=11 && n % 100 <=14 )) ? 2: 3);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Вбудовані елементи"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Рівень модуля"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (в "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Загальний індекс"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "індекс"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "наступний"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "попередній"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "Індекс"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "Реліз"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Автор секції: "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Автор модуля: "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Автор: "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Параметри"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Повертає"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Тип повернення"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (С функція)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C член)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C макрос)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C тип)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "член"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C змінна)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "функція"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "член"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "макрос"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
-msgstr "тип"
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
+msgstr "тип"
+
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
+msgstr ""
+
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Нове в версії %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Змінено в версії %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Застаріло починаючи з версії %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "клас"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (вбудована функція)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s метод)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (клас)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s атрибут)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (модуль)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "атрибут"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "модуль"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "ключове слово"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "оператор"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "об'єкт"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "виняткова ситуація"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "вираз"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "вбудована функція"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Викликає"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (в модулі %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (вбудована змінна)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (в модулі %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (вбудована змінна)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (вбудований клас)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (клас в %s)"
 
-#: sphinx/domains/python.py:613
-#, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s метод)"
-
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s статичний метод)"
-
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
-#, python-format
-msgid "%s() (%s static method)"
-msgstr "%s() (%s статичний метод)"
-
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s class method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:745
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s атрибут)"
+msgid "%s() (%s static method)"
+msgstr "%s() (%s статичний метод)"
 
-#: sphinx/domains/python.py:709
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "модулі"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Застарілий"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "статичний метод"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (застарілий)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "змінна оточення; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "змінна оточення"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "Індекс модулів"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Сторінка пошуку"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Доробити"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr "синонім :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Увага"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Застереження"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Небезпека"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Помилка"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Підказка"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Важливо"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Примітка"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Дивись також"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Порада"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Попередження"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,181 +3131,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Пошук"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Вперед"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Відобразити вихідний текст"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Огляд"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Індекси та таблиці:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Повний Зміст"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "перелічити всі секції та підсекції"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "шукати цю документацію"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Загальний індекс модулів"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "швидкий доступ до всіх модулів"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "всі функції, класи, терміни"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Індекс &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Повний індекс на одній сторінці"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Індексні сторінки по символам"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "може бути величезним"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Навігація"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Шукати в %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Про ці документи"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Авторські права"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Востаннє оновлено %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Створено з використанням <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Пошук %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Попередній розділ"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "Попередній розділ"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Наступна тема"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "наступний розділ"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Будь-ласка вімкніть підтримку JavaScript, щоб ввікнути\n\"\n\"    пошук."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "пошук"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "Результати пошуку"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Швидкий пошук"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "Ця сторінка"
 
@@ -3207,19 +3337,19 @@ msgstr "зміни C API"
 msgid "Other changes"
 msgstr "Інші зміни"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "Постійне посилання на цей заголовок"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "Постійне посилання на це визначення"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "Приховати співпадіння пошуку"
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/ur/LC_MESSAGES/sphinx.po b/sphinx/locale/ur/LC_MESSAGES/sphinx.po
index c37314be1f4..c1dd993e8d0 100644
--- a/sphinx/locale/ur/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ur/LC_MESSAGES/sphinx.po
@@ -1,147 +1,152 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Urdu (http://www.transifex.com/sphinx-doc/sphinx-1/language/ur/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: ur\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +154,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,59 +167,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,58 +227,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -281,405 +279,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -688,160 +711,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -851,18 +878,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -877,290 +904,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1179,277 +1218,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1458,15 +1491,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1476,21 +1509,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1498,91 +1531,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1592,787 +1625,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr ""
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
+msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
+msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
+#: sphinx/domains/c.py:3702
+msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
-msgid "function"
+#: sphinx/domains/c.py:3703
+msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:260
-msgid "macro"
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
-msgid "type"
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:262
-msgid "variable"
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
+msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
-msgid "%s (built-in variable)"
+msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:657
 #, python-format
-msgid "%s (in module %s)"
+msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
+msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
+msgid "%s() (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr ""
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr ""
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2384,165 +2406,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2556,11 +2598,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2570,14 +2612,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2587,29 +2629,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2622,148 +2665,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2771,104 +2824,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
+#, python-format
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2883,107 +2989,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3000,124 +3130,124 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr ""
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr ""
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
 msgstr ""
 
@@ -3126,55 +3256,55 @@ msgstr ""
 msgid "Search %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr ""
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3206,19 +3336,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3230,12 +3360,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3248,7 +3378,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
@@ -3267,199 +3397,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/vi/LC_MESSAGES/sphinx.po b/sphinx/locale/vi/LC_MESSAGES/sphinx.po
index 20c77edebf9..0f3ef5ff35e 100644
--- a/sphinx/locale/vi/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/vi/LC_MESSAGES/sphinx.po
@@ -1,148 +1,153 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Hoat Le Van <hoatlevan@gmail.com>, 2014
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Vietnamese (http://www.transifex.com/sphinx-doc/sphinx-1/language/vi/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: vi\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +155,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,59 +168,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,58 +228,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -282,405 +280,430 @@ msgstr ""
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Các đề nghị nâng cao Python; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "Dựng sẵn"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "Mức mô-đun"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -689,160 +712,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(trong"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -852,18 +879,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -878,290 +905,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d/%m/%Y"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Chỉ mục chung"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "chỉ mục"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "xem tiếp"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "xem lại"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "Tài liệu %s %s"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1180,277 +1219,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1459,15 +1492,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1477,21 +1510,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1499,91 +1532,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1593,787 +1626,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "Tác giả mục:"
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "Tác giả mô-đun:"
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "Tác giả mã lệnh:"
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "Tác giả:"
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "Tham số"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "Trả về"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "Kiểu trả về"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (hàm C)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (thuộc tính C)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (macro C)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (kiểu C)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "thuộc tính"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (biến C)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "biến"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "hàm"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "thuộc tính"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr ""
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr ""
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "kiểu"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "biến"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "Mới từ phiên bản %s"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "Thay đổi trong phiên bản %s"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Sắp loại bỏ từ phiên bản %s"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "Ném"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "lớp"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr ""
-
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (hàm dựng sẵn)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (phương thức %s)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (lớp)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (biến toàn cục hoặc hằng số)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (thuộc tính %s)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "Đối số"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (mô-đun)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "phương thức"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "dữ liệu"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "thuộc tính"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "mô-đun"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "từ khoá"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "toán tử"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "đối tượng"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "ngoại lệ"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "câu lệnh"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "hàm dựng sẵn"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "Các biến"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "Đưa ra"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (trong mô-đun %s)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (biến dựng sẵn)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (trong mô-đun %s)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (biến dựng sẵn)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (lớp dựng sẵn)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (lớp trong %s)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (phương thức %s.%s) "
+msgid "%s() (%s class method)"
+msgstr "%s() (phương thức lớp %s)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (phương thức tĩnh %s.%s)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (phương thức tĩnh %s)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (phương thức lớp %s.%s)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (phương thức lớp %s)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (thuộc tính %s.%s)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Chỉ Mục Mô-đun Python"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "các mô-đun"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "Sắp loại bỏ"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "phương thức lớp"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "phương thức tĩnh"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr "(sắp loại bỏ)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (chỉ thị)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (vai trò)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "chỉ thị"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "vai trò"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "các biến môi trường; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "chú giải thuật ngữ"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "xem %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "nên xem %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Biểu tượng"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2385,165 +2407,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2557,11 +2599,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2571,14 +2613,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2588,29 +2630,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2623,148 +2666,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr ""
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2772,104 +2825,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
+msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2884,107 +2990,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "Các ví dụ"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "Chú ý"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "Cảnh báo"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "Nguy hiểm"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "Lỗi"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "Gợi ý"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "Quan trọng"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "Ghi chú"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "Xem thêm"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "Mẹo"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "Cảnh báo"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3001,181 +3131,181 @@ msgstr ""
 msgid "page"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Tìm Kiếm"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "Thực hiện"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "Hiển thị mã nguồn"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "Tổng quan"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "Chào mừng! Đây là"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "tài liệu cho"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "cập nhật mới nhất"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "Các chỉ mục và bảng biểu:"
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "Mục Lục Đầy Đủ"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "liệt kê tất cả các mục và mục con"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "tìm kiếm trong tài liệu này"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "Chỉ Mục Mô-đun Toàn Cục"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "truy cập nhanh tất cả các mô-đun"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "tất cả các hàm, lớp, thuật ngữ"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "Chỉ mục &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "Toàn bộ chỉ mục trên một trang"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "Các trang chỉ mục theo chữ cái"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "có thể rất nhiều"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "Điều hướng"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Tìm kiếm trong %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "Về các tài liệu này"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "Bản quyền"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Cập nhật mới nhất vào %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "Được tạo nhờ <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "Tìm %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "Chủ đề trước"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "chương trước "
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "Chủ đề tiếp"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "chương tiếp"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Hãy bật JavaScript để dùng tính năng\ntìm kiếm."
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr ""
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr ""
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr ""
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr ""
 
@@ -3207,19 +3337,19 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3231,12 +3361,12 @@ msgstr ""
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr ""
 
@@ -3249,7 +3379,7 @@ msgstr ""
 msgid "Collapse sidebar"
 msgstr ""
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Nội dung"
 
@@ -3268,199 +3398,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
diff --git a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po
index 5b9491c5369..c40df65e3ca 100644
--- a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po
@@ -1,159 +1,167 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
 # Yinian Chin <yinian1992@live.com>, 2015,2017-2018
 # Hsiaoming Yang <me@lepture.com>, 2018
+# Izabel Wang <izabelwang@pku.edu.cn>, 2020
+# Izabel Wang <izabelwang@pku.edu.cn>, 2020
 # Jian Dai <daijian1@qq.com>, 2020
 # Nomaka <nomakacyx@gmail.com>, 2018
 # Lenville Leo <lenville@gmail.com>, 2013
 # Lenville Leo <lenville@gmail.com>, 2013
 # Nomaka <nomakacyx@gmail.com>, 2018
 # Ryekee Zhong <ryekee@gmail.com>, 2013
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2019
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2019,2021
 # Tower Joo<zhutao.iscas@gmail.com>, 2009
-# Yinian Chin <yinian1992@live.com>, 2013,2018
+# wendi cao <651645601@qq.com>, 2020
+# Yinian Chin <yinian1992@live.com>, 2013,2018,2020
 # Yinian Chin <yinian1992@live.com>, 2013
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Chinese (China) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_CN/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: zh_CN\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "配置目录中缺少 conf.py 文件 (%s)"
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "无法找到源码目录 (%s)"
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr "源文件目录和目标目录不能是同一目录"
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "正在运行 Sphinx v%s"
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "该项目需要 Sphinx v%s 及以上版本，使用现有版本不能构建文档。"
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr "创建输出目录"
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "同时设置扩展名 %s:"
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "当前 conf.py 中定义的 'setup' 不是一个可调用的 Python 对象。请把其定义改为一个可调用的函数。Sphinx 扩展的 conf.py 必须这样配置。"
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "正在加载翻译 [%s]... "
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "完成"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr "没有内置信息的翻译"
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr "加载 pickled环境"
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "失败：%s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "未选择构建程序，默认使用：html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "成功"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "完成但存在问题"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
-msgstr ""
+msgstr "构建 %s，%s 警告（将警告视为错误）。"
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
-msgstr ""
+msgstr "构建 %s，%s 警告（将警告视为错误）。"
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr "构建 %s, %s 警告。"
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
-msgstr ""
+msgstr "构建 %s，%s 警告。"
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr "构建 %s."
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "节点类 %r 已注册，其访问者将被覆盖"
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "指令 %r 已注册，将被覆盖"
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "角色 %r 已注册，将被覆盖"
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -161,12 +169,12 @@ msgid ""
 "explicit"
 msgstr "扩展 %s 没有声明是否并行读取安全，默认假定为否 - 请联系扩展作者检查是否支持该特性并显式声明"
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
-msgstr ""
+msgstr "扩展 %s 不是并行读取安全的"
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -174,59 +182,59 @@ msgid ""
 "explicit"
 msgstr "%s 扩展没有声明是否并行写入安全，默认假定为否 - 请联系扩展作者检查是否支持该特性并显式声明"
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
-msgstr ""
+msgstr "扩展 %s 不是并行写入安全的"
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr "执行顺序 %s"
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "不能覆盖字典配置项 %r，已忽略 (请用 %r 设置单个字典元素)"
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "无效的数值 %r 用于配置项 %r，已忽略"
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "配置项 %r 覆盖值类型不支持，已忽略"
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "覆盖中包含未知配置项 %r ，已忽略"
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr "不存在的配置项：%s"
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr "配置项 %r 已存在"
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "配置文件中存在语法错误: %s\n"
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "配置文件（或配置文件导入的模块）调用了 sys.exit()"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -234,58 +242,51 @@ msgid ""
 "%s"
 msgstr "配置文件中有程序上的错误：\n\n%s"
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "配置值\"source_后缀\"需要字符串、字符串列表或字典。但给出\"%r\"。"
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "节 %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "图 %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "表 %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "列表 %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "配置项 `{name}` 必须设置为 {candidates} 之一，但现在是 `{current}` 。"
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "配置值\"[name]\"的类型为\"[当前._name];但\"当前\"为\"当前\"。\"当前\"为\"当前\"。\"当前\"为\"当前\"。=================================预期 [允许]。"
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "配置项 `{name}' 的类型是 `{current.__name__}'，默认为 `{default.__name__}'。"
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr "配置项 %r 的值包含了非 ASCII 字符，这会导致 Unicode 错误。请使用 Unicode 字符串，例如 %r。"
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -293,405 +294,430 @@ msgstr "未找到 primary_domain %r，已忽略。"
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
-msgstr "自 v2.0 以来，Sphinx 默认使用\"索引\"作为主文档。请在conf.py中添加\"master_doc = \"内容\"。"
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
+msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr "事件 %r 已存在"
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "未知事件名称：%s"
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "未能加载 needs_extensions 配置项所需的 %s。"
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "该项目所需扩展 %s 最低要求版本 %s ，当前加载版本 (%s) 无法构建文档。"
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "未知的 Pygments 词法分析器 %r"
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "无法按照“%s”语言的词法解析代码块，跳过语法高亮。"
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr "无法读取文档，已忽略。"
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "构建程序类 %s 未包含 \"name\" 属性"
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "构建程序 %r 已存在 (见模块 %s)"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "构建程序 %s 未注册或在入口点不可用"
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "构建程序 %s 未注册"
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr "域 %s 已注册"
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "域 %s 尚未注册"
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "%r 指令已注册到域 %s"
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "%r 角色已注册到域 %s"
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "%r 索引已注册到域 %s"
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "对象类型 %r 已注册"
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "交叉引用类型 %r 已注册"
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "源文件扩展名 %r 已注册"
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "%r 的 source_parser 已注册"
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "未注册 %s 的源代码语法分析器"
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "翻译已存在 %r"
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node() 的关键字参数必须是 (visit, depart) 形式的函数元组：%r=%r"
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "可数节点 %r 已注册"
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr "公式渲染器 %s 已注册"
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "扩展 %r 已合并至 Sphinx (自版本 %s 开始)；该扩展被忽略。"
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr "原始异常：\n"
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "无法导入扩展 %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "扩展 %r 未包含setup() 函数；它确实是一个 Sphinx 扩展模块吗？"
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "该项目所用扩展 %s 需要 Sphinx 版本 %s 以上；当前版本无法构建文档。"
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "扩展 %r 在其 setup() 函数中返回了一个不支持的对象；该函数应返回 None 或一个元数据字典"
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python 提高建议; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "主题 %r 未包含 \"theme\" 配置"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "主题 %r 未包含 \"inherit\" 配置"
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "未找到主题 %r，则从 %r 继承"
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "配置项 %s.%s 在所有已找到主题配置中均未出现"
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "不支持的主题选项 %r"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
-msgstr "主题路径指定的文件 %r 是一个无效的或不包含主题的 zip 文件"
+msgstr "主题路径指定的文件 %r 是一个无效的或不包含主题的  zip 文件"
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
-msgstr "sphinx_rtd_theme 从 1.4.0 版本开始不再作为强依赖。请手动安装。(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
+msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "主题 %r 未找到 (缺少 theme.conf？)"
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "没有找到适合 %s 构建器的图像：%s (%s)"
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "没有找到适合 %s 构建器的图像：%s"
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr "构建 [mo]： "
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr "写入输出... "
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr "所有的 %d po 文件"
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "指定了 %d 个 po 文件的目标文件"
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "%d 个 po 文件的目标文件已过期"
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr "所有源文件"
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "源文件目录下没有命令行给出的 %r 文件，将被忽略"
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr "命令行给出的 %r 文件不存在，将被忽略"
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr "命令行给出了 %d 个源文件"
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "%d 个源文件的目标文件已过期"
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr "构建 [%s]： "
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr "查找当前已过期的文件... "
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr "找到 %d 个"
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr "没有找到"
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr "pickling环境"
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr "检查一致性"
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr "没有过期的目标文件。"
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr "更新环境: "
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "已添加 %s，%s 已更改，%s 已移除"
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr "阅读源... "
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr "等待工作线程……"
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr "写入文档：%s"
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr "准备文件"
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "找到重复的ToC条目: %s"
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr "复制图像... "
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "无法读取图像文件 %r：直接复制"
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "无法复制图像文件 %r：%s"
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "无法写入图像文件 %r：%s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr "未找到Pillow - 复制图像文件"
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
-msgstr "正在写入 %s 文件……"
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
+msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "%s 的 MIME 类型未知，将被忽略"
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr "正在写入 %s 文件……"
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "概览文件保存在 %(outdir)s 目录 。"
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr "%s 版本中没有做出修改。"
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr "写入摘要文件..."
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "内置"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "模块级别"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr "复制源文件……"
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "创建变更记录时无法读取 %r"
@@ -700,160 +726,164 @@ msgstr "创建变更记录时无法读取 %r"
 msgid "The dummy builder generates no files."
 msgstr "伪构建器不生成文件。"
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "ePub文件保存在 %(outdir)s。"
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_language”（或“language”）不能为空"
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_uid”应为 XML 名称"
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_title”（或“html_title”）不能为空"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_author”不能为空"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_contributor”不能为空"
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_description”不能为空"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_publisher”不能为空"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_copyright”（或“copyright”）不能为空"
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_identifier”不能为空"
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“version”不能为空"
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "无效的 css_file：%r，已忽略"
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "消息目录保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr "%d 个模板文件的目标文件"
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr "读取模板... "
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr "写入消息目录... "
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "在上述输出或 %(outdir)s/output.txt 中检查错误"
 
-#: sphinx/builders/linkcheck.py:150
-#, python-format
-msgid "Anchor '%s' not found"
-msgstr "锚点“%s”未找到"
-
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:261
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "损坏的链接：%s(%s)"
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/linkcheck.py:454
+#, python-format
+msgid "Anchor '%s' not found"
+msgstr "锚点“%s”未找到"
+
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "手册页保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "未找到“man_pages”配置项，不会写入手册页"
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr "写作"
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "\"man_pages\"配置值引用未知文档 %s"
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML 页面保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr "组装单一文档"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr "写入其他文件"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Texinfo 文件保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\n在该目录下运行“make”命令以通过 makeinfo 运行这些 Texinfo文件\n（在此处用“make info”即可自动执行）。"
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "未找到“texinfo_documents”配置项，不会写入文档"
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "配置项“texinfo_documents”引用了未知文档 %s"
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr "处理 %s"
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr "解析引用……"
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr " (在 "
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr "复制 Texinfo 支持文件"
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "错误写入文件 Makefile： %s"
@@ -863,18 +893,18 @@ msgstr "错误写入文件 Makefile： %s"
 msgid "The text files are in %(outdir)s."
 msgstr "文本文件保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "写入文件 %s 时发生错误：%s"
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "XML 文件保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "伪 XML 文件保存在 %(outdir)s。"
@@ -889,290 +919,302 @@ msgstr "构建信息文件损坏：%r"
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTML 页面保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "读取构建信息文件失败：%r"
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y 年 %m 月 %d 日"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr "配置项 html_user_opensearch 必须为字符串"
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "总目录"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "索引"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "下一页"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "上一页"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
-msgstr ""
+msgstr "正在生成索引"
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
-msgstr ""
+msgstr "正在写入附加页面"
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr "复制可下载文件... "
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "无法复制可下载文件 %r：%s"
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
-msgstr "复制静态文件... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "无法复制静态文件 %r"
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
-msgstr ""
+msgstr "正在复制额外文件"
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "无法复制额外文件 %r"
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "写入构建信息文件失败：%r"
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "无法加载搜索索引，不会构建所有文档：索引将不完整。"
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "页面 %s 匹配了 html_sidebars 中的两条规则：%r 和 %r"
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "渲染页面 %s 时发生了 Unicode 错误。请确保所有包含非 ASCII 字符的配置项是 Unicode 字符串。"
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "渲染页面 %s 时发生了错误。\n原因：%r"
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
-msgstr ""
+msgstr "正在导出对象清单"
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
-msgstr ""
+msgstr "正在导出 %s 的搜索索引"
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "无效的 js_file：%r，已忽略"
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "注册了多个 math_renderers。但没有选择任何 math_renderer。"
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "给定了未知的 math_renderer %r。"
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path 指向的 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "html_extra_path 入口 %r 置于输出目录内"
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "html_static_path 指向的 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "html_static_path 入口 %r 置于输出目录内"
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "logo文件 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "网站图标 文件 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s 文档"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTex 文件保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\n在该目录下运行“make”以通过 (pdf)latex 运行这些 LaTex 文件\n（在此处用“make latexpdf”即可自动执行）。"
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "未找到“latex_documents”配置项，不会写入文档"
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "配置项“latex_documents”引用了未知文档 %s"
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "索引"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "发布"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "没有语种 %r 的 Babel 选项"
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr "复制 TeX 支持文件"
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr "复制 TeX 支持文件……"
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr "复制其他文件"
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
+msgstr "未知配置项：latex_elements[%r]，已忽略。"
+
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
-msgstr ""
+msgstr "%r 未包含 \"theme\" 配置"
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
-msgstr ""
+msgstr "%r 未包含 \"%s\" 配置"
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr "构建时抛出异常，启动调试器："
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
-msgstr ""
+msgstr "已中断！"
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr "reST 标记错误："
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr "编码错误："
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "如果你想向开发者报告问题，可以查阅已经保存在 %s 的完整 Traceback 信息 。"
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr "递归错误："
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr "在源文件过大或嵌套层数过深时会出现此错误。你可以在 conf.py 中增大默认的Python 递归 1000 层限制，像这样："
+msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr "抛出异常："
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "如果此处抛出了用户的错误，也请向我们报告，这样以后可以显示更友好、更详细的错误信息。"
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "请向 Bug 追踪系统 <https://github.com/sphinx-doc/sphinx/issues> 投递 Bug 报告。谢谢！"
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr "工作编号应为正值"
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr "更多信息请访问 <http://sphinx-doc.org/>。"
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1189,279 +1231,273 @@ msgid ""
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr "\n从源文件生成文档。\n\nsphinx-build 从 SOURCEDIR 中的文件生成文档，并保存在 OUTPUTDIR。\n它从 SOURCEDIR 的“conf.py” 中读取配置。“sphinx-quickstart”工具可以生\n成包括“conf.py”在内的模板文件。\n\nsphinx-build 可以生成多种格式的文档。在命令行中指定构建器名称即可\n选择文档格式，默认是 HTML。构建器也可以执行文档处理相关的其他\n任务。\n\n默认只会重新构建过期内容。如果指定了文件名，那么只会产生这些文件\n的输出。\n"
+msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr "文档源文件的路径"
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr "输出目录的路径"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "指定重新构建的文件列表。如果指定了 -a 参数，则忽略此项"
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr "通用选项"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr "构建器（默认：html）"
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr "写入所有文件（默认：只写入新文件和修改过的文件）"
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr "不使用已保存的环境，始终读取全部文件"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "缓存环境和 doctree 文件路径（默认：OUTPUTDIR/.doctrees）"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "如果可能，用 N 个进程并行构建文档（如果指定为“auto”，则 N 为 CPU 数量）"
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "配置文件（conf.py）所在目录路径（默认：与 SOURCEDIR 相同）"
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "只用 -D 选项时，不会采用任何配置文件"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "覆盖配置文件中的配置项"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "向 HTML 模板传值"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "定义标签，用于把涉及此 TAG 的“only”块的内容包含进来"
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "挑刺模式，在引用失败时报警"
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "控制台输出选项"
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "输出更详细的日志（甚至可能重复）"
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr "不输出到 stdout，只在 stderr 上输出报警"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "无任何输出，报警也不会输出"
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "着色输出（默认：自动检测）"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "不着色输出（默认：自动检测）"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "把警告（包含错误）信息写入给定的文件"
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "把警告视为错误"
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
-msgstr ""
+msgstr "与 -W 配合使用，在警告时继续运行"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "发生异常时显示完整回溯信息"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "发生异常时运行 Pdb"
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr "无法找到文件 %r"
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr "-a 选项和文件名不能同时使用"
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "无法打开警告信息文件 %r：%s"
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr "-D 选项的参数必须是 name=value 形式"
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr "-A 选项的参数必须是 name=value 形式"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr "自动插入模块中的 Docstring"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr "自动测试 doctest 块中的测试代码片段"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr "链接不同项目的 Sphinx 文档"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "编写在构建时可以选择显示、隐藏的“todo”条目"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr "检查文档覆盖率"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr "支持数学公式，渲染成 PNG 或 SVG 图像"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr "支持数学公式，用 MathJax 在浏览器中渲染"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr "基于配置值控制是否在构建中包含文档内容"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr "支持链接到文档涉及的 Python 对象的源码"
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "创建 .nojekyll 文件，用于在 GitHub Pages 服务发布文档"
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr "请输入有效的路径名。"
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr "请输入文本。"
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr "请输入 %s 之一。"
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr "请输入“y”或“n”。"
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "请输入文件后缀，例如：“.rst”或者“.txt”。"
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr "* 提示：输入了非 ASCII 字符并且终端编码未知——假定为 UTF-8 或 Latin-1。"
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "欢迎使用 Sphinx %s 快速配置工具。"
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
-msgstr ""
+msgstr "请输入接下来各项设置的值（如果方括号中指定了默认值，直接\n按回车即可使用默认值）。"
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
-msgstr ""
+msgstr "已选择根路径：%s"
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
-msgstr ""
+msgstr "输入文档的根路径。"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr "文档的根路径"
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "错误：选择的根路径中已存在 conf.py 文件。"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart 不会覆盖已有的 Sphinx 项目。"
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "请输入新的根路径（或按回车退出）"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
-msgstr ""
+msgstr "有两种方式来设置 Sphinx 输出的创建目录：\n一是在根路径下创建“_build”目录，二是在根路径下创建“source”\n和“build”两个独立的目录。"
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr "独立的源文件和构建目录（y/n）"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
-msgstr ""
+msgstr "这个选项将在根目录中创建两个文件夹：“_templates”用于自定义 HTML 模板文件，“_static”用于自定义样式表及其他静态文件。您可以输入其它的前缀（比如“.”）代替下划线。"
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr "模板目录名和静态目录名的前缀"
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
-msgstr ""
+msgstr "项目名称将会出现在文档的许多地方。"
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr "项目名称"
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr "作者名称"
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1470,15 +1506,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr "项目版本"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr "项目发行版本"
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1486,115 +1522,115 @@ msgid ""
 "\n"
 "For a list of supported codes, see\n"
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
-msgstr ""
+msgstr "如果用英语以外的语言编写文档，\n你可以在此按语言代码选择语种。\nSphinx 会把内置文本翻译成相应语言的版本。\n\n支持的语言代码列表见：\nhttp://sphinx-doc.org/config.html#confval-language。"
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr "项目语种"
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr "源文件后缀"
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
 "of the documents. Normally, this is \"index\", but if your \"index\"\n"
 "document is a custom template, you can also set this to another filename."
-msgstr ""
+msgstr "这其中有一种特殊的文档被视作“目录树”的树顶节点，即文档层级\n结构的根。通常情况下，这个文档是“index”，但是如果你的“index”文\n档使用了自定义模板，你也可以使用其它文件名。"
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr "主文档文件名（不含后缀）"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "错误：选择的根目录下已存在主文档文件 %s。"
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart 不会覆盖已有的文件。"
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "请输入新文件名，若要重命名现有文件请按回车"
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "启用 Sphinx 扩展："
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "注意：imgmath 和 mathjax 不能同时启用。已取消选择 imgmath。"
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
-msgstr ""
+msgstr "生成 Makefile 和 Windows 批处理文件，可以直接像“make html”这样\n运行，而不需要直接调用 sphinx-build。"
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr "创建 Makefile？（y/n）"
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr "创建 Windows 批处理文件？（y/n）"
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr "创建文件 %s。"
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "文件 %s 已存在，跳过。"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr "完成：已创建初始目录结构。"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
-msgstr ""
+msgstr "你现在可以填写主文档文件 %s 并创建其他文档源文件了。 "
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
-msgstr ""
+msgstr "用 Makefile 构建文档，例如：\n make builder"
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
-msgstr ""
+msgstr "用 sphinx-build 命令构建文档，像这样：\n sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
-msgstr ""
+msgstr "此处的“builder”是支持的构建器名，比如 html、latex 或 linkcheck。"
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1604,787 +1640,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\n生成 Sphinx 项目的必需文件。\n\nsphinx-quickstart 是一个交互式工具，询问一些关于项目的问题，生成\n完整的文档目录和用于 sphinx-build 的示例 Makefile。\n"
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr "静默模式"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
-msgstr ""
+msgstr "项目根目录"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr "文档结构参数"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr "如果指定了此选项，将使用独立的源文件目录和构建目录"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr "用点替代下划线，“ _templates”。"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr "项目基本参数"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr "项目名称"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr "作者名称"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr "项目版本"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr "项目发行版本"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr "项目语种"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr "源文件后缀"
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr "主文档名"
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr "启用 ePub 支持"
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr "扩展程序选项"
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr "启用 %s 扩展"
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr "启用多个扩展"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr "创建 Makefile 和批处理文件"
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr "创建 Makefile"
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr "不创建 Makefile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr "创建批处理文件"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr "不创建批处理文件"
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr "使用用于 Makefile/make.bat 的 Make 模式"
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "不使用用于 Makefile/make.bat 的 Make 模式"
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr "项目模板"
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr "放置模板文件的模板目录"
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr "定义一个模板变量"
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "指定了“quiet”，但是没有指定“project”和“author”。"
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "错误：指定的路径不是一个目录，或是 Sphinx 文件已存在。"
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart 只会在空目录中生成文件。请指定一个新的根路径。"
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "无效模板变量：%s"
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
-msgstr "检测到过度的去缩进"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
+msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "无效的标题：%s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "指定的行号超出范围（1-%d）：%r"
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "\"%s\" 和 \"%s\" 选项不能同时使用"
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "包含的文件 %r 不存在或读取失败"
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
-msgstr "用于读取包含文件 %r 的编码 %r 不正确，请重新给定 :encoding: 选项"
+msgstr "用于读取包含文件 %r 的编码 %r 不正确，请重新给定 encoding: 选项"
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "对象 %r 在包含文件 %r 中不存在"
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "不能在互斥的 \"lines\" 集合上使用 \"lineno-match\" 选项"
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "行规范 %r：未能从包含文件 %r 中拉取行"
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "节作者： "
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "模块作者： "
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "代码作者： "
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "作者： "
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "参数"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "返回"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "返回类型"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C 函数)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C 成员)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C 宏)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C 类型)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "成员"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C 变量)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "变量"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "函数"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "成员"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "宏"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr "联合体"
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "枚举"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "枚举子"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "类型"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "变量"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "%s 新版功能"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "在 %s 版更改"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "%s 版后已移除"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "重复的引文 %s，已有引文出现在 %s"
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "引文 [%s] 没有被引用过。"
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
-msgstr "重复的声明，已经在“%s”处定义。\n定义为“%s”。"
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "模板参数"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "抛出"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "类"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr "联合体"
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "概念"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "枚举"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "枚举子"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
-msgstr "重复的声明，已经在“%s”处定义。\n声明名称为“%s”。"
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
+msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (內置函数)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s 方法)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (类)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (全局变量或常量)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s 属性)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "参数"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (模块)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "方法"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "数据"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "属性"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "模块"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
-msgstr ""
+msgstr "对%s重复的描述 %s，其它的%s出现在 %s"
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "重复的公式标签 %s，另一实例出现在 %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "无效的 math_eqref_format：%r"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "关键字"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "运算符"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "对象"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "例外"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "语句"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "內置函数"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "变量"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "引发"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (在 %s 模块中)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (內置变量)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s() (在 %s 模块中)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (內置变量)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (內置类)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s 中的类)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s 方法)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s 类方法)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s 静态方法)"
+msgid "%s() (%s property)"
+msgstr "%s() (%s 所有权)"
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s 静态方法)"
 
-#: sphinx/domains/python.py:638
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s 类方法)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s 类方法)"
-
-#: sphinx/domains/python.py:651
-#, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s 属性)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python 模块索引"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "模块"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "已移除"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "类方法"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "静态方法"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
-msgstr ""
+msgstr "重复的对象描述%s ，另一实例出现在使用 noindex 中：对它们其中的一个 %s"
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "交叉引用 %r 找到了多个目标：%s"
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr " (已移除)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (指令)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
-msgstr ""
+msgstr "%s (指令选项)"
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (角色)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "指令"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
-msgstr ""
+msgstr "指令-选项"
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "角色"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
-msgstr ""
+msgstr "重复的引文 %s%s，已有引文出现在 %s"
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "环境变量; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "畸形的选项描述 %r，应是“opt”、“-opt args”、“--opt args”、“/opt args”或“+opt args”形式"
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
-msgstr ""
+msgstr "%s命令行选项"
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
-msgstr ""
+msgstr "命令行选项"
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
-msgstr ""
+msgstr "词汇必须在空行之前"
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
-msgstr ""
+msgstr "词汇必须用空行分隔"
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
-msgstr ""
+msgstr "看起来形式不对的词汇建议检查缩进"
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "术语"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "语法记号"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "引用标签"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "环境变量"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "程序选项"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr "文档"
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "模块索引"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "搜索页面"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "重复的标签 %s，已有标签出现在 %s"
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
-msgstr ""
+msgstr "对 %s的重复描述%s，其它实例出现在 %s"
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig 已禁用，忽略 :numref:。"
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
-msgstr "没有给 %s 分配标号：%s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
+msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "链接没有标题：%s"
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "无效的 numfig_format：%s (%r)"
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "无效的 numfig_format：%s"
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "新配置"
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "配置有变化"
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "扩展有变化"
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr "构建环境版本与当前环境不符"
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr "源文件目录已变化"
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "本环境与选择的构建器不兼容，请选择其他的文档树目录。"
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "在 %s 中扫描文档失败：%r"
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "没有注册 %r 域"
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr "目录树存在自引用，已忽略。"
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr "文档没有加入到任何目录树中"
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "见 %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "参见 %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "未知的索引条目类型 %r"
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "符号"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "在文档树中检测到循环引用，已忽略：%s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "目录树引用的文档 %r 缺少标题：不会生成链接"
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree已包含对排除文档的引用 %r"
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "目录树引用的文档 %r 不存在"
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr "无法读取图像文件：%s"
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "无法读取图像文件 %s：%s"
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr "无法读取下载文件：%s"
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "已经给 %s 分配了章节编号（嵌套的带编号文档树？）"
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr "将会创建文件 %s。"
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2396,168 +2421,188 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr "\n在 <MODULE_PATH> 中递归查找 Python 模块和包，然后在 <OUTPUT_PATH> 中为每个使用了\nautomodule 指令的包创建一个 reST 文件。\n\n<EXCLUDE_PATTERN> 可以排除生成符合规则的文件/目录的文档。\n\n提示：本脚本默认不会覆盖已有文件。"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr "要生成文档的模块路径"
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "排除的文件/目录，fnmatch 风格的规则"
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr "输出的目录"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "在目录树中显示的子模块最大深度（默认：4）"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr "覆盖已有文件"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "遵循符号链接。配合 collective.recipe.omelette 使用尤其奏效。"
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr "运行脚本，但不创建文件"
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr "模块有各自的文档页"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr "包含“_private”模块"
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr "目录文件名 (默认: 模块)"
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr "不创建目录文件"
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "不创建模块/包的标题（比如当 Docstring 中已经有标题时，可以使用这个选项）"
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr "模块文档先于子模块文档"
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "根据 PEP-0420 隐式命名空间规范解释模块路径"
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr "文件后缀（默认：rst）"
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr "用 sphinx-quickstart 生成完整项目"
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "当指定了 --full 选项，把 module_path 附加到 sys.path"
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr "项目名称（默认：根模块名）"
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr "项目作者，指定了 --full 选项时使用"
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr "项目版本，指定了 --full 选项时使用"
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "项目发行版本，指定了 --full 选项时使用，默认与 --doc-version 等同"
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr "扩展选项"
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s 不是一个目录。"
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "无效的正则表达式 %r 在 %s"
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "已完成源文件的覆盖率测试，请在 %(outdir)s/python.txt 中查看结果。"
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "coverage_c_regexes 中有无效的正则表达式 %r"
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "无法导入模块 %s：%s"
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "'%s' 选项中缺少 '+' 或 '-'。"
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' 不是一个有效选项。"
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' 不是一个有效的 pyversion 选项"
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr "无效的 TestCode 类型"
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "已完成源文件的文档测试，请在 %(outdir)s/output.txt 中查看结果。"
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "块 %s 没有代码或没有输出，出现在 %s:%s"
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "y已忽略无效的文档代码：%r"
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
-msgstr ""
+msgstr "====================== 最长阅读时长 ======================="
 
 #: sphinx/ext/graphviz.py:132
 msgid "Graphviz directive cannot have both content and a filename argument"
@@ -2568,11 +2613,11 @@ msgstr "Graphviz 指令不能同时指定内容和文件名参数"
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "外部 Graphviz 文件 %r 不存在或读取失败"
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "已忽略无内容的 \"graphviz 指令。"
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2582,14 +2627,14 @@ msgid ""
 "%r"
 msgstr "dot没有生成输出文件:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "无法运行 Dot 命令 %r (Graphviz 输出所需)，请检查 graphviz_dot 配置"
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2599,29 +2644,30 @@ msgid ""
 "%r"
 msgstr "点退出错误:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format 必须是 'png' 或 'svg' 中之一，现为 %r"
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr "点 代码 %r: %s"
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[图表：%s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[图表]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2634,148 +2680,158 @@ msgid ""
 "%r"
 msgstr "转换退出时出错:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr "格式转换命令 %r 不能执行。请检查 image_converter 设置"
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "无法运行 LaTeX 命令 %r （数学公式显示必需），请检查 imgmath_latex 设置"
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "无法运行 %s 命令 %r （数学公式显示必需），请检查 imgmath_%s 设置"
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr "显示 LaTeX %r：%s"
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "内联 LaTeX %r：%s"
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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 "intersphinx库存已被移动: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:204
+#: sphinx/ext/intersphinx.py:205
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "从中加载intersphinx库存 %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 "遇到了一些库存问题，但他们有其他工作方式："
 
-#: 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(在 %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr "(在 %s)"
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "跨 Sphinx 标识 %r 不是字符串，已忽略"
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
-msgstr ""
+msgstr "无法读取intersphinx_mapping[%s]，忽略：%r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[源代码]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "待处理"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "已发现 TODO 条目：%s"
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> 见 %s，第 %d 行。)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "原始记录"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr "突出显示模块代码... "
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[文档]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "模块代码"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s 源代码</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "概览：模块代码"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>代码可用的所有模块</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "无效的 auto%s 签名（%r）"
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "格式化 %s 参数时报错：%s"
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "属性 %s 不存在，在对象 %s 上"
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autodoc：无法判断是否生成 %r 的文档。出现了下列异常：\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2783,104 +2839,157 @@ msgid ""
 "explicit module name)"
 msgstr "无法判断导入哪个模块来自动生成文档 %r（尝试在文档中使用“module”或“currentmodule”指令，或者显式给定模块名）"
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "automodule 名中的“::”无意义"
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "automodule %s 给定了函数签名参数或返回类型标注"
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__  应是一个字符串列表，而不是 %r （出现在模块 %s 中） -- 已忽略__all__"
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
-msgstr ":members: 或 __all__ 提及的属性不存在：模块 %s，属性 %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "基类：%s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr ":class:`%s` 的别名"
+msgid "alias of %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:1832
 #, python-format
-msgid "Failed to parse type_comment for %r: %s"
+msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "autosummary references excluded document %r. Ignored."
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autodoc/type_comment.py:133
+#, python-format
+msgid "Failed to parse type_comment for %r: %s"
+msgstr "无法解析 type_comment %s"
+
+#: sphinx/ext/autosummary/__init__.py:259
+#, python-format
+msgid "autosummary references excluded document %r. Ignored."
+msgstr "autosummary 引用了排除的文档 %r。已忽略。"
+
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
+msgstr "autosummary：无法找到根文件 %r。检查你的 autosummary_generate 设置。"
+
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
-msgstr "无法导入 %s"
+msgid "autosummary: failed to import %s"
+msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr "无法解析名称 %s"
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr "无法导入对象 %s"
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
-msgstr ""
+msgstr "autosummary_generate：无法找到文件 %s"
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary 内部生成 .rst 文件，但是 source_suffix 中不包含 .rst，已跳过。"
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autosummary：无法判断是否生成 %r 的文档。出现了下列异常：\n%s"
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr "[autosummary] 生成 autosummary：%s"
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr "[autosummary] 写入 %s"
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
-msgstr ""
+msgstr "[autosummary] failed to import %r：%s"
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2895,107 +3004,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\n用 autosummary 指令生成 ReStructuredText\n\nsphinx-autogen 是 sphinx.ext.autosummary.generate 的前端，它根据给定\n的输入文件中的 autosummary 指令生成 reStructuredText  文件\n\nautosummary 指令的格式见 Python 模块 ``sphinx.ext.autosummary`` 的文\n档，并且可以这样调出文档阅读::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr "用于生成 rST 文件的源文件"
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr "输出目录"
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "默认的文件名后缀（默认：%(default)s）"
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "自定义模板目录（默认：%(default)s）"
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "文档导入的成员（默认：%(default)s）"
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "关键字参数"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr "示例"
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr "实际案例"
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr "提示"
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr "其他参数"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr "引用"
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr "警告"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr "生成器"
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "注意"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
-msgstr "警告"
+msgstr "小心"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "危险"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "错误"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "提示"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "重要"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "注解"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "参见"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "小技巧"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "警告"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "续上页"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "下页继续"
@@ -3012,181 +3145,181 @@ msgstr "数值"
 msgid "page"
 msgstr "页"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr "目录"
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "搜索"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "转向"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "显示源代码"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "概述"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "欢迎！这是"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "这份文档是"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "最后更新于"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "索引和表格："
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "完整的内容表"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "列出所有的章节和部分"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "搜索文档"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "全局模块索引"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "快速查看所有的模块"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "所的函数，类，术语"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "索引 &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "一页的全部索引"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "按照字母的索引页"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "可能会很多"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "导航"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "在 %(docstitle)s 中搜索"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "关于这些文档"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "版权所有"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\"> 版权所有</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; 版权所有 %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "最后更新于 %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "由 <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s 创建。"
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "搜索 %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "上一个主题"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "上一章"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "下一个主题"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "下一章"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "请激活 JavaScript 以开启搜索功能。"
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
-msgstr ""
+msgstr "搜寻包含多个字的词汇时，\n    只有所含所有内容都匹配时才会出现。"
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "搜索"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "搜索结果"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "没有任何文档匹配您的搜索。请确保你输入的词拼写正确并选择了合适的分类。"
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "快速搜索"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "本页"
 
@@ -3218,19 +3351,19 @@ msgstr "C API 更改"
 msgid "Other changes"
 msgstr "其他更改"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "永久链接至标题"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "永久链接至目标"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "隐藏搜索结果"
 
@@ -3242,12 +3375,12 @@ msgstr "搜索中"
 msgid "Preparing search..."
 msgstr "准备搜索……"
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "搜索完成，有 %s 个页面匹配。"
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr "， 在 "
 
@@ -3260,7 +3393,7 @@ msgstr "展开边栏"
 msgid "Collapse sidebar"
 msgstr "折叠边栏"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "目录"
 
@@ -3279,199 +3412,207 @@ msgstr "脚注 [%s] 没有被引用过。"
 msgid "Footnote [#] is not referenced."
 msgstr "脚注 [#] 没有被引用过。"
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "译文中的脚注引用与原文不一致。原始为：{0}，翻译后为：{1}"
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "译文中的引用与原文不一致。原始为：{0}，翻译后为：{1}"
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "译文中的引文引用与原文不一致。原始为：{0}，翻译后为：{1}"
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "译文中的术语引用与原文不一致。原始为：{0}，翻译后为：{1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "找到了多个目标 'any' 交叉引用的目标不唯一 %r: 可能是 %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
-msgstr "%s:%s 引用目标不存在：%%(target)s"
+msgid "%s:%s reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
-msgstr "%r 引用目标不存在：%%(target)s"
+msgid "%r reference target not found: %s"
+msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "无法获取远程图像：%s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr "无法获取远程图像：%s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "未知的图像格式：%s……"
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "源码中存在编码无法识别的字符，已经替换为“?”：%r"
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr "跳过"
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr "失败"
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "读取时发生错误：%s，%s"
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "写入时发生错误：%s，%s"
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "无效的日期格式。如果你想直接输出日期字符串，请用单引号：%s"
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "目录树引用的文件 %r 不存在"
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "only 指令表达式求值时抛出异常：%s"
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr "对评估 Python 2 语法的支持已弃用，将在狮身人面像 4.0 中删除。将 %s 转换为 Python 3 语法。"
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "默认角色 %s 未找到"
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "未定义 %s 的 numfig_format"
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "没有给 %s 节点分配 ID"
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "永久链接至表格"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "永久链接至代码"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "永久链接至图片"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "永久链接至目录树"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "无法获取图像尺寸，已忽略 :scale: 选项。"
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "未知的 %r toplevel_sectioning，用于 %r 类"
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr "过大的 :mathdepth:，已忽略。"
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr "文档标题不是一个单纯文本节点"
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "在节、话题、表格、警示或边栏以外的位置发现标题节点"
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "脚注"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "给出了表格列和 ：width：选项。：宽度：被忽略。"
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "无效的量纲单位 %s，已忽略。"
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "发现未知的索引条目类型 %s"
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[图片： %s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[图片]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr "在图示之外发现了图示标题。"
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "未实现的节点类型：%r"
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr "未知节点类型：%r"
diff --git a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po
index 435fe0453b8..a8a49978231 100644
--- a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po
@@ -1,9 +1,9 @@
 # Translations template for Sphinx.
-# Copyright (C) 2020 ORGANIZATION
+# Copyright (C) 2021 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-#
+# 
 # Translators:
-# Adrian Liaw <adrianliaw2000@gmail.com>, 2018
+# Wey-Han Liaw <adrianliaw2000@gmail.com>, 2018
 # Fred Lin <gasolin@gmail.com>, 2008
 # Game Arming <fleasw@yahoo.com.tw>, 2017
 # Hsiaoming Yang <me@lepture.com>, 2018
@@ -13,141 +13,146 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2020-03-14 19:50+0900\n"
-"PO-Revision-Date: 2020-03-14 10:53+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2021-04-12 00:27+0900\n"
+"PO-Revision-Date: 2021-04-11 15:28+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
 "Language-Team: Chinese (Taiwan) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.9.0\n"
 "Language: zh_TW\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:159
+#: sphinx/application.py:158
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/application.py:163
+#: sphinx/application.py:162
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:167
+#: sphinx/application.py:166
+#, python-format
+msgid "Output directory (%s) is not a directory"
+msgstr ""
+
+#: sphinx/application.py:170
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:198
+#: sphinx/application.py:201
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:202
+#: sphinx/application.py:205
 msgid ""
 "For security reason, parallel mode is disabled on macOS and python3.8 and "
 "above. For more details, please read https://github.com/sphinx-"
 "doc/sphinx/issues/6803"
 msgstr ""
 
-#: sphinx/application.py:226
+#: sphinx/application.py:229
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "本專案需要 Sphinx v%s 版本以上，故無法以現版本編譯。"
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:251 sphinx/registry.py:399
+#: sphinx/application.py:254 sphinx/registry.py:417
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:257
+#: sphinx/application.py:260
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "目前在 conf.py 裡指定的 'setup' 並非一個 Python 的可呼叫物件。請修改它並使它成為一個可呼叫的函式。若要使 conf.py 以 Sphinx 擴充套件的方式運作，這個修改是必須的。"
 
-#: sphinx/application.py:282
+#: sphinx/application.py:285
 #, python-format
 msgid "loading translations [%s]... "
 msgstr ""
 
-#: sphinx/application.py:296 sphinx/util/__init__.py:646
+#: sphinx/application.py:302 sphinx/util/__init__.py:522
 msgid "done"
 msgstr "完成"
 
-#: sphinx/application.py:298
+#: sphinx/application.py:304
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:308
+#: sphinx/application.py:314
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:313
+#: sphinx/application.py:319
 #, python-format
 msgid "failed: %s"
 msgstr "失敗：%s"
 
-#: sphinx/application.py:321
+#: sphinx/application.py:327
 msgid "No builder selected, using default: html"
 msgstr "沒有指定 builder，使用預設：html"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:355
 msgid "succeeded"
 msgstr "成功"
 
-#: sphinx/application.py:350
+#: sphinx/application.py:356
 msgid "finished with problems"
 msgstr "完成問題"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:360
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:356
+#: sphinx/application.py:362
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:359
+#: sphinx/application.py:365
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:361
+#: sphinx/application.py:367
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:365
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:554
+#: sphinx/application.py:601
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:628
+#: sphinx/application.py:679
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:646 sphinx/application.py:664
+#: sphinx/application.py:700 sphinx/application.py:721
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1124
+#: sphinx/application.py:1232
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -155,12 +160,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1128
+#: sphinx/application.py:1236
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1131
+#: sphinx/application.py:1239
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -168,59 +173,59 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1135
+#: sphinx/application.py:1243
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1143 sphinx/application.py:1147
+#: sphinx/application.py:1251 sphinx/application.py:1255
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:191
+#: sphinx/config.py:193
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:200
+#: sphinx/config.py:202
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:205
+#: sphinx/config.py:207
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:233
+#: sphinx/config.py:235
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:250
+#: sphinx/config.py:252
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:274
+#: sphinx/config.py:276
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:321
+#: sphinx/config.py:325
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:324
+#: sphinx/config.py:328
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:335
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -228,58 +233,51 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:357
+#: sphinx/config.py:361
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:364
+#: sphinx/config.py:380
 #, python-format
 msgid "Section %s"
 msgstr "段落 %s"
 
-#: sphinx/config.py:365
+#: sphinx/config.py:381
 #, python-format
 msgid "Fig. %s"
 msgstr "圖 %s"
 
-#: sphinx/config.py:366
+#: sphinx/config.py:382
 #, python-format
 msgid "Table %s"
 msgstr "表 %s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:383
 #, python-format
 msgid "Listing %s"
 msgstr "程式 %s"
 
-#: sphinx/config.py:404
+#: sphinx/config.py:420
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:422
+#: sphinx/config.py:438
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:435
+#: sphinx/config.py:451
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:453
-#, python-format
-msgid ""
-"the config value %r is set to a string with non-ASCII characters; this can "
-"lead to Unicode errors occurring. Please use Unicode strings, e.g. %r."
-msgstr ""
-
 #: sphinx/config.py:461
 #, python-format
 msgid "primary_domain %r not found, ignored."
@@ -287,405 +285,430 @@ msgstr "找不到 primary_domain：%r，略過。"
 
 #: sphinx/config.py:473
 msgid ""
-"Since v2.0, Sphinx uses \"index\" as master_doc by default. Please add "
-"\"master_doc = 'contents'\" to your conf.py."
+"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
+"\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:71
+#: sphinx/events.py:67
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:77
+#: sphinx/events.py:73
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/extension.py:51
+#: sphinx/events.py:109
+#, python-format
+msgid "Handler %r for event %r threw an exception"
+msgstr ""
+
+#: sphinx/extension.py:50
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:56
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:121
+#: sphinx/highlighting.py:135
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:161
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:61
+#: sphinx/project.py:53
+#, python-format
+msgid ""
+"multiple files found for the document \"%s\": %r\n"
+"Use %r for the build."
+msgstr ""
+
+#: sphinx/project.py:59
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:126
+#: sphinx/registry.py:129
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:128
+#: sphinx/registry.py:131
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:148
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:178 sphinx/registry.py:191 sphinx/registry.py:202
+#: sphinx/registry.py:181 sphinx/registry.py:194 sphinx/registry.py:205
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:182
+#: sphinx/registry.py:185
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:194
+#: sphinx/registry.py:197
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:205
+#: sphinx/registry.py:208
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:229
+#: sphinx/registry.py:232
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:249
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:256
+#: sphinx/registry.py:259
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:266
+#: sphinx/registry.py:269
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:275
+#: sphinx/registry.py:278
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:301
+#: sphinx/registry.py:307
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:313
+#: sphinx/registry.py:320
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:374
+#: sphinx/registry.py:392
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:383
+#: sphinx/registry.py:401
 #, python-format
 msgid "math renderer %s is already registred"
 msgstr ""
 
-#: sphinx/registry.py:393
+#: sphinx/registry.py:411
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:404
+#: sphinx/registry.py:422
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:405
+#: sphinx/registry.py:423
 #, python-format
 msgid "Could not import extension %s"
 msgstr "無法引入擴充套件 %s"
 
-#: sphinx/registry.py:409
+#: sphinx/registry.py:428
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:418
+#: sphinx/registry.py:437
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:426
+#: sphinx/registry.py:445
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:221 sphinx/roles.py:271
+#: sphinx/roles.py:177
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/theming.py:78
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:86
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:109
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:128
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:225
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:240
 msgid ""
-"sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please "
-"install it manually.(pip install sphinx_rtd_theme)"
+"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:247
+#: sphinx/theming.py:245
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:195
+#: sphinx/builders/__init__.py:191
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:199
+#: sphinx/builders/__init__.py:195
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:219
+#: sphinx/builders/__init__.py:215
 msgid "building [mo]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:220 sphinx/builders/__init__.py:539
-#: sphinx/builders/__init__.py:565
+#: sphinx/builders/__init__.py:216 sphinx/builders/__init__.py:534
+#: sphinx/builders/__init__.py:560
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:228
+#: sphinx/builders/__init__.py:224
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:246
+#: sphinx/builders/__init__.py:242
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:253
+#: sphinx/builders/__init__.py:249
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:260
+#: sphinx/builders/__init__.py:256
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:273
+#: sphinx/builders/__init__.py:268
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:277
+#: sphinx/builders/__init__.py:272
 #, python-format
 msgid "file %r given on command line does not exist, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:288
+#: sphinx/builders/__init__.py:283
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:298
+#: sphinx/builders/__init__.py:293
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:307 sphinx/builders/gettext.py:267
+#: sphinx/builders/__init__.py:302 sphinx/builders/gettext.py:240
 #, python-format
 msgid "building [%s]: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:314
+#: sphinx/builders/__init__.py:309
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:319
+#: sphinx/builders/__init__.py:314
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:316
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:326
+#: sphinx/builders/__init__.py:321
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:332
+#: sphinx/builders/__init__.py:327
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:336
+#: sphinx/builders/__init__.py:331
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:375
+#: sphinx/builders/__init__.py:370
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:396
+#: sphinx/builders/__init__.py:391
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:434 sphinx/builders/__init__.py:461
+#: sphinx/builders/__init__.py:429 sphinx/builders/__init__.py:456
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:466 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:461 sphinx/builders/__init__.py:570
 msgid "waiting for workers..."
 msgstr ""
 
-#: sphinx/builders/__init__.py:517
+#: sphinx/builders/__init__.py:512
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:526 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:521 sphinx/builders/singlehtml.py:154
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:211
+#: sphinx/builders/_epub_base.py:216
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:395 sphinx/builders/html/__init__.py:688
-#: sphinx/builders/latex/__init__.py:416 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:719
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402
+#: sphinx/builders/_epub_base.py:412
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:408 sphinx/builders/html/__init__.py:696
-#: sphinx/builders/latex/__init__.py:424 sphinx/builders/texinfo.py:187
+#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:727
+#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:425
+#: sphinx/builders/_epub_base.py:435
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:445
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:467 sphinx/builders/_epub_base.py:479
-#: sphinx/builders/_epub_base.py:513 sphinx/builders/_epub_base.py:694
-#: sphinx/builders/_epub_base.py:726 sphinx/builders/epub3.py:173
-#, python-format
-msgid "writing %s file..."
+#: sphinx/builders/_epub_base.py:471
+msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:539
+#: sphinx/builders/_epub_base.py:476
+msgid "writing META-INF/container.xml file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:504
+msgid "writing content.opf file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:530
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/changes.py:36
+#: sphinx/builders/_epub_base.py:677
+msgid "writing toc.ncx file..."
+msgstr ""
+
+#: sphinx/builders/_epub_base.py:702
+#, python-format
+msgid "writing %s file..."
+msgstr ""
+
+#: sphinx/builders/changes.py:34
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:60
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:64
+#: sphinx/builders/changes.py:62
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:78
 msgid "Builtins"
 msgstr "內建"
 
-#: sphinx/builders/changes.py:82
+#: sphinx/builders/changes.py:80
 msgid "Module level"
 msgstr "模組層次"
 
-#: sphinx/builders/changes.py:126
+#: sphinx/builders/changes.py:124
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:133
+#: sphinx/builders/changes.py:131
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
@@ -694,160 +717,164 @@ msgstr ""
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:65
+#: sphinx/builders/epub3.py:67
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:200
+#: sphinx/builders/epub3.py:165
+msgid "writing nav.xhtml file..."
+msgstr ""
+
+#: sphinx/builders/epub3.py:191
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:204
+#: sphinx/builders/epub3.py:195
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:207
+#: sphinx/builders/epub3.py:198
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:217
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:214
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:227
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:230
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:244 sphinx/builders/html/__init__.py:1060
+#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1120
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:246
+#: sphinx/builders/gettext.py:219
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:268
+#: sphinx/builders/gettext.py:241
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:272
+#: sphinx/builders/gettext.py:245
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:300
+#: sphinx/builders/gettext.py:273
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:78
+#: sphinx/builders/linkcheck.py:119
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:150
+#: sphinx/builders/linkcheck.py:261
 #, python-format
-msgid "Anchor '%s' not found"
+msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:259
+#: sphinx/builders/linkcheck.py:454
 #, python-format
-msgid "broken link: %s (%s)"
+msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:38
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:47
+#: sphinx/builders/manpage.py:45
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:292 sphinx/builders/manpage.py:58
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:111
+#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
+#: sphinx/builders/singlehtml.py:162 sphinx/builders/texinfo.py:109
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:69
+#: sphinx/builders/manpage.py:67
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:36
+#: sphinx/builders/singlehtml.py:35
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:157
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:175
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:45
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:49
+#: sphinx/builders/texinfo.py:47
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:77
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:85
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:275 sphinx/builders/texinfo.py:107
+#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:343 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:353 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
 msgid " (in "
 msgstr "(於"
 
-#: sphinx/builders/texinfo.py:192
+#: sphinx/builders/texinfo.py:191
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:196
+#: sphinx/builders/texinfo.py:195
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
@@ -857,18 +884,18 @@ msgstr ""
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1013 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:96
+#: sphinx/builders/html/__init__.py:1073 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:91
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:40
+#: sphinx/builders/xml.py:35
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:108
+#: sphinx/builders/xml.py:103
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
@@ -883,290 +910,302 @@ msgstr ""
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:344
+#: sphinx/builders/html/__init__.py:372
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:430 sphinx/builders/latex/__init__.py:192
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:112
-#: sphinx/writers/texinfo.py:237
+#: sphinx/builders/html/__init__.py:466 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:99
+#: sphinx/writers/texinfo.py:233
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y 年 %m 月 %d 日"
 
-#: sphinx/builders/html/__init__.py:439
-msgid "html_use_opensearch config value must now be a string"
-msgstr ""
-
-#: sphinx/builders/html/__init__.py:445 sphinx/themes/basic/defindex.html:29
+#: sphinx/builders/html/__init__.py:478 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "總索引"
 
-#: sphinx/builders/html/__init__.py:445
+#: sphinx/builders/html/__init__.py:478
 msgid "index"
 msgstr "索引"
 
-#: sphinx/builders/html/__init__.py:509
+#: sphinx/builders/html/__init__.py:540
 msgid "next"
 msgstr "下一頁"
 
-#: sphinx/builders/html/__init__.py:518
+#: sphinx/builders/html/__init__.py:549
 msgid "previous"
 msgstr "上一頁"
 
-#: sphinx/builders/html/__init__.py:612
+#: sphinx/builders/html/__init__.py:643
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:627
+#: sphinx/builders/html/__init__.py:658
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:706
+#: sphinx/builders/html/__init__.py:737
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:714
+#: sphinx/builders/html/__init__.py:745
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:762
-msgid "copying static files... "
+#: sphinx/builders/html/__init__.py:777 sphinx/builders/html/__init__.py:789
+#, python-format
+msgid "Failed to copy a file in html_static_file: %s: %r"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:810
+msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:778
+#: sphinx/builders/html/__init__.py:826
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:783
+#: sphinx/builders/html/__init__.py:831
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:789
+#: sphinx/builders/html/__init__.py:837
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:844
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:844
+#: sphinx/builders/html/__init__.py:892
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:913
+#: sphinx/builders/html/__init__.py:953
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:996
+#: sphinx/builders/html/__init__.py:1056
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1001
+#: sphinx/builders/html/__init__.py:1061
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1030
+#: sphinx/builders/html/__init__.py:1090
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1035
+#: sphinx/builders/html/__init__.py:1095
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1077
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1118
+#: sphinx/builders/html/__init__.py:1200
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/html/__init__.py:1203
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1129
+#: sphinx/builders/html/__init__.py:1211
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1133
+#: sphinx/builders/html/__init__.py:1215
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1142
+#: sphinx/builders/html/__init__.py:1224
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1146
+#: sphinx/builders/html/__init__.py:1228
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1153 sphinx/builders/latex/__init__.py:428
+#: sphinx/builders/html/__init__.py:1237 sphinx/builders/latex/__init__.py:433
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1160
+#: sphinx/builders/html/__init__.py:1246
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1179
+#: sphinx/builders/html/__init__.py:1266
+msgid ""
+"html_add_permalinks has been deprecated since v3.5.0. Please use "
+"html_permalinks and html_permalinks_icon instead."
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s 說明文件"
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:114
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:117
+#: sphinx/builders/latex/__init__.py:116
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:154
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:162
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:199 sphinx/domains/std.py:586
-#: sphinx/templates/latex/latex.tex_t:68
-#: sphinx/themes/basic/genindex-single.html:19
-#: sphinx/themes/basic/genindex-single.html:36
-#: sphinx/themes/basic/genindex-split.html:10
-#: sphinx/themes/basic/genindex-split.html:13
-#: sphinx/themes/basic/genindex.html:19 sphinx/themes/basic/genindex.html:22
-#: sphinx/themes/basic/genindex.html:44 sphinx/themes/basic/layout.html:51
-#: sphinx/writers/texinfo.py:502
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
+#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/themes/basic/genindex-single.html:30
+#: sphinx/themes/basic/genindex-single.html:55
+#: sphinx/themes/basic/genindex-split.html:11
+#: sphinx/themes/basic/genindex-split.html:14
+#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147
+#: sphinx/writers/texinfo.py:498
 msgid "Index"
 msgstr "索引"
 
-#: sphinx/builders/latex/__init__.py:202 sphinx/templates/latex/latex.tex_t:55
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
 msgid "Release"
 msgstr "發佈"
 
-#: sphinx/builders/latex/__init__.py:209 sphinx/writers/latex.py:388
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:374
+#: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:394
+#: sphinx/builders/latex/__init__.py:399
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:407
+#: sphinx/builders/latex/__init__.py:412
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:489
+#: sphinx/builders/latex/__init__.py:468
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:79
+#: sphinx/builders/latex/__init__.py:476
+#, python-format
+msgid "Unknown theme option: latex_theme_options[%r], ignored."
+msgstr ""
+
+#: sphinx/builders/latex/theming.py:91
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:81
+#: sphinx/builders/latex/theming.py:94
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:34
+#: sphinx/cmd/build.py:38
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:44
+#: sphinx/cmd/build.py:48
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:46
+#: sphinx/cmd/build.py:50
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:56
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:59
+#: sphinx/cmd/build.py:63
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:62
+#: sphinx/cmd/build.py:66
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:71
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:77
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:80
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:92
+#: sphinx/cmd/build.py:96
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:478
-#: sphinx/ext/apidoc.py:350 sphinx/ext/autosummary/generate.py:434
+#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:464
+#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:580
 msgid "For more information, visit <http://sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:101
+#: sphinx/cmd/build.py:105
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1185,277 +1224,271 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:122
+#: sphinx/cmd/build.py:126
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:124
+#: sphinx/cmd/build.py:128
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:130
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:129
+#: sphinx/cmd/build.py:133
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:136
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:138
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:141
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:144
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:150
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:161
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:164
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:166
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:373
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:181
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:219
+#: sphinx/cmd/build.py:223
 #, python-format
 msgid "cannot find files %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:222
+#: sphinx/cmd/build.py:226
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:245
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:251
+#: sphinx/cmd/build.py:255
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:258
+#: sphinx/cmd/build.py:262
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:58
+#: sphinx/cmd/quickstart.py:52
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:100
+#: sphinx/cmd/quickstart.py:94
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:104
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:111
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:118
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:124
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:153
-msgid ""
-"* Note: non-ASCII characters entered and terminal encoding unknown -- "
-"assuming UTF-8 or Latin-1."
-msgstr ""
-
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:205
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:207
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:234
+#: sphinx/cmd/quickstart.py:212
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:237
+#: sphinx/cmd/quickstart.py:215
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:216
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:221
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:223
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:225
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:232
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:235
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:239
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:242
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:246
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:269
+#: sphinx/cmd/quickstart.py:247
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:271
+#: sphinx/cmd/quickstart.py:249
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:275
+#: sphinx/cmd/quickstart.py:253
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1464,15 +1497,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:280
+#: sphinx/cmd/quickstart.py:258
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:260
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:286
+#: sphinx/cmd/quickstart.py:264
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1482,21 +1515,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:270
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:276
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:300
+#: sphinx/cmd/quickstart.py:278
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:304
+#: sphinx/cmd/quickstart.py:282
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1504,91 +1537,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:308
+#: sphinx/cmd/quickstart.py:286
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:291
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:315
+#: sphinx/cmd/quickstart.py:293
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:317
+#: sphinx/cmd/quickstart.py:295
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:321
+#: sphinx/cmd/quickstart.py:299
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:329
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:335
+#: sphinx/cmd/quickstart.py:313
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:338
+#: sphinx/cmd/quickstart.py:316
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:341
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:382 sphinx/ext/apidoc.py:107
+#: sphinx/cmd/quickstart.py:362 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:387 sphinx/ext/apidoc.py:104
+#: sphinx/cmd/quickstart.py:367 sphinx/ext/apidoc.py:87
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:409
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:411
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:428
+#: sphinx/cmd/quickstart.py:414
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:431
+#: sphinx/cmd/quickstart.py:417
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:433
+#: sphinx/cmd/quickstart.py:419
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:468
+#: sphinx/cmd/quickstart.py:454
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1598,787 +1631,776 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:483
+#: sphinx/cmd/quickstart.py:469
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:474
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:476
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:478
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:480
+msgid "if specified, create build dir under source dir"
+msgstr ""
+
+#: sphinx/cmd/quickstart.py:482
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:484
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:486
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:488
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:490
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:492
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:494
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:496
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510
+#: sphinx/cmd/quickstart.py:498
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512
+#: sphinx/cmd/quickstart.py:500
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:502
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:433
+#: sphinx/cmd/quickstart.py:506 sphinx/ext/apidoc.py:390
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520 sphinx/ext/apidoc.py:429
+#: sphinx/cmd/quickstart.py:508 sphinx/ext/apidoc.py:386
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:510
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:524
+#: sphinx/cmd/quickstart.py:512
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:514
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:516
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:519
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534
+#: sphinx/cmd/quickstart.py:522
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:525
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539 sphinx/ext/apidoc.py:435
+#: sphinx/cmd/quickstart.py:527 sphinx/ext/apidoc.py:392
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:542 sphinx/ext/apidoc.py:438
+#: sphinx/cmd/quickstart.py:530 sphinx/ext/apidoc.py:395
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:545
+#: sphinx/cmd/quickstart.py:533
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:578
+#: sphinx/cmd/quickstart.py:566
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:592
+#: sphinx/cmd/quickstart.py:580
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:594
+#: sphinx/cmd/quickstart.py:582
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:609
+#: sphinx/cmd/quickstart.py:597
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:75
-msgid "Over dedent has detected"
+#: sphinx/directives/code.py:64
+msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:94
+#: sphinx/directives/code.py:83
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "無效標題：%s"
 
-#: sphinx/directives/code.py:140 sphinx/directives/code.py:284
-#: sphinx/directives/code.py:450
+#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:440
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:208
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:231
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:233
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:268
+#: sphinx/directives/code.py:258
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:293
+#: sphinx/directives/code.py:283
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:298
+#: sphinx/directives/code.py:288
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:171
+#: sphinx/directives/other.py:175
 msgid "Section author: "
 msgstr "段落作者："
 
-#: sphinx/directives/other.py:173
+#: sphinx/directives/other.py:177
 msgid "Module author: "
 msgstr "模組作者："
 
-#: sphinx/directives/other.py:175
+#: sphinx/directives/other.py:179
 msgid "Code author: "
 msgstr "程式作者："
 
-#: sphinx/directives/other.py:177
+#: sphinx/directives/other.py:181
 msgid "Author: "
 msgstr "作者："
 
-#: sphinx/domains/__init__.py:393
+#: sphinx/directives/patches.py:108
+msgid ""
+"\":file:\" option for csv-table directive now recognizes an absolute path as"
+" a relative path from source directory. Please update your document."
+msgstr ""
+
+#: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:67 sphinx/domains/cpp.py:6410
-#: sphinx/domains/python.py:249 sphinx/ext/napoleon/docstring.py:661
+#: sphinx/domains/c.py:1952 sphinx/domains/c.py:3265
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr ""
+
+#: sphinx/domains/c.py:3099 sphinx/domains/cpp.py:6709
+#: sphinx/domains/python.py:369 sphinx/ext/napoleon/docstring.py:736
 msgid "Parameters"
 msgstr "參數"
 
-#: sphinx/domains/c.py:70 sphinx/domains/cpp.py:6419
-#: sphinx/domains/javascript.py:216 sphinx/domains/python.py:261
+#: sphinx/domains/c.py:3102 sphinx/domains/cpp.py:6718
+#: sphinx/domains/javascript.py:221 sphinx/domains/python.py:381
 msgid "Returns"
 msgstr "傳回"
 
-#: sphinx/domains/c.py:72 sphinx/domains/javascript.py:218
-#: sphinx/domains/python.py:263
+#: sphinx/domains/c.py:3104 sphinx/domains/javascript.py:223
+#: sphinx/domains/python.py:383
 msgid "Return type"
 msgstr "傳回型態"
 
-#: sphinx/domains/c.py:187
+#: sphinx/domains/c.py:3190
 #, python-format
-msgid "%s (C function)"
-msgstr "%s (C 函式)"
-
-#: sphinx/domains/c.py:189
-#, python-format
-msgid "%s (C member)"
-msgstr "%s (C 成員函數)"
-
-#: sphinx/domains/c.py:191
-#, python-format
-msgid "%s (C macro)"
-msgstr "%s (C 巨集)"
+msgid "%s (C %s)"
+msgstr ""
 
-#: sphinx/domains/c.py:193
-#, python-format
-msgid "%s (C type)"
-msgstr "%s (C 型態)"
+#: sphinx/domains/c.py:3699 sphinx/domains/cpp.py:7358
+msgid "member"
+msgstr "成員函數"
 
-#: sphinx/domains/c.py:195
-#, python-format
-msgid "%s (C variable)"
-msgstr "%s (C 變數)"
+#: sphinx/domains/c.py:3700
+msgid "variable"
+msgstr "變數"
 
-#: sphinx/domains/c.py:258 sphinx/domains/cpp.py:6991
-#: sphinx/domains/javascript.py:321 sphinx/domains/python.py:1015
+#: sphinx/domains/c.py:3701 sphinx/domains/cpp.py:7357
+#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:1090
 msgid "function"
 msgstr "函式"
 
-#: sphinx/domains/c.py:259 sphinx/domains/cpp.py:6992
-msgid "member"
-msgstr "成員函數"
-
-#: sphinx/domains/c.py:260
+#: sphinx/domains/c.py:3702
 msgid "macro"
 msgstr "巨集"
 
-#: sphinx/domains/c.py:261 sphinx/domains/cpp.py:6993
+#: sphinx/domains/c.py:3703
+msgid "struct"
+msgstr ""
+
+#: sphinx/domains/c.py:3704 sphinx/domains/cpp.py:7356
+msgid "union"
+msgstr ""
+
+#: sphinx/domains/c.py:3705 sphinx/domains/cpp.py:7361
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c.py:3706 sphinx/domains/cpp.py:7362
+msgid "enumerator"
+msgstr "enumerator"
+
+#: sphinx/domains/c.py:3707 sphinx/domains/cpp.py:7359
 msgid "type"
 msgstr "類型"
 
-#: sphinx/domains/c.py:262
-msgid "variable"
-msgstr "變數"
-
-#: sphinx/domains/c.py:290
-#, python-format
-msgid ""
-"duplicate C object description of %s, other instance in %s, use :noindex: "
-"for one of them"
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7364
+msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:31
+#: sphinx/domains/changeset.py:28
 #, python-format
 msgid "New in version %s"
 msgstr "%s 版新加入"
 
-#: sphinx/domains/changeset.py:32
+#: sphinx/domains/changeset.py:29
 #, python-format
 msgid "Changed in version %s"
 msgstr "%s 版更變"
 
-#: sphinx/domains/changeset.py:33
+#: sphinx/domains/changeset.py:30
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "%s 版後已棄用"
 
-#: sphinx/domains/citation.py:77
+#: sphinx/domains/citation.py:75
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:88
+#: sphinx/domains/citation.py:86
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4220
+#: sphinx/domains/cpp.py:4519 sphinx/domains/cpp.py:6911
 #, python-format
 msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Declaration is '%s'."
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:6413
+#: sphinx/domains/cpp.py:6712
 msgid "Template Parameters"
 msgstr "範本參數"
 
-#: sphinx/domains/cpp.py:6416 sphinx/domains/javascript.py:213
+#: sphinx/domains/cpp.py:6715 sphinx/domains/javascript.py:218
 msgid "Throws"
 msgstr "拋出"
 
-#: sphinx/domains/cpp.py:6539
+#: sphinx/domains/cpp.py:6834
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:6989 sphinx/domains/javascript.py:323
-#: sphinx/domains/python.py:1017
+#: sphinx/domains/cpp.py:7355 sphinx/domains/javascript.py:328
+#: sphinx/domains/python.py:1092
 msgid "class"
 msgstr "類別"
 
-#: sphinx/domains/cpp.py:6990
-msgid "union"
-msgstr ""
-
-#: sphinx/domains/cpp.py:6994
+#: sphinx/domains/cpp.py:7360
 msgid "concept"
 msgstr "concept"
 
-#: sphinx/domains/cpp.py:6995
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/cpp.py:6996
-msgid "enumerator"
-msgstr "enumerator"
-
-#: sphinx/domains/cpp.py:7086
-#, python-format
-msgid ""
-"Duplicate declaration, also defined in '%s'.\n"
-"Name of declaration is '%s'."
+#: sphinx/domains/cpp.py:7365
+msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:131 sphinx/domains/python.py:471
-#: sphinx/domains/python.py:503
+#: sphinx/domains/javascript.py:136
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (內建函式)"
 
-#: sphinx/domains/javascript.py:132 sphinx/domains/python.py:615
-#: sphinx/domains/python.py:713
+#: sphinx/domains/javascript.py:137 sphinx/domains/python.py:747
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s 的方法)"
 
-#: sphinx/domains/javascript.py:134
+#: sphinx/domains/javascript.py:139
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (類別)"
 
-#: sphinx/domains/javascript.py:136
+#: sphinx/domains/javascript.py:141
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (全域變數或常數)"
 
-#: sphinx/domains/javascript.py:138 sphinx/domains/python.py:653
-#: sphinx/domains/python.py:790
+#: sphinx/domains/javascript.py:143 sphinx/domains/python.py:825
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s 的屬性)"
 
-#: sphinx/domains/javascript.py:210
+#: sphinx/domains/javascript.py:215
 msgid "Arguments"
 msgstr "引數"
 
-#: sphinx/domains/javascript.py:281 sphinx/domains/python.py:862
+#: sphinx/domains/javascript.py:286
 #, python-format
 msgid "%s (module)"
 msgstr "%s (模組)"
 
-#: sphinx/domains/javascript.py:322 sphinx/domains/python.py:1019
+#: sphinx/domains/javascript.py:327 sphinx/domains/python.py:1094
 msgid "method"
 msgstr "成員函式"
 
-#: sphinx/domains/javascript.py:324 sphinx/domains/python.py:1016
+#: sphinx/domains/javascript.py:329 sphinx/domains/python.py:1091
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:325 sphinx/domains/python.py:1022
+#: sphinx/domains/javascript.py:330 sphinx/domains/python.py:1097
 msgid "attribute"
 msgstr "屬性"
 
-#: sphinx/domains/javascript.py:326 sphinx/domains/python.py:60
-#: sphinx/domains/python.py:1023
+#: sphinx/domains/javascript.py:331 sphinx/domains/python.py:57
+#: sphinx/domains/python.py:1099
 msgid "module"
 msgstr "模組"
 
-#: sphinx/domains/javascript.py:357
+#: sphinx/domains/javascript.py:362
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:69 sphinx/domains/math.py:148
+#: sphinx/domains/math.py:65
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "重覆公式標籤 %s，亦出現於 %s"
 
-#: sphinx/domains/math.py:123 sphinx/writers/latex.py:2031
+#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2052
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:58
 msgid "keyword"
 msgstr "關鍵字"
 
-#: sphinx/domains/python.py:62
+#: sphinx/domains/python.py:59
 msgid "operator"
 msgstr "運算子"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:60
 msgid "object"
 msgstr "物件"
 
-#: sphinx/domains/python.py:64 sphinx/domains/python.py:1018
+#: sphinx/domains/python.py:61 sphinx/domains/python.py:1093
 msgid "exception"
 msgstr "例外"
 
-#: sphinx/domains/python.py:65
+#: sphinx/domains/python.py:62
 msgid "statement"
 msgstr "陳述式"
 
-#: sphinx/domains/python.py:66
+#: sphinx/domains/python.py:63
 msgid "built-in function"
 msgstr "內建函式"
 
-#: sphinx/domains/python.py:254
+#: sphinx/domains/python.py:374
 msgid "Variables"
 msgstr "變數"
 
-#: sphinx/domains/python.py:258
+#: sphinx/domains/python.py:378
 msgid "Raises"
 msgstr "丟出"
 
-#: sphinx/domains/python.py:472 sphinx/domains/python.py:501
-#: sphinx/domains/python.py:609 sphinx/domains/python.py:621
-#: sphinx/domains/python.py:634 sphinx/domains/python.py:702
+#: sphinx/domains/python.py:601 sphinx/domains/python.py:736
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (於 %s 模組中)"
 
-#: sphinx/domains/python.py:475 sphinx/domains/python.py:550
-#, python-format
-msgid "%s (built-in variable)"
-msgstr "%s (內建變數)"
-
-#: sphinx/domains/python.py:476 sphinx/domains/python.py:548
-#: sphinx/domains/python.py:647 sphinx/domains/python.py:786
+#: sphinx/domains/python.py:655 sphinx/domains/python.py:821
+#: sphinx/domains/python.py:861
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (於 %s 模組中)"
 
-#: sphinx/domains/python.py:566
+#: sphinx/domains/python.py:657
+#, python-format
+msgid "%s (built-in variable)"
+msgstr "%s (內建變數)"
+
+#: sphinx/domains/python.py:681
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (內建類別)"
 
-#: sphinx/domains/python.py:567
+#: sphinx/domains/python.py:682
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s 中的類別)"
 
-#: sphinx/domains/python.py:613
+#: sphinx/domains/python.py:741
 #, python-format
-msgid "%s() (%s.%s method)"
-msgstr "%s() (%s.%s 的成員函數)"
+msgid "%s() (%s class method)"
+msgstr "%s() (%s 的類別成員)"
 
-#: sphinx/domains/python.py:625
+#: sphinx/domains/python.py:743
 #, python-format
-msgid "%s() (%s.%s static method)"
-msgstr "%s() (%s.%s 的靜態成員)"
+msgid "%s() (%s property)"
+msgstr ""
 
-#: sphinx/domains/python.py:628 sphinx/domains/python.py:711
+#: sphinx/domains/python.py:745
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s 的靜態成員)"
 
-#: sphinx/domains/python.py:638
-#, python-format
-msgid "%s() (%s.%s class method)"
-msgstr "%s() (%s.%s 的類別成員)"
-
-#: sphinx/domains/python.py:641 sphinx/domains/python.py:707
-#, python-format
-msgid "%s() (%s class method)"
-msgstr "%s() (%s 的類別成員)"
-
-#: sphinx/domains/python.py:651
+#: sphinx/domains/python.py:865
 #, python-format
-msgid "%s (%s.%s attribute)"
-msgstr "%s (%s.%s 的屬性)"
-
-#: sphinx/domains/python.py:709
-#, python-format
-msgid "%s() (%s property)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:943
+#: sphinx/domains/python.py:1019
 msgid "Python Module Index"
 msgstr "Python 模組索引"
 
-#: sphinx/domains/python.py:944
+#: sphinx/domains/python.py:1020
 msgid "modules"
 msgstr "模組"
 
-#: sphinx/domains/python.py:994
+#: sphinx/domains/python.py:1069
 msgid "Deprecated"
 msgstr "已棄用"
 
-#: sphinx/domains/python.py:1020
+#: sphinx/domains/python.py:1095
 msgid "class method"
 msgstr "類別成員"
 
-#: sphinx/domains/python.py:1021
+#: sphinx/domains/python.py:1096
 msgid "static method"
 msgstr "靜態成員"
 
-#: sphinx/domains/python.py:1070
+#: sphinx/domains/python.py:1098
+msgid "property"
+msgstr ""
+
+#: sphinx/domains/python.py:1148
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1176
+#: sphinx/domains/python.py:1264
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1214
+#: sphinx/domains/python.py:1318
 msgid " (deprecated)"
 msgstr "(已棄用)"
 
-#: sphinx/domains/rst.py:105 sphinx/domains/rst.py:166
+#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directive)"
 
-#: sphinx/domains/rst.py:167 sphinx/domains/rst.py:171
+#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:199
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:208
 msgid "directive"
 msgstr "directive"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:209
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:210
 msgid "role"
 msgstr "role"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:232
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:103 sphinx/domains/std.py:120
+#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
 #, python-format
 msgid "environment variable; %s"
 msgstr "環境變數; %s"
 
-#: sphinx/domains/std.py:194
+#: sphinx/domains/std.py:192
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:235
+#: sphinx/domains/std.py:243
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:237
+#: sphinx/domains/std.py:245
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:368
+#: sphinx/domains/std.py:371
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:376
+#: sphinx/domains/std.py:379
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:382 sphinx/domains/std.py:395
+#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:545
+#: sphinx/domains/std.py:563
 msgid "glossary term"
 msgstr "雜項術語"
 
-#: sphinx/domains/std.py:546
+#: sphinx/domains/std.py:564
 msgid "grammar token"
 msgstr "語法單詞"
 
-#: sphinx/domains/std.py:547
+#: sphinx/domains/std.py:565
 msgid "reference label"
 msgstr "參照標籤"
 
-#: sphinx/domains/std.py:549
+#: sphinx/domains/std.py:567
 msgid "environment variable"
 msgstr "環境變數"
 
-#: sphinx/domains/std.py:550
+#: sphinx/domains/std.py:568
 msgid "program option"
 msgstr "程式選項"
 
-#: sphinx/domains/std.py:551
+#: sphinx/domains/std.py:569
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:587
+#: sphinx/domains/std.py:605
 msgid "Module Index"
 msgstr "模組索引"
 
-#: sphinx/domains/std.py:588 sphinx/themes/basic/defindex.html:24
+#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "搜尋頁面"
 
-#: sphinx/domains/std.py:638 sphinx/domains/std.py:727
-#: sphinx/ext/autosectionlabel.py:53
+#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
+#: sphinx/ext/autosectionlabel.py:51
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:657
+#: sphinx/domains/std.py:674
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:869
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:877
 #, python-format
-msgid "no number is assigned for %s: %s"
+msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:852
+#: sphinx/domains/std.py:889
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:866
+#: sphinx/domains/std.py:903
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:869
+#: sphinx/domains/std.py:906
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/environment/__init__.py:73
+#: sphinx/domains/std.py:1118
+#, python-format
+msgid "undefined label: %s"
+msgstr ""
+
+#: sphinx/domains/std.py:1120
+#, python-format
+msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgstr ""
+
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:74
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:75
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:202
+#: sphinx/environment/__init__.py:197
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:204
+#: sphinx/environment/__init__.py:199
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:283
+#: sphinx/environment/__init__.py:278
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:396
+#: sphinx/environment/__init__.py:377
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:515
+#: sphinx/environment/__init__.py:504
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:596
+#: sphinx/environment/__init__.py:585
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:636
+#: sphinx/environment/__init__.py:627
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:80
+#: sphinx/environment/adapters/indexentries.py:78
 #, python-format
 msgid "see %s"
 msgstr "參考 %s"
 
-#: sphinx/environment/adapters/indexentries.py:84
+#: sphinx/environment/adapters/indexentries.py:82
 #, python-format
 msgid "see also %s"
 msgstr "也參考 %s"
 
-#: sphinx/environment/adapters/indexentries.py:87
+#: sphinx/environment/adapters/indexentries.py:85
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:172
+#: sphinx/environment/adapters/indexentries.py:174
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "符號"
 
-#: sphinx/environment/adapters/toctree.py:153
+#: sphinx/environment/adapters/toctree.py:151
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:172
+#: sphinx/environment/adapters/toctree.py:170
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:178
+#: sphinx/environment/adapters/toctree.py:176
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:180
+#: sphinx/environment/adapters/toctree.py:178
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:87
+#: sphinx/environment/collectors/asset.py:90
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:106
+#: sphinx/environment/collectors/asset.py:109
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:132
+#: sphinx/environment/collectors/asset.py:135
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:191
+#: sphinx/environment/collectors/toctree.py:185
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:100
+#: sphinx/ext/apidoc.py:83
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:308
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2390,165 +2412,185 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:321
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:323
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:371
+#: sphinx/ext/apidoc.py:328
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:333
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:336
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:339
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:342
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:388
+#: sphinx/ext/apidoc.py:345
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:348
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:350
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:395
+#: sphinx/ext/apidoc.py:352
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:398
+#: sphinx/ext/apidoc.py:355
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:403
+#: sphinx/ext/apidoc.py:360
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:407
+#: sphinx/ext/apidoc.py:364
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:411
+#: sphinx/ext/apidoc.py:368
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:413
+#: sphinx/ext/apidoc.py:370
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:416
+#: sphinx/ext/apidoc.py:373
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:418
+#: sphinx/ext/apidoc.py:375
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:420
+#: sphinx/ext/apidoc.py:377
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:422
+#: sphinx/ext/apidoc.py:379
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:424
+#: sphinx/ext/apidoc.py:381
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:427
+#: sphinx/ext/apidoc.py:384
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:460
+#: sphinx/ext/apidoc.py:417
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:42
+#: sphinx/ext/coverage.py:43
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:51
+#: sphinx/ext/coverage.py:52
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:65
+#: sphinx/ext/coverage.py:66
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:150
+#: sphinx/ext/coverage.py:127
+#, python-format
+msgid "undocumented c api: %s [%s] in file %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:159
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/coverage.py:255
+#, python-format
+msgid "undocumented python function: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:271
+#, python-format
+msgid "undocumented python class: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/coverage.py:284
+#, python-format
+msgid "undocumented python method: %s :: %s :: %s"
+msgstr ""
+
+#: sphinx/ext/doctest.py:123
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:136
+#: sphinx/ext/doctest.py:128
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:150
+#: sphinx/ext/doctest.py:142
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:219
+#: sphinx/ext/doctest.py:225
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:277
+#: sphinx/ext/doctest.py:283
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:427
+#: sphinx/ext/doctest.py:433
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:513
+#: sphinx/ext/doctest.py:519
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:80
+#: sphinx/ext/duration.py:79
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
@@ -2562,11 +2604,11 @@ msgstr ""
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:148
+#: sphinx/ext/graphviz.py:149
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:248
+#: sphinx/ext/graphviz.py:257
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2576,14 +2618,14 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:252
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2593,29 +2635,30 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:269
+#: sphinx/ext/graphviz.py:278
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:273 sphinx/ext/graphviz.py:324
-#: sphinx/ext/graphviz.py:361
+#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
+#: sphinx/ext/graphviz.py:371
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:374 sphinx/ext/graphviz.py:382
+#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
 #, python-format
 msgid "[graph: %s]"
 msgstr "[圖：%s]"
 
-#: sphinx/ext/graphviz.py:376 sphinx/ext/graphviz.py:384
+#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
 msgid "[graph]"
 msgstr "[圖]"
 
-#: sphinx/ext/imgconverter.py:41 sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:41
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting"
+msgid ""
+"convert command %r cannot be run, check the image_converter setting: %s"
 msgstr ""
 
 #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
@@ -2628,148 +2671,158 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:170
+#: sphinx/ext/imgconverter.py:65
+#, python-format
+msgid "convert command %r cannot be run, check the image_converter setting"
+msgstr ""
+
+#: sphinx/ext/imgmath.py:141
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:184
+#: sphinx/ext/imgmath.py:155
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:329
+#: sphinx/ext/imgmath.py:300
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:355
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:362 sphinx/ext/mathjax.py:49
+#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:50
 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:314
+#: sphinx/ext/intersphinx.py:326
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(於 %s v%s)"
 
-#: sphinx/ext/intersphinx.py:316
+#: sphinx/ext/intersphinx.py:328
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:349
+#: sphinx/ext/intersphinx.py:361
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:362
+#: sphinx/ext/intersphinx.py:374
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:113
+#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:187
 msgid "[source]"
 msgstr "[原始碼]"
 
-#: sphinx/ext/todo.py:70
+#: sphinx/ext/todo.py:68
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:103 sphinx/ext/todo.py:130
+#: sphinx/ext/todo.py:101
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:193 sphinx/ext/todo.py:242
+#: sphinx/ext/todo.py:159
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:195 sphinx/ext/todo.py:245
+#: sphinx/ext/todo.py:161
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> 見 %s ，第 %d 行)"
 
-#: sphinx/ext/todo.py:205 sphinx/ext/todo.py:253
+#: sphinx/ext/todo.py:171
 msgid "original entry"
 msgstr "原始記錄"
 
-#: sphinx/ext/viewcode.py:153
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:182
+#: sphinx/ext/viewcode.py:288
 msgid "[docs]"
 msgstr "[文件]"
 
-#: sphinx/ext/viewcode.py:196
+#: sphinx/ext/viewcode.py:302
 msgid "Module code"
 msgstr "模組原始碼"
 
-#: sphinx/ext/viewcode.py:202
+#: sphinx/ext/viewcode.py:308
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s 的原始碼</h1>"
 
-#: sphinx/ext/viewcode.py:228
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr "概要：模組原始碼"
 
-#: sphinx/ext/viewcode.py:229
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>所有可得程式碼的模組</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:298
+#: sphinx/ext/autodoc/__init__.py:129
+#, python-format
+msgid "invalid value for member-order option: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:387
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:395
+#: sphinx/ext/autodoc/__init__.py:504
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:502
+#: sphinx/ext/autodoc/__init__.py:649 sphinx/ext/autodoc/__init__.py:1637
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:617
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:706
+#: sphinx/ext/autodoc/__init__.py:891
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2777,104 +2830,157 @@ msgid ""
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:799
+#: sphinx/ext/autodoc/__init__.py:949
+#, python-format
+msgid "error while formatting signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:999
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:806
+#: sphinx/ext/autodoc/__init__.py:1006
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:837
+#: sphinx/ext/autodoc/__init__.py:1019
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:852
+#: sphinx/ext/autodoc/__init__.py:1085
 #, python-format
 msgid ""
-"missing attribute mentioned in :members: or __all__: module %s, attribute %s"
+"missing attribute mentioned in :members: option: module %s, attribute %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1358
+#: sphinx/ext/autodoc/__init__.py:2570
+#, python-format
+msgid "Failed to get a function signature for %s: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1531
+#, python-format
+msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1208
+#: sphinx/ext/autodoc/__init__.py:1620 sphinx/ext/autodoc/__init__.py:1624
 #, python-format
 msgid "Bases: %s"
 msgstr "基礎類別：%s"
 
-#: sphinx/ext/autodoc/__init__.py:1267
+#: sphinx/ext/autodoc/__init__.py:1697 sphinx/ext/autodoc/__init__.py:1771
+#: sphinx/ext/autodoc/__init__.py:1790
+#, python-format
+msgid "alias of %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1832
+#, python-format
+msgid "alias of TypeVar(%s)"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2064 sphinx/ext/autodoc/__init__.py:2158
 #, python-format
-msgid "alias of :class:`%s`"
-msgstr ":class:`%s` 的別名"
+msgid "Failed to get a method signature for %s: %s"
+msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:132
+#: sphinx/ext/autodoc/__init__.py:2247
+#, python-format
+msgid "Invalid __slots__ found on %s. Ignored."
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:2613
+msgid ""
+"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
+" Please update your setting."
+msgstr ""
+
+#: sphinx/ext/autodoc/preserve_defaults.py:78
+#, python-format
+msgid "Failed to parse a default argument value for %r: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:130
+#, python-format
+msgid "Failed to update signature for %r: parameter not found: %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/type_comment.py:133
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:255
+#: sphinx/ext/autosummary/__init__.py:259
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:257
+#: sphinx/ext/autosummary/__init__.py:261
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:296
+#: sphinx/ext/autosummary/__init__.py:280
+msgid "A captioned autosummary requires :toctree: option. ignored."
+msgstr ""
+
+#: sphinx/ext/autosummary/__init__.py:327
 #, python-format
-msgid "failed to import %s"
+msgid "autosummary: failed to import %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:311
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:315
+#: sphinx/ext/autosummary/__init__.py:346
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:730
+#: sphinx/ext/autosummary/__init__.py:734
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:738
+#: sphinx/ext/autosummary/__init__.py:742
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:153
+#: sphinx/ext/autosummary/generate.py:188
+#: sphinx/ext/autosummary/generate.py:237
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:247
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:251
+#: sphinx/ext/autosummary/generate.py:370
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:277
+#: sphinx/ext/autosummary/generate.py:407
 #, python-format
 msgid "[autosummary] failed to import %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:435
+#: sphinx/ext/autosummary/generate.py:581
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -2889,107 +2995,131 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:452
+#: sphinx/ext/autosummary/generate.py:598
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:456
+#: sphinx/ext/autosummary/generate.py:602
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:459
+#: sphinx/ext/autosummary/generate.py:605
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:463
+#: sphinx/ext/autosummary/generate.py:609
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:467
+#: sphinx/ext/autosummary/generate.py:613
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:325 sphinx/ext/napoleon/docstring.py:638
+#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
 msgid "Keyword Arguments"
 msgstr "關鍵字引數"
 
-#: sphinx/ext/napoleon/docstring.py:599
+#: sphinx/ext/napoleon/docstring.py:657
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:600
+#: sphinx/ext/napoleon/docstring.py:658
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:651
+#: sphinx/ext/napoleon/docstring.py:718
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:654
+#: sphinx/ext/napoleon/docstring.py:727
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:763
+msgid "Receives"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:767
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:714
+#: sphinx/ext/napoleon/docstring.py:801
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:805
 msgid "Yields"
 msgstr ""
 
-#: sphinx/locale/__init__.py:250
+#: sphinx/ext/napoleon/docstring.py:973
+#, python-format
+msgid "invalid value set (missing closing brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:980
+#, python-format
+msgid "invalid value set (missing opening brace): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:987
+#, python-format
+msgid "malformed string literal (missing closing quote): %s"
+msgstr ""
+
+#: sphinx/ext/napoleon/docstring.py:994
+#, python-format
+msgid "malformed string literal (missing opening quote): %s"
+msgstr ""
+
+#: sphinx/locale/__init__.py:252
 msgid "Attention"
 msgstr "注意"
 
-#: sphinx/locale/__init__.py:251
+#: sphinx/locale/__init__.py:253
 msgid "Caution"
 msgstr "警示"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:254
 msgid "Danger"
 msgstr "危險"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:255
 msgid "Error"
 msgstr "錯誤"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:256
 msgid "Hint"
 msgstr "提示"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:257
 msgid "Important"
 msgstr "重要"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:258
 msgid "Note"
 msgstr "備註"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:259
 msgid "See also"
 msgstr "也參考"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:260
 msgid "Tip"
 msgstr "小訣竅"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:261
 msgid "Warning"
 msgstr "警告"
 
-#: sphinx/templates/latex/longtable.tex_t:18
+#: sphinx/templates/latex/longtable.tex_t:23
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "繼續上一頁"
 
-#: sphinx/templates/latex/longtable.tex_t:24
+#: sphinx/templates/latex/longtable.tex_t:29
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3006,181 +3136,181 @@ msgstr ""
 msgid "page"
 msgstr "頁"
 
-#: sphinx/themes/agogo/layout.html:27 sphinx/themes/basic/globaltoc.html:10
-#: sphinx/themes/basic/localtoc.html:10 sphinx/themes/scrolls/layout.html:31
+#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10
+#: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:30 sphinx/themes/basic/layout.html:52
-#: sphinx/themes/basic/search.html:10 sphinx/themes/basic/search.html:18
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "搜尋"
 
-#: sphinx/themes/agogo/layout.html:33 sphinx/themes/basic/searchbox.html:15
+#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
 msgstr "搜"
 
-#: sphinx/themes/agogo/layout.html:66 sphinx/themes/basic/sourcelink.html:14
+#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
 msgstr "顯示原始碼"
 
-#: sphinx/themes/basic/defindex.html:10
+#: sphinx/themes/basic/defindex.html:11
 msgid "Overview"
 msgstr "概要"
 
-#: sphinx/themes/basic/defindex.html:14
+#: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
 msgstr "歡迎！本"
 
-#: sphinx/themes/basic/defindex.html:15
+#: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
 msgstr "說明文件介紹"
 
-#: sphinx/themes/basic/defindex.html:16
+#: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
 msgstr "最後更新於"
 
-#: sphinx/themes/basic/defindex.html:19
+#: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
 msgstr "索引與表格："
 
-#: sphinx/themes/basic/defindex.html:22
+#: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
 msgstr "完整目錄"
 
-#: sphinx/themes/basic/defindex.html:23
+#: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
 msgstr "列出所有段落與子段落"
 
-#: sphinx/themes/basic/defindex.html:25
+#: sphinx/themes/basic/defindex.html:26
 msgid "search this documentation"
 msgstr "搜尋本說明文件"
 
-#: sphinx/themes/basic/defindex.html:27
+#: sphinx/themes/basic/defindex.html:28
 msgid "Global Module Index"
 msgstr "全域模組索引"
 
-#: sphinx/themes/basic/defindex.html:28
+#: sphinx/themes/basic/defindex.html:29
 msgid "quick access to all modules"
 msgstr "快速前往所有的模組"
 
-#: sphinx/themes/basic/defindex.html:30
+#: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
 msgstr "所有函式、類別、術語"
 
-#: sphinx/themes/basic/genindex-single.html:22
+#: sphinx/themes/basic/genindex-single.html:33
 #, python-format
 msgid "Index &ndash; %(key)s"
 msgstr "索引 &ndash; %(key)s"
 
-#: sphinx/themes/basic/genindex-single.html:41
-#: sphinx/themes/basic/genindex-split.html:22
-#: sphinx/themes/basic/genindex-split.html:35
-#: sphinx/themes/basic/genindex.html:49
+#: sphinx/themes/basic/genindex-single.html:61
+#: sphinx/themes/basic/genindex-split.html:24
+#: sphinx/themes/basic/genindex-split.html:38
+#: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
 msgstr "單頁完整索引"
 
-#: sphinx/themes/basic/genindex-split.html:15
+#: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
 msgstr "索引頁面按字母"
 
-#: sphinx/themes/basic/genindex-split.html:23
+#: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
 msgstr "可能會很大"
 
-#: sphinx/themes/basic/layout.html:16
+#: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "瀏覽"
 
-#: sphinx/themes/basic/layout.html:47
+#: sphinx/themes/basic/layout.html:135
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "在 %(docstitle)s 中搜尋"
 
-#: sphinx/themes/basic/layout.html:50
+#: sphinx/themes/basic/layout.html:144
 msgid "About these documents"
 msgstr "關於這些文件"
 
-#: sphinx/themes/basic/layout.html:53
+#: sphinx/themes/basic/layout.html:153
 msgid "Copyright"
 msgstr "版權所有"
 
-#: sphinx/themes/basic/layout.html:69
+#: sphinx/themes/basic/layout.html:199
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">版權所有</a> %(copyright)s。"
 
-#: sphinx/themes/basic/layout.html:70
+#: sphinx/themes/basic/layout.html:201
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; 版權所有 %(copyright)s。"
 
-#: sphinx/themes/basic/layout.html:71
+#: sphinx/themes/basic/layout.html:205
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "最後更新於 %(last_updated)s。"
 
-#: sphinx/themes/basic/layout.html:72
+#: sphinx/themes/basic/layout.html:208
 #, python-format
 msgid ""
-"Created using <a href=\"http://sphinx-doc.org/\">Sphinx</a> "
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr "使用 <a href=\"http://sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s 創建。"
+msgstr ""
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
 msgid "Search %(docstitle)s"
 msgstr "搜尋 %(docstitle)s"
 
-#: sphinx/themes/basic/relations.html:10
+#: sphinx/themes/basic/relations.html:11
 msgid "Previous topic"
 msgstr "上個主題"
 
-#: sphinx/themes/basic/relations.html:12
+#: sphinx/themes/basic/relations.html:13
 msgid "previous chapter"
 msgstr "上一章"
 
-#: sphinx/themes/basic/relations.html:13
+#: sphinx/themes/basic/relations.html:16
 msgid "Next topic"
 msgstr "下個主題"
 
-#: sphinx/themes/basic/relations.html:15
+#: sphinx/themes/basic/relations.html:18
 msgid "next chapter"
 msgstr "下一章"
 
-#: sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:27
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "請啟用 Javascript 以開啟搜尋功能。"
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:34
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr ""
 
-#: sphinx/themes/basic/search.html:32
+#: sphinx/themes/basic/search.html:41
 msgid "search"
 msgstr "搜尋"
 
-#: sphinx/themes/basic/search.html:36
-#: sphinx/themes/basic/static/searchtools.js:304
+#: sphinx/themes/basic/search.html:47
+#: sphinx/themes/basic/static/searchtools.js:303
 msgid "Search Results"
 msgstr "搜尋結果"
 
-#: sphinx/themes/basic/search.html:38
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/search.html:49
+#: sphinx/themes/basic/static/searchtools.js:305
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
 msgstr "你的搜尋找不到任何滿足條件的文件。請確定是否所有的搜尋詞都正確地拼寫且你已選擇足夠的分類。"
 
-#: sphinx/themes/basic/searchbox.html:11
+#: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "快速搜尋"
 
-#: sphinx/themes/basic/sourcelink.html:11
+#: sphinx/themes/basic/sourcelink.html:12
 msgid "This Page"
 msgstr "本頁"
 
@@ -3212,19 +3342,19 @@ msgstr "C API 改變"
 msgid "Other changes"
 msgstr "其他改變"
 
-#: sphinx/themes/basic/static/doctools.js:194 sphinx/writers/html.py:403
-#: sphinx/writers/html.py:408 sphinx/writers/html5.py:355
-#: sphinx/writers/html5.py:360
+#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:416
+#: sphinx/writers/html.py:421 sphinx/writers/html5.py:367
+#: sphinx/writers/html5.py:372
 msgid "Permalink to this headline"
 msgstr "本標題的永久連結"
 
-#: sphinx/themes/basic/static/doctools.js:200 sphinx/writers/html.py:121
-#: sphinx/writers/html.py:130 sphinx/writers/html5.py:93
-#: sphinx/writers/html5.py:102
+#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:124
+#: sphinx/writers/html.py:133 sphinx/writers/html5.py:95
+#: sphinx/writers/html5.py:104
 msgid "Permalink to this definition"
 msgstr "本定義的永久連結"
 
-#: sphinx/themes/basic/static/doctools.js:233
+#: sphinx/themes/basic/static/doctools.js:238
 msgid "Hide Search Matches"
 msgstr "隱藏符合搜尋"
 
@@ -3236,12 +3366,12 @@ msgstr "搜尋中"
 msgid "Preparing search..."
 msgstr "準備搜尋中…"
 
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:307
 #, python-format
 msgid "Search finished, found %s page(s) matching the search query."
 msgstr "搜尋完成，共找到 %s 頁面滿足搜尋條件。"
 
-#: sphinx/themes/basic/static/searchtools.js:362
+#: sphinx/themes/basic/static/searchtools.js:361
 msgid ", in "
 msgstr " 於 "
 
@@ -3254,7 +3384,7 @@ msgstr "展開側邊欄"
 msgid "Collapse sidebar"
 msgstr "收合側邊欄"
 
-#: sphinx/themes/haiku/layout.html:19
+#: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "內容"
 
@@ -3273,199 +3403,207 @@ msgstr ""
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:296 sphinx/transforms/i18n.py:366
+#: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:338
+#: sphinx/transforms/i18n.py:347
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:385
+#: sphinx/transforms/i18n.py:394
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:405
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:139
+#: sphinx/transforms/post_transforms/__init__.py:115
+msgid ""
+"Could not determine the fallback text for the cross-reference. Might be a "
+"bug."
+msgstr ""
+
+#: sphinx/transforms/post_transforms/__init__.py:155
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:171
+#: sphinx/transforms/post_transforms/__init__.py:190
 #, python-format
-msgid "%s:%s reference target not found: %%(target)s"
+msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:174
+#: sphinx/transforms/post_transforms/__init__.py:193
 #, python-format
-msgid "%r reference target not found: %%(target)s"
+msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:86
+#: sphinx/transforms/post_transforms/images.py:83
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:114
+#: sphinx/transforms/post_transforms/images.py:111
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:132
+#: sphinx/transforms/post_transforms/images.py:129
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:379
+#: sphinx/util/__init__.py:284
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:639
+#: sphinx/util/__init__.py:515
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:644
+#: sphinx/util/__init__.py:520
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/docutils.py:213
+#, python-format
+msgid "unknown directive or role name: %s:%s"
+msgstr ""
+
+#: sphinx/util/i18n.py:67
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:75
+#: sphinx/util/i18n.py:74
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:260
+#: sphinx/util/i18n.py:189
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:422
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:526
+#: sphinx/util/nodes.py:605
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/pycompat.py:77
-#, python-format
-msgid ""
-"Support for evaluating Python 2 syntax is deprecated and will be removed in "
-"Sphinx 4.0. Convert %s to Python 3 syntax."
-msgstr ""
-
-#: sphinx/util/rst.py:74
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:306 sphinx/writers/html5.py:278
+#: sphinx/writers/html.py:309 sphinx/writers/html5.py:280
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:316 sphinx/writers/html5.py:288
+#: sphinx/writers/html.py:319 sphinx/writers/html5.py:290
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:412 sphinx/writers/html5.py:364
+#: sphinx/writers/html.py:393 sphinx/writers/html5.py:344
+msgid "Permalink to this term"
+msgstr ""
+
+#: sphinx/writers/html.py:425 sphinx/writers/html5.py:376
 msgid "Permalink to this table"
 msgstr "本表格的永久連結"
 
-#: sphinx/writers/html.py:456 sphinx/writers/html5.py:408
+#: sphinx/writers/html.py:468 sphinx/writers/html5.py:419
 msgid "Permalink to this code"
 msgstr "本原始碼的永久連結"
 
-#: sphinx/writers/html.py:458 sphinx/writers/html5.py:410
+#: sphinx/writers/html.py:470 sphinx/writers/html5.py:421
 msgid "Permalink to this image"
 msgstr "本圖片的永久連結"
 
-#: sphinx/writers/html.py:460 sphinx/writers/html5.py:412
+#: sphinx/writers/html.py:472 sphinx/writers/html5.py:423
 msgid "Permalink to this toctree"
 msgstr "本目錄的永久連結"
 
-#: sphinx/writers/html.py:584 sphinx/writers/html5.py:525
+#: sphinx/writers/html.py:603 sphinx/writers/html5.py:543
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:352
+#: sphinx/writers/latex.py:347
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:404
+#: sphinx/writers/latex.py:398
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:653
+#: sphinx/writers/latex.py:645
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:685 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:677 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:827 sphinx/writers/manpage.py:238
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:225
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr "頁尾"
 
-#: sphinx/writers/latex.py:879
+#: sphinx/writers/latex.py:890
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1202
+#: sphinx/writers/latex.py:1221
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1513
+#: sphinx/writers/latex.py:1534
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:287 sphinx/writers/text.py:788
+#: sphinx/writers/manpage.py:274 sphinx/writers/text.py:786
 #, python-format
 msgid "[image: %s]"
 msgstr "[圖片：%s]"
 
-#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:789
+#: sphinx/writers/manpage.py:275 sphinx/writers/text.py:787
 msgid "[image]"
 msgstr "[圖片]"
 
-#: sphinx/writers/texinfo.py:1185
+#: sphinx/writers/texinfo.py:1181
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1261
+#: sphinx/writers/texinfo.py:1265
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1265
+#: sphinx/writers/texinfo.py:1269
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""

From a317d0037c3513e902c4259331e2c6249540fcda Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Sun, 9 May 2021 12:20:11 +0900
Subject: [PATCH 305/305] Bump to 4.0.0 final

---
 CHANGES            | 100 +++++++++++++++++++--------------------------
 sphinx/__init__.py |   4 +-
 2 files changed, 43 insertions(+), 61 deletions(-)

diff --git a/CHANGES b/CHANGES
index 7f5f43221e0..36bfe6b3f5d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,31 +1,16 @@
-Release 4.0.0 beta3 (in development)
-====================================
+Release 4.0.0 (released May 09, 2021)
+=====================================
 
 Dependencies
 ------------
 
-Incompatible changes
---------------------
-
-Deprecated
-----------
-
-Features added
---------------
-
-Bugs fixed
-----------
-
-* #9167: html: Failed to add CSS files to the specific page
+4.0.0b1
 
-Testing
---------
+* Drop python 3.5 support
+* Drop docutils 0.12 and 0.13 support
+* LaTeX: add ``tex-gyre`` font dependency
 
-Release 4.0.0 beta2 (released Apr 29, 2021)
-===========================================
-
-Dependencies
-------------
+4.0.0b2
 
 * Support docutils-0.17.  Please notice it changes the output of HTML builder.
   Some themes do not support it, and you need to update your custom CSS to
@@ -34,43 +19,7 @@ Dependencies
 Incompatible changes
 --------------------
 
-* #9023: Change the CSS classes on :rst:role:`cpp:expr` and
-  :rst:role:`cpp:texpr`.
-
-Features added
---------------
-
-* #8818: autodoc: Super class having ``Any`` arguments causes nit-picky warning
-* #9095: autodoc: TypeError is raised on processing broken metaclass
-* #9110: autodoc: metadata of GenericAlias is not rendered as a reference in
-  py37+
-* #9098: html: copy-range protection for doctests doesn't work in Safari
-* #9103: LaTeX: imgconverter: conversion runs even if not needed
-* #8127: py domain: Ellipsis in info-field-list causes nit-picky warning
-* #9121: py domain: duplicated warning is emitted when both canonical and its
-  alias objects are defined on the document
-* #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
-* #8195: mathjax: Rename :confval:`mathjax_config` to
-  :confval:`mathjax2_config` and add :confval:`mathjax3_config`
-
-Bugs fixed
-----------
-
-* C, C++, fix ``KeyError`` when an ``alias`` directive is the first C/C++
-  directive in a file with another C/C++ directive later.
-
-Release 4.0.0 beta1 (released Apr 12, 2021)
-===========================================
-
-Dependencies
-------------
-
-* Drop python 3.5 support
-* Drop docutils 0.12 and 0.13 support
-* LaTeX: add ``tex-gyre`` font dependency
-
-Incompatible changes
---------------------
+4.0.0b1
 
 * #8539: autodoc: info-field-list is generated into the class description when
   ``autodoc_typehints='description'`` and ``autoclass_content='class'`` set
@@ -107,6 +56,11 @@ Incompatible changes
 * #8487: The :file: option for csv-table directive now recognizes an absolute
   path as a relative path from source directory
 
+4.0.0b2
+
+* #9023: Change the CSS classes on :rst:role:`cpp:expr` and
+  :rst:role:`cpp:texpr`.
+
 Deprecated
 ----------
 
@@ -128,6 +82,8 @@ Deprecated
 Features added
 --------------
 
+4.0.0b1
+
 * #8924: autodoc: Support ``bound`` argument for TypeVar
 * #7383: autodoc: Support typehints for properties
 * #5603: autodoc: Allow to refer to a python class using its canonical name
@@ -157,9 +113,26 @@ Features added
 * #7199: A new node, ``sphinx.addnodes.pending_xref_condition`` has been added.
   It can be used to choose appropriate content of the reference by conditions.
 
+4.0.0b2
+
+* #8818: autodoc: Super class having ``Any`` arguments causes nit-picky warning
+* #9095: autodoc: TypeError is raised on processing broken metaclass
+* #9110: autodoc: metadata of GenericAlias is not rendered as a reference in
+  py37+
+* #9098: html: copy-range protection for doctests doesn't work in Safari
+* #9103: LaTeX: imgconverter: conversion runs even if not needed
+* #8127: py domain: Ellipsis in info-field-list causes nit-picky warning
+* #9121: py domain: duplicated warning is emitted when both canonical and its
+  alias objects are defined on the document
+* #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details.
+* #8195: mathjax: Rename :confval:`mathjax_config` to
+  :confval:`mathjax2_config` and add :confval:`mathjax3_config`
+
 Bugs fixed
 ----------
 
+4.0.0b1
+
 * #8917: autodoc: Raises a warning if function has wrong __globals__ value
 * #8415: autodoc: a TypeVar imported from other module is not resolved (in
   Python 3.7 or above)
@@ -194,6 +167,15 @@ Bugs fixed
   (function) declarators, and in the argument to ``sizeof...``.
 * C, fix linking of names in array declarators.
 
+4.0.0b2
+
+* C, C++, fix ``KeyError`` when an ``alias`` directive is the first C/C++
+  directive in a file with another C/C++ directive later.
+
+4.0.0b3
+
+* #9167: html: Failed to add CSS files to the specific page
+
 Release 3.5.5 (in development)
 ==============================
 
diff --git a/sphinx/__init__.py b/sphinx/__init__.py
index 4e679bd21f5..4fa8036d7b9 100644
--- a/sphinx/__init__.py
+++ b/sphinx/__init__.py
@@ -27,7 +27,7 @@
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
 
-__version__ = '4.0.0+'
+__version__ = '4.0.0'
 __released__ = '4.0.0'  # used when Sphinx builds its own docs
 
 #: Version info for better programmatic use.
@@ -38,7 +38,7 @@
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (4, 0, 0, 'beta', 3)
+version_info = (4, 0, 0, 'final', 0)
 
 package_dir = path.abspath(path.dirname(__file__))