Sphinx 7.2.5__py3-none-any.whl → 7.3.0__py3-none-any.whl

sphinx/locale/en_GB/LC_MESSAGES/sphinx.po

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2023 ORGANIZATION
+# Copyright (C) 2024 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,14 +8,14 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2023-08-17 14:58+0000\n"
+"POT-Creation-Date: 2024-04-14 23:27+0000\n"
 "PO-Revision-Date: 2013-04-02 08:44+0000\n"
 "Last-Translator: Adam Turner, 2022-2023\n"
 "Language-Team: English (United Kingdom) (http://app.transifex.com/sphinx-doc/sphinx-1/language/en_GB/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.12.1\n"
+"Generated-By: Babel 2.14.0\n"
 "Language: en_GB\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
@@ -38,104 +38,104 @@ msgstr "Source directory and destination directory cannot be identical"
 msgid "Running Sphinx v%s"
 msgstr "Running Sphinx v%s"
 
-#: sphinx/application.py:223
+#: sphinx/application.py:219
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "This project needs at least Sphinx v%s and therefore cannot be built with this version."
 
-#: sphinx/application.py:239
+#: sphinx/application.py:235
 msgid "making output directory"
 msgstr "making output directory"
 
-#: sphinx/application.py:244 sphinx/registry.py:444
+#: sphinx/application.py:240 sphinx/registry.py:450
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "while setting up extension %s:"
 
-#: sphinx/application.py:250
+#: sphinx/application.py:246
 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' 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."
 
-#: sphinx/application.py:281
+#: sphinx/application.py:277
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "loading translations [%s]... "
 
-#: sphinx/application.py:298 sphinx/util/display.py:84
+#: sphinx/application.py:294 sphinx/util/display.py:85
 msgid "done"
 msgstr "done"
 
-#: sphinx/application.py:300
+#: sphinx/application.py:296
 msgid "not available for built-in messages"
 msgstr "not available for built-in messages"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:310
 msgid "loading pickled environment"
 msgstr "loading pickled environment"
 
-#: sphinx/application.py:322
+#: sphinx/application.py:318
 #, python-format
 msgid "failed: %s"
 msgstr "failed: %s"
 
-#: sphinx/application.py:336
+#: sphinx/application.py:332
 msgid "No builder selected, using default: html"
 msgstr "No builder selected, using default: html"
 
-#: sphinx/application.py:369
+#: sphinx/application.py:365
 msgid "succeeded"
 msgstr "succeeded"
 
-#: sphinx/application.py:370
+#: sphinx/application.py:366
 msgid "finished with problems"
 msgstr "finished with problems"
 
-#: sphinx/application.py:374
+#: sphinx/application.py:370
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "build %s, %s warning (with warnings treated as errors)."
 
-#: sphinx/application.py:376
+#: sphinx/application.py:372
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "build %s, %s warnings (with warnings treated as errors)."
 
-#: sphinx/application.py:379
+#: sphinx/application.py:375
 #, python-format
 msgid "build %s, %s warning."
 msgstr "build %s, %s warning."
 
-#: sphinx/application.py:381
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "build %s, %s warnings."
 
-#: sphinx/application.py:385
+#: sphinx/application.py:381
 #, python-format
 msgid "build %s."
 msgstr "build %s."
 
-#: sphinx/application.py:616
+#: sphinx/application.py:610
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "node class %r is already registered, its visitors will be overridden"
 
-#: sphinx/application.py:695
+#: sphinx/application.py:689
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "directive %r is already registered, it will be overridden"
 
-#: sphinx/application.py:717 sphinx/application.py:739
+#: sphinx/application.py:711 sphinx/application.py:733
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "role %r is already registered, it will be overridden"
 
-#: sphinx/application.py:1288
+#: sphinx/application.py:1282
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@ msgid ""
 "explicit"
 msgstr "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"
 
-#: sphinx/application.py:1292
+#: sphinx/application.py:1286
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "the %s extension is not safe for parallel reading"
 
-#: sphinx/application.py:1295
+#: sphinx/application.py:1289
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,70 +156,75 @@ msgid ""
 "explicit"
 msgstr "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"
 
-#: sphinx/application.py:1299
+#: sphinx/application.py:1293
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "the %s extension is not safe for parallel writing"
 
-#: sphinx/application.py:1307 sphinx/application.py:1311
+#: sphinx/application.py:1301 sphinx/application.py:1305
 #, python-format
 msgid "doing serial %s"
 msgstr "doing serial %s"
 
-#: sphinx/config.py:179
+#: sphinx/config.py:309
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "config directory doesn't contain a conf.py file (%s)"
 
-#: sphinx/config.py:188
+#: sphinx/config.py:318
 msgid ""
 "Invalid configuration value found: 'language = None'. Update your "
 "configuration to a valid language code. Falling back to 'en' (English)."
 msgstr "Invalid configuration value found: 'language = None'. Update your configuration to a valid language code. Falling back to 'en' (English)."
 
-#: sphinx/config.py:217
+#: sphinx/config.py:341
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "cannot override dictionary config setting %r, ignoring (use %r to set individual elements)"
 
-#: sphinx/config.py:226
+#: sphinx/config.py:350
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "invalid number %r for config value %r, ignoring"
 
-#: sphinx/config.py:231
+#: sphinx/config.py:355
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "cannot override config setting %r with unsupported type, ignoring"
 
-#: sphinx/config.py:260
+#: sphinx/config.py:378
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "unknown config value %r in override, ignoring"
 
-#: sphinx/config.py:288
+#: sphinx/config.py:418
 #, python-format
-msgid "No such config value: %s"
-msgstr "No such config value: %s"
+msgid "No such config value: %r"
+msgstr ""
 
-#: sphinx/config.py:312
+#: sphinx/config.py:440
 #, python-format
 msgid "Config value %r already present"
 msgstr "Config value %r already present"
 
-#: sphinx/config.py:360
+#: sphinx/config.py:473
+#, python-format
+msgid "cannot cache unpickable configuration value: %r"
+msgstr ""
+
+#: sphinx/config.py:509
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "There is a syntax error in your configuration file: %s\n"
 
-#: sphinx/config.py:363
+#: sphinx/config.py:512
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "The configuration file (or one of the modules it imports) called sys.exit()"
 
-#: sphinx/config.py:370
+#: sphinx/config.py:519
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -227,291 +232,328 @@ msgid ""
 "%s"
 msgstr "There is a programmable error in your configuration file:\n\n%s"
 
-#: sphinx/config.py:393
+#: sphinx/config.py:540
+#, python-format
+msgid "Failed to convert %r to a set or tuple"
+msgstr ""
+
+#: sphinx/config.py:565
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given."
 
-#: sphinx/config.py:413
+#: sphinx/config.py:585
 #, python-format
 msgid "Section %s"
 msgstr "Section %s"
 
-#: sphinx/config.py:414
+#: sphinx/config.py:586
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:415
+#: sphinx/config.py:587
 #, python-format
 msgid "Table %s"
 msgstr "Table %s"
 
-#: sphinx/config.py:416
+#: sphinx/config.py:588
 #, python-format
 msgid "Listing %s"
 msgstr "Listing %s"
 
-#: sphinx/config.py:488
+#: sphinx/config.py:663
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "The config value `{name}` has to be a one of {candidates}, but `{current}` is given."
 
-#: sphinx/config.py:506
+#: sphinx/config.py:687
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "The config value `{name}' has type `{current.__name__}'; expected {permitted}."
 
-#: sphinx/config.py:518
+#: sphinx/config.py:700
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'."
 
-#: sphinx/config.py:528
+#: sphinx/config.py:711
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r not found, ignored."
 
-#: sphinx/config.py:540
+#: sphinx/config.py:723
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_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."
 
-#: sphinx/events.py:63
+#: sphinx/events.py:64
 #, python-format
 msgid "Event %r already present"
 msgstr "Event %r already present"
 
-#: sphinx/events.py:69
+#: sphinx/events.py:70
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Unknown event name: %s"
 
-#: sphinx/events.py:107
+#: sphinx/events.py:109
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr "Handler %r for event %r threw an exception"
 
-#: sphinx/extension.py:53
+#: sphinx/extension.py:55
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "The %s extension is required by needs_extensions settings, but it is not loaded."
 
-#: sphinx/extension.py:69
+#: sphinx/extension.py:76
 #, 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 "This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s)."
 
-#: sphinx/highlighting.py:149
+#: sphinx/highlighting.py:155
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Pygments lexer name %r is not known"
 
-#: sphinx/highlighting.py:176
+#: sphinx/highlighting.py:189
 #, python-format
 msgid ""
 "Lexing literal_block %r as \"%s\" resulted in an error at token: %r. "
 "Retrying in relaxed mode."
 msgstr ""
 
-#: sphinx/project.py:65
+#: sphinx/project.py:66
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr "multiple files found for the document \"%s\": %r\nUse %r for the build."
 
-#: sphinx/project.py:74
+#: sphinx/project.py:81
 #, python-format
 msgid "Ignored unreadable document %r."
 msgstr ""
 
-#: sphinx/registry.py:136
+#: sphinx/registry.py:142
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Builder class %s has no \"name\" attribute"
 
-#: sphinx/registry.py:138
+#: sphinx/registry.py:144
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r already exists (in module %s)"
 
-#: sphinx/registry.py:151
+#: sphinx/registry.py:157
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Builder name %s not registered or available through entry point"
 
-#: sphinx/registry.py:158
+#: sphinx/registry.py:164
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Builder name %s not registered"
 
-#: sphinx/registry.py:165
+#: sphinx/registry.py:171
 #, python-format
 msgid "domain %s already registered"
 msgstr "domain %s already registered"
 
-#: sphinx/registry.py:188 sphinx/registry.py:201 sphinx/registry.py:212
+#: sphinx/registry.py:194 sphinx/registry.py:207 sphinx/registry.py:218
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domain %s not yet registered"
 
-#: sphinx/registry.py:192
+#: sphinx/registry.py:198
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "The %r directive is already registered to domain %s"
 
-#: sphinx/registry.py:204
+#: sphinx/registry.py:210
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "The %r role is already registered to domain %s"
 
-#: sphinx/registry.py:215
+#: sphinx/registry.py:221
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "The %r index is already registered to domain %s"
 
-#: sphinx/registry.py:246
+#: sphinx/registry.py:252
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "The %r object_type is already registered"
 
-#: sphinx/registry.py:272
+#: sphinx/registry.py:278
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "The %r crossref_type is already registered"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:285
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r is already registered"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:294
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser for %r is already registered"
 
-#: sphinx/registry.py:296
+#: sphinx/registry.py:302
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Source parser for %s not registered"
 
-#: sphinx/registry.py:312
+#: sphinx/registry.py:318
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Translator for %r already exists"
 
-#: sphinx/registry.py:328
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:417
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r already registered"
 
-#: sphinx/registry.py:423
+#: sphinx/registry.py:429
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr "maths renderer %s is already registered"
 
-#: sphinx/registry.py:438
+#: sphinx/registry.py:444
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "the extension %r was already merged with Sphinx since version %s; this extension is ignored."
 
-#: sphinx/registry.py:449
+#: sphinx/registry.py:455
 msgid "Original exception:\n"
 msgstr "Original exception:\n"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:456
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Could not import extension %s"
 
-#: sphinx/registry.py:455
+#: sphinx/registry.py:461
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "extension %r has no setup() function; is it really a Sphinx extension module?"
 
-#: sphinx/registry.py:464
+#: sphinx/registry.py:470
 #, 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 "The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version."
 
-#: sphinx/registry.py:472
+#: sphinx/registry.py:478
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary"
 
-#: sphinx/roles.py:178
+#: sphinx/roles.py:201
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:194
+#: sphinx/roles.py:222
 #, python-format
 msgid "invalid PEP number %s"
 msgstr "invalid PEP number %s"
 
-#: sphinx/roles.py:228
+#: sphinx/roles.py:257
 #, python-format
 msgid "invalid RFC number %s"
 msgstr "invalid RFC number %s"
 
-#: sphinx/theming.py:77
-#, python-format
-msgid "theme %r doesn't have \"theme\" setting"
-msgstr "theme %r doesn't have \"theme\" setting"
-
-#: sphinx/theming.py:79
-#, python-format
-msgid "theme %r doesn't have \"inherit\" setting"
-msgstr "theme %r doesn't have \"inherit\" setting"
-
-#: sphinx/theming.py:85
-#, python-format
-msgid "no theme named %r found, inherited by %r"
-msgstr "no theme named %r found, inherited by %r"
-
-#: sphinx/theming.py:108
+#: sphinx/theming.py:125
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "setting %s.%s occurs in none of the searched theme configs"
 
-#: sphinx/theming.py:127
+#: sphinx/theming.py:140
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "unsupported theme option %r given"
 
-#: sphinx/theming.py:216
+#: sphinx/theming.py:206
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "file %r on theme path is not a valid zipfile or contains no theme"
 
-#: sphinx/theming.py:230
+#: sphinx/theming.py:226
+#, python-format
+msgid "no theme named %r found (missing theme.toml?)"
+msgstr ""
+
+#: sphinx/theming.py:259
 #, python-format
-msgid "no theme named %r found (missing theme.conf?)"
-msgstr "no theme named %r found (missing theme.conf?)"
+msgid "The %r theme has circular inheritance"
+msgstr ""
+
+#: sphinx/theming.py:262
+#, python-format
+msgid ""
+"The %r theme inherits from %r, which is not a loaded theme. Loaded themes "
+"are: %s"
+msgstr ""
+
+#: sphinx/theming.py:269
+#, python-format
+msgid "The %r theme has too many ancestors"
+msgstr ""
+
+#: sphinx/theming.py:295
+#, python-format
+msgid "no theme configuration file found in %r"
+msgstr ""
+
+#: sphinx/theming.py:323 sphinx/theming.py:374
+#, python-format
+msgid "theme %r doesn't have the \"theme\" table"
+msgstr ""
+
+#: sphinx/theming.py:327
+#, python-format
+msgid "The %r theme \"[theme]\" table is not a table"
+msgstr ""
+
+#: sphinx/theming.py:331 sphinx/theming.py:377
+#, python-format
+msgid "The %r theme must define the \"theme.inherit\" setting"
+msgstr ""
+
+#: sphinx/theming.py:335
+#, python-format
+msgid "The %r theme \"[options]\" table is not a table"
+msgstr ""
+
+#: sphinx/theming.py:353
+#, python-format
+msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\""
+msgstr ""
 
 #: sphinx/builders/__init__.py:183
 #, python-format
@@ -527,8 +569,8 @@ msgstr "a suitable image for %s builder not found: %s"
 msgid "building [mo]: "
 msgstr "building [mo]: "
 
-#: sphinx/builders/__init__.py:208 sphinx/builders/__init__.py:575
-#: sphinx/builders/__init__.py:602
+#: sphinx/builders/__init__.py:208 sphinx/builders/__init__.py:574
+#: sphinx/builders/__init__.py:601
 msgid "writing output... "
 msgstr "writing output... "
 
@@ -577,7 +619,7 @@ msgstr "%d source files given on command line"
 msgid "targets for %d source files that are out of date"
 msgstr "targets for %d source files that are out of date"
 
-#: sphinx/builders/__init__.py:309 sphinx/builders/gettext.py:236
+#: sphinx/builders/__init__.py:309 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building [%s]: "
 msgstr "building [%s]: "
@@ -586,50 +628,50 @@ msgstr "building [%s]: "
 msgid "looking for now-outdated files... "
 msgstr "looking for now-outdated files... "
 
-#: sphinx/builders/__init__.py:321
+#: sphinx/builders/__init__.py:320
 #, python-format
 msgid "%d found"
 msgstr "%d found"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:322
 msgid "none found"
 msgstr "none found"
 
-#: sphinx/builders/__init__.py:328
+#: sphinx/builders/__init__.py:327
 msgid "pickling environment"
 msgstr "pickling environment"
 
-#: sphinx/builders/__init__.py:334
+#: sphinx/builders/__init__.py:333
 msgid "checking consistency"
 msgstr "checking consistency"
 
-#: sphinx/builders/__init__.py:338
+#: sphinx/builders/__init__.py:337
 msgid "no targets are out of date."
 msgstr "no targets are out of date."
 
-#: sphinx/builders/__init__.py:377
+#: sphinx/builders/__init__.py:376
 msgid "updating environment: "
 msgstr "updating environment: "
 
-#: sphinx/builders/__init__.py:398
+#: sphinx/builders/__init__.py:397
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s added, %s changed, %s removed"
 
-#: sphinx/builders/__init__.py:436 sphinx/builders/__init__.py:448
+#: sphinx/builders/__init__.py:435 sphinx/builders/__init__.py:447
 msgid "reading sources... "
 msgstr "reading sources... "
 
-#: sphinx/builders/__init__.py:550
+#: sphinx/builders/__init__.py:549
 #, python-format
 msgid "docnames to write: %s"
 msgstr "docnames to write: %s"
 
-#: sphinx/builders/__init__.py:559 sphinx/builders/singlehtml.py:155
+#: sphinx/builders/__init__.py:558 sphinx/builders/singlehtml.py:157
 msgid "preparing documents"
 msgstr "preparing documents"
 
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:561
 msgid "copying assets"
 msgstr "copying assets"
 
@@ -638,36 +680,36 @@ msgstr "copying assets"
 msgid "duplicated ToC entry found: %s"
 msgstr "duplicated ToC entry found: %s"
 
-#: sphinx/builders/_epub_base.py:403 sphinx/builders/html/__init__.py:750
-#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:183
+#: sphinx/builders/_epub_base.py:404 sphinx/builders/html/__init__.py:758
+#: sphinx/builders/latex/__init__.py:432 sphinx/builders/texinfo.py:187
 msgid "copying images... "
 msgstr "copying images... "
 
-#: sphinx/builders/_epub_base.py:410
+#: sphinx/builders/_epub_base.py:411
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "cannot read image file %r: copying it instead"
 
-#: sphinx/builders/_epub_base.py:416 sphinx/builders/html/__init__.py:758
-#: sphinx/builders/latex/__init__.py:433 sphinx/builders/texinfo.py:193
+#: sphinx/builders/_epub_base.py:417 sphinx/builders/html/__init__.py:766
+#: sphinx/builders/latex/__init__.py:440 sphinx/builders/texinfo.py:197
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "cannot copy image file %r: %s"
 
-#: sphinx/builders/_epub_base.py:433
+#: sphinx/builders/_epub_base.py:434
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "cannot write image file %r: %s"
 
-#: sphinx/builders/_epub_base.py:443
+#: sphinx/builders/_epub_base.py:444
 msgid "Pillow not found - copying image files"
 msgstr "Pillow not found - copying image files"
 
-#: sphinx/builders/_epub_base.py:469
+#: sphinx/builders/_epub_base.py:470
 msgid "writing mimetype file..."
 msgstr "writing mimetype file..."
 
-#: sphinx/builders/_epub_base.py:474
+#: sphinx/builders/_epub_base.py:475
 msgid "writing META-INF/container.xml file..."
 msgstr "writing META-INF/container.xml file..."
 
@@ -675,470 +717,470 @@ msgstr "writing META-INF/container.xml file..."
 msgid "writing content.opf file..."
 msgstr "writing content.opf file..."
 
-#: sphinx/builders/_epub_base.py:531
+#: sphinx/builders/_epub_base.py:539
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "unknown mimetype for %s, ignoring"
 
-#: sphinx/builders/_epub_base.py:678
+#: sphinx/builders/_epub_base.py:686
 msgid "writing toc.ncx file..."
 msgstr "writing toc.ncx file..."
 
-#: sphinx/builders/_epub_base.py:703
+#: sphinx/builders/_epub_base.py:711
 #, python-format
 msgid "writing %s file..."
 msgstr "writing %s file..."
 
-#: sphinx/builders/changes.py:30
+#: sphinx/builders/changes.py:32
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "The overview file is in %(outdir)s."
 
-#: sphinx/builders/changes.py:56
+#: sphinx/builders/changes.py:59
 #, python-format
 msgid "no changes in version %s."
 msgstr "no changes in version %s."
 
-#: sphinx/builders/changes.py:58
+#: sphinx/builders/changes.py:61
 msgid "writing summary file..."
 msgstr "writing summary file..."
 
-#: sphinx/builders/changes.py:73
+#: sphinx/builders/changes.py:76
 msgid "Builtins"
 msgstr "Builtins"
 
-#: sphinx/builders/changes.py:75
+#: sphinx/builders/changes.py:78
 msgid "Module level"
 msgstr "Module level"
 
-#: sphinx/builders/changes.py:118
+#: sphinx/builders/changes.py:123
 msgid "copying source files..."
 msgstr "copying source files..."
 
-#: sphinx/builders/changes.py:125
+#: sphinx/builders/changes.py:130
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "could not read %r for changelog creation"
 
-#: sphinx/builders/dummy.py:18
+#: sphinx/builders/dummy.py:19
 msgid "The dummy builder generates no files."
 msgstr "The dummy builder generates no files."
 
-#: sphinx/builders/epub3.py:79
+#: sphinx/builders/epub3.py:81
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "The ePub file is in %(outdir)s."
 
-#: sphinx/builders/epub3.py:183
+#: sphinx/builders/epub3.py:185
 msgid "writing nav.xhtml file..."
 msgstr "writing nav.xhtml file..."
 
-#: sphinx/builders/epub3.py:209
+#: sphinx/builders/epub3.py:211
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 
-#: sphinx/builders/epub3.py:213
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "conf value \"epub_uid\" should be XML NAME for EPUB3"
 
-#: sphinx/builders/epub3.py:216
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 
-#: sphinx/builders/epub3.py:220
+#: sphinx/builders/epub3.py:222
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "conf value \"epub_author\" should not be empty for EPUB3"
 
-#: sphinx/builders/epub3.py:223
+#: sphinx/builders/epub3.py:225
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "conf value \"epub_contributor\" should not be empty for EPUB3"
 
-#: sphinx/builders/epub3.py:226
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "conf value \"epub_description\" should not be empty for EPUB3"
 
-#: sphinx/builders/epub3.py:229
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "conf value \"epub_publisher\" should not be empty for EPUB3"
 
-#: sphinx/builders/epub3.py:232
+#: sphinx/builders/epub3.py:234
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 
-#: sphinx/builders/epub3.py:236
+#: sphinx/builders/epub3.py:238
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "conf value \"epub_identifier\" should not be empty for EPUB3"
 
-#: sphinx/builders/epub3.py:239
+#: sphinx/builders/epub3.py:241
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "conf value \"version\" should not be empty for EPUB3"
 
-#: sphinx/builders/epub3.py:253 sphinx/builders/html/__init__.py:1189
+#: sphinx/builders/epub3.py:255 sphinx/builders/html/__init__.py:1187
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "invalid css_file: %r, ignored"
 
-#: sphinx/builders/gettext.py:215
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "The message catalogues are in %(outdir)s."
 
-#: sphinx/builders/gettext.py:237
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "targets for %d template files"
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "reading templates... "
 
-#: sphinx/builders/gettext.py:275
+#: sphinx/builders/gettext.py:282
 msgid "writing message catalogs... "
 msgstr "writing message catalogues... "
 
-#: sphinx/builders/linkcheck.py:60
+#: sphinx/builders/linkcheck.py:59
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Look for any errors in the above output or in %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:109
+#: sphinx/builders/linkcheck.py:137
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "broken link: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:606
+#: sphinx/builders/linkcheck.py:660
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 
-#: sphinx/builders/manpage.py:35
+#: sphinx/builders/manpage.py:37
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "The manual pages are in %(outdir)s."
 
-#: sphinx/builders/manpage.py:42
+#: sphinx/builders/manpage.py:44
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "no \"man_pages\" config value found; no manual pages will be written"
 
-#: sphinx/builders/latex/__init__.py:309 sphinx/builders/manpage.py:51
-#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:110
+#: sphinx/builders/latex/__init__.py:314 sphinx/builders/manpage.py:53
+#: sphinx/builders/singlehtml.py:165 sphinx/builders/texinfo.py:112
 msgid "writing"
 msgstr "writing"
 
-#: sphinx/builders/manpage.py:66
+#: sphinx/builders/manpage.py:68
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "\"man_pages\" config value references unknown document %s"
 
-#: sphinx/builders/singlehtml.py:32
+#: sphinx/builders/singlehtml.py:34
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "The HTML page is in %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:158
+#: sphinx/builders/singlehtml.py:160
 msgid "assembling single document"
 msgstr "assembling single document"
 
-#: sphinx/builders/singlehtml.py:176
+#: sphinx/builders/singlehtml.py:178
 msgid "writing additional files"
 msgstr "writing additional files"
 
-#: sphinx/builders/texinfo.py:46
+#: sphinx/builders/texinfo.py:48
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "The Texinfo files are in %(outdir)s."
 
-#: sphinx/builders/texinfo.py:48
+#: sphinx/builders/texinfo.py:50
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nRun 'make' in that directory to run these through makeinfo\n(use 'make info' here to do that automatically)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:77
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "no \"texinfo_documents\" config value found; no documents will be written"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:85
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "\"texinfo_documents\" config value references unknown document %s"
 
-#: sphinx/builders/latex/__init__.py:291 sphinx/builders/texinfo.py:106
+#: sphinx/builders/latex/__init__.py:296 sphinx/builders/texinfo.py:108
 #, python-format
 msgid "processing %s"
 msgstr "processing %s"
 
-#: sphinx/builders/latex/__init__.py:364 sphinx/builders/texinfo.py:159
+#: sphinx/builders/latex/__init__.py:369 sphinx/builders/texinfo.py:161
 msgid "resolving references..."
 msgstr "resolving references..."
 
-#: sphinx/builders/latex/__init__.py:374 sphinx/builders/texinfo.py:168
+#: sphinx/builders/latex/__init__.py:380 sphinx/builders/texinfo.py:171
 msgid " (in "
 msgstr " (in "
 
-#: sphinx/builders/texinfo.py:198
+#: sphinx/builders/texinfo.py:202
 msgid "copying Texinfo support files"
 msgstr "copying Texinfo support files"
 
-#: sphinx/builders/texinfo.py:202
+#: sphinx/builders/texinfo.py:206
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "error writing file Makefile: %s"
 
-#: sphinx/builders/text.py:29
+#: sphinx/builders/text.py:30
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "The text files are in %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1140 sphinx/builders/text.py:76
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1138 sphinx/builders/text.py:77
+#: sphinx/builders/xml.py:96
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "error writing file %s: %s"
 
-#: sphinx/builders/xml.py:34
+#: sphinx/builders/xml.py:36
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "The XML files are in %(outdir)s."
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:109
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "The pseudo-XML files are in %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:122
+#: sphinx/builders/html/__init__.py:130
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "build info file is broken: %r"
 
-#: sphinx/builders/html/__init__.py:159
+#: sphinx/builders/html/__init__.py:168
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "The HTML pages are in %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:385
+#: sphinx/builders/html/__init__.py:394
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Failed to read build info file: %r"
 
-#: sphinx/builders/html/__init__.py:478 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:100
-#: sphinx/writers/texinfo.py:225
+#: sphinx/builders/html/__init__.py:487 sphinx/builders/latex/__init__.py:189
+#: sphinx/transforms/__init__.py:119 sphinx/writers/manpage.py:101
+#: sphinx/writers/texinfo.py:227
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:497 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:506 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "General Index"
 
-#: sphinx/builders/html/__init__.py:497
+#: sphinx/builders/html/__init__.py:506
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:569
+#: sphinx/builders/html/__init__.py:579
 msgid "next"
 msgstr "next"
 
-#: sphinx/builders/html/__init__.py:578
+#: sphinx/builders/html/__init__.py:588
 msgid "previous"
 msgstr "previous"
 
-#: sphinx/builders/html/__init__.py:674
+#: sphinx/builders/html/__init__.py:684
 msgid "generating indices"
 msgstr "generating indices"
 
-#: sphinx/builders/html/__init__.py:689
+#: sphinx/builders/html/__init__.py:699
 msgid "writing additional pages"
 msgstr "writing additional pages"
 
-#: sphinx/builders/html/__init__.py:768
+#: sphinx/builders/html/__init__.py:776
 msgid "copying downloadable files... "
 msgstr "copying downloadable files... "
 
-#: sphinx/builders/html/__init__.py:776
+#: sphinx/builders/html/__init__.py:784
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "cannot copy downloadable file %r: %s"
 
-#: sphinx/builders/html/__init__.py:809 sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:817 sphinx/builders/html/__init__.py:829
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr "Failed to copy a file in html_static_file: %s: %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:850
 msgid "copying static files"
 msgstr "copying static files"
 
-#: sphinx/builders/html/__init__.py:858
+#: sphinx/builders/html/__init__.py:866
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "cannot copy static file %r"
 
-#: sphinx/builders/html/__init__.py:863
+#: sphinx/builders/html/__init__.py:871
 msgid "copying extra files"
 msgstr "copying extra files"
 
-#: sphinx/builders/html/__init__.py:869
+#: sphinx/builders/html/__init__.py:877
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "cannot copy extra file %r"
 
-#: sphinx/builders/html/__init__.py:876
+#: sphinx/builders/html/__init__.py:884
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Failed to write build info file: %r"
 
-#: sphinx/builders/html/__init__.py:925
+#: sphinx/builders/html/__init__.py:933
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "search index couldn't be loaded, but not all documents will be built: the index will be incomplete."
 
-#: sphinx/builders/html/__init__.py:986
+#: sphinx/builders/html/__init__.py:978
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "page %s matches two patterns in html_sidebars: %r and %r"
 
-#: sphinx/builders/html/__init__.py:1123
+#: sphinx/builders/html/__init__.py:1121
 #, 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 "a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings."
 
-#: sphinx/builders/html/__init__.py:1128
+#: sphinx/builders/html/__init__.py:1126
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "An error happened in rendering the page %s.\nReason: %r"
 
-#: sphinx/builders/html/__init__.py:1156
+#: sphinx/builders/html/__init__.py:1154
 msgid "dumping object inventory"
 msgstr "dumping object inventory"
 
-#: sphinx/builders/html/__init__.py:1164
+#: sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "dumping search index in %s"
 msgstr "dumping search index in %s"
 
-#: sphinx/builders/html/__init__.py:1212
+#: sphinx/builders/html/__init__.py:1210
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "invalid js_file: %r, ignored"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1238
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Many math_renderers are registered. But no math_renderer is selected."
 
-#: sphinx/builders/html/__init__.py:1243
+#: sphinx/builders/html/__init__.py:1241
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Unknown math_renderer %r is given."
 
-#: sphinx/builders/html/__init__.py:1251
+#: sphinx/builders/html/__init__.py:1249
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path entry %r does not exist"
 
-#: sphinx/builders/html/__init__.py:1255
+#: sphinx/builders/html/__init__.py:1253
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "html_extra_path entry %r is placed inside outdir"
 
-#: sphinx/builders/html/__init__.py:1264
+#: sphinx/builders/html/__init__.py:1262
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "html_static_path entry %r does not exist"
 
-#: sphinx/builders/html/__init__.py:1268
+#: sphinx/builders/html/__init__.py:1266
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "html_static_path entry %r is placed inside outdir"
 
-#: sphinx/builders/html/__init__.py:1277 sphinx/builders/latex/__init__.py:437
+#: sphinx/builders/html/__init__.py:1275 sphinx/builders/latex/__init__.py:444
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "logo file %r does not exist"
 
-#: sphinx/builders/html/__init__.py:1286
+#: sphinx/builders/html/__init__.py:1284
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "favicon file %r does not exist"
 
-#: sphinx/builders/html/__init__.py:1293
+#: sphinx/builders/html/__init__.py:1291
 msgid ""
 "HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in "
 "configuration options)"
 msgstr "HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in configuration options)"
 
-#: sphinx/builders/html/__init__.py:1308
+#: sphinx/builders/html/__init__.py:1306
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s documentation"
 
-#: sphinx/builders/latex/__init__.py:113
+#: sphinx/builders/latex/__init__.py:115
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "The LaTeX files are in %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:115
+#: sphinx/builders/latex/__init__.py:117
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nRun 'make' in that directory to run these through (pdf)latex\n(use `make latexpdf' here to do that automatically)."
 
-#: sphinx/builders/latex/__init__.py:150
+#: sphinx/builders/latex/__init__.py:152
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "no \"latex_documents\" config value found; no documents will be written"
 
-#: sphinx/builders/latex/__init__.py:158
+#: sphinx/builders/latex/__init__.py:160
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "\"latex_documents\" config value references unknown document %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:557
-#: sphinx/domains/std.py:569 sphinx/templates/latex/latex.tex_t:106
+#: sphinx/builders/latex/__init__.py:196 sphinx/domains/std/__init__.py:559
+#: sphinx/domains/std/__init__.py:571 sphinx/templates/latex/latex.tex_t:106
 #: 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:138
-#: sphinx/writers/texinfo.py:493
+#: sphinx/writers/texinfo.py:497
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:91
+#: sphinx/builders/latex/__init__.py:199 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Release"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:370
+#: sphinx/builders/latex/__init__.py:213 sphinx/writers/latex.py:370
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "no Babel option known for language %r"
 
-#: sphinx/builders/latex/__init__.py:387
+#: sphinx/builders/latex/__init__.py:394
 msgid "copying TeX support files"
 msgstr "copying TeX support files"
 
-#: sphinx/builders/latex/__init__.py:403
+#: sphinx/builders/latex/__init__.py:410
 msgid "copying TeX support files..."
 msgstr "copying TeX support files..."
 
-#: sphinx/builders/latex/__init__.py:416
+#: sphinx/builders/latex/__init__.py:423
 msgid "copying additional files"
 msgstr "copying additional files"
 
-#: sphinx/builders/latex/__init__.py:459
+#: sphinx/builders/latex/__init__.py:466
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr "Unknown configure key: latex_elements[%r], ignored."
 
-#: sphinx/builders/latex/__init__.py:467
+#: sphinx/builders/latex/__init__.py:474
 #, python-format
 msgid "Unknown theme option: latex_theme_options[%r], ignored."
 msgstr "Unknown theme option: latex_theme_options[%r], ignored."
@@ -1153,15 +1195,15 @@ msgstr "%r doesn't have \"theme\" setting"
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r doesn't have \"%s\" setting"
 
-#: sphinx/builders/latex/transforms.py:117
+#: sphinx/builders/latex/transforms.py:120
 msgid "Failed to get a docname!"
 msgstr "Failed to get a docname!"
 
-#: sphinx/builders/latex/transforms.py:118
+#: sphinx/builders/latex/transforms.py:121
 msgid "Failed to get a docname for source {source!r}!"
 msgstr "Failed to get a docname for source {source!r}!"
 
-#: sphinx/builders/latex/transforms.py:479
+#: sphinx/builders/latex/transforms.py:482
 #, python-format
 msgid "No footnote was found for given reference node %r"
 msgstr "No footnote was found for given reference node %r"
@@ -1220,8 +1262,8 @@ msgstr "A bug report can be filed in the tracker at <https://github.com/sphinx-d
 msgid "job number should be a positive number"
 msgstr "job number should be a positive number"
 
-#: sphinx/cmd/build.py:117 sphinx/cmd/quickstart.py:477
-#: sphinx/ext/apidoc.py:319 sphinx/ext/autosummary/generate.py:689
+#: sphinx/cmd/build.py:117 sphinx/cmd/quickstart.py:474
+#: sphinx/ext/apidoc.py:317 sphinx/ext/autosummary/generate.py:689
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr "For more information, visit <https://www.sphinx-doc.org/>."
 
@@ -1253,257 +1295,264 @@ msgid "path to output directory"
 msgstr "path to output directory"
 
 #: sphinx/cmd/build.py:143
-msgid "a list of specific files to rebuild. Ignored if -a is specified"
-msgstr "a list of specific files to rebuild. Ignored if -a is specified"
+msgid ""
+"(optional) a list of specific files to rebuild. Ignored if --write-all is "
+"specified"
+msgstr ""
 
 #: sphinx/cmd/build.py:146
 msgid "general options"
 msgstr "general options"
 
 #: sphinx/cmd/build.py:149
-msgid "builder to use (default: html)"
-msgstr "builder to use (default: html)"
+msgid "builder to use (default: 'html')"
+msgstr ""
+
+#: sphinx/cmd/build.py:152
+msgid ""
+"run in parallel with N processes, when possible. 'auto' uses the number of "
+"CPU cores"
+msgstr ""
 
-#: sphinx/cmd/build.py:151
+#: sphinx/cmd/build.py:155
 msgid "write all files (default: only write new and changed files)"
 msgstr "write all files (default: only write new and changed files)"
 
-#: sphinx/cmd/build.py:154
+#: sphinx/cmd/build.py:158
 msgid "don't use a saved environment, always read all files"
 msgstr "don't use a saved environment, always read all files"
 
-#: sphinx/cmd/build.py:157
-msgid ""
-"path for the cached environment and doctree files (default: "
-"OUTPUTDIR/.doctrees)"
-msgstr "path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)"
-
 #: sphinx/cmd/build.py:161
-msgid ""
-"build in parallel with N processes where possible (special value \"auto\" "
-"will set N to cpu-count)"
-msgstr "build in parallel with N processes where possible (special value \"auto\" will set N to cpu-count)"
+msgid "path options"
+msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid ""
-"path where configuration file (conf.py) is located (default: same as "
-"SOURCEDIR)"
-msgstr "path where configuration file (conf.py) is located (default: same as SOURCEDIR)"
+"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)"
+msgstr ""
 
-#: sphinx/cmd/build.py:168
-msgid "use no config file at all, only -D options"
-msgstr "use no config file at all, only -D options"
+#: sphinx/cmd/build.py:166
+msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)"
+msgstr ""
 
 #: sphinx/cmd/build.py:171
+msgid "use no configuration file, only use settings from -D options"
+msgstr ""
+
+#: sphinx/cmd/build.py:174
 msgid "override a setting in configuration file"
 msgstr "override a setting in configuration file"
 
-#: sphinx/cmd/build.py:174
+#: sphinx/cmd/build.py:177
 msgid "pass a value into HTML templates"
 msgstr "pass a value into HTML templates"
 
-#: sphinx/cmd/build.py:177
+#: sphinx/cmd/build.py:180
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "define tag: include \"only\" blocks with TAG"
 
-#: sphinx/cmd/build.py:179
-msgid "nit-picky mode, warn about all missing references"
-msgstr "nit-picky mode, warn about all missing references"
-
 #: sphinx/cmd/build.py:182
+msgid "nit-picky mode: warn about all missing references"
+msgstr ""
+
+#: sphinx/cmd/build.py:184
 msgid "console output options"
 msgstr "console output options"
 
-#: sphinx/cmd/build.py:184
+#: sphinx/cmd/build.py:187
 msgid "increase verbosity (can be repeated)"
 msgstr "increase verbosity (can be repeated)"
 
-#: sphinx/cmd/build.py:186 sphinx/ext/apidoc.py:342
+#: sphinx/cmd/build.py:189 sphinx/ext/apidoc.py:340
 msgid "no output on stdout, just warnings on stderr"
 msgstr "no output on stdout, just warnings on stderr"
 
-#: sphinx/cmd/build.py:188
+#: sphinx/cmd/build.py:191
 msgid "no output at all, not even warnings"
 msgstr "no output at all, not even warnings"
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:194
 msgid "do emit colored output (default: auto-detect)"
 msgstr "do emit colored output (default: auto-detect)"
 
-#: sphinx/cmd/build.py:194
+#: sphinx/cmd/build.py:197
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "do not emit coloured output (default: auto-detect)"
 
-#: sphinx/cmd/build.py:197
+#: sphinx/cmd/build.py:199
+msgid "warning control options"
+msgstr ""
+
+#: sphinx/cmd/build.py:201
 msgid "write warnings (and errors) to given file"
 msgstr "write warnings (and errors) to given file"
 
-#: sphinx/cmd/build.py:199
+#: sphinx/cmd/build.py:203
 msgid "turn warnings into errors"
 msgstr "turn warnings into errors"
 
-#: sphinx/cmd/build.py:201
-msgid "with -W, keep going when getting warnings"
-msgstr "with -W, keep going when getting warnings"
+#: sphinx/cmd/build.py:205
+msgid "with --fail-on-warning, keep going when getting warnings"
+msgstr ""
 
-#: sphinx/cmd/build.py:203
+#: sphinx/cmd/build.py:207
 msgid "show full traceback on exception"
 msgstr "show full traceback on exception"
 
-#: sphinx/cmd/build.py:205
+#: sphinx/cmd/build.py:209
 msgid "run Pdb on exception"
 msgstr "run Pdb on exception"
 
-#: sphinx/cmd/build.py:229
+#: sphinx/cmd/build.py:244
 msgid "cannot combine -a option and filenames"
 msgstr "cannot combine -a option and filenames"
 
-#: sphinx/cmd/build.py:250
+#: sphinx/cmd/build.py:276
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "cannot open warning file %r: %s"
 
-#: sphinx/cmd/build.py:264
+#: sphinx/cmd/build.py:296
 msgid "-D option argument must be in the form name=value"
 msgstr "-D option argument must be in the form name=value"
 
-#: sphinx/cmd/build.py:271
+#: sphinx/cmd/build.py:303
 msgid "-A option argument must be in the form name=value"
 msgstr "-A option argument must be in the form name=value"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:42
 msgid "automatically insert docstrings from modules"
 msgstr "automatically insert docstrings from modules"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:43
 msgid "automatically test code snippets in doctest blocks"
 msgstr "automatically test code snippets in doctest blocks"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:44
 msgid "link between Sphinx documentation of different projects"
 msgstr "link between Sphinx documentation of different projects"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:45
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "write \"todo\" entries that can be shown or hidden on build"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:46
 msgid "checks for documentation coverage"
 msgstr "checks for documentation coverage"
 
-#: sphinx/cmd/quickstart.py:53
+#: sphinx/cmd/quickstart.py:47
 msgid "include math, rendered as PNG or SVG images"
 msgstr "include maths, rendered as PNG or SVG images"
 
-#: sphinx/cmd/quickstart.py:54
+#: sphinx/cmd/quickstart.py:48
 msgid "include math, rendered in the browser by MathJax"
 msgstr "include maths, rendered in the browser by MathJax"
 
-#: sphinx/cmd/quickstart.py:55
+#: sphinx/cmd/quickstart.py:49
 msgid "conditional inclusion of content based on config values"
 msgstr "conditional inclusion of content based on config values"
 
-#: sphinx/cmd/quickstart.py:56
+#: sphinx/cmd/quickstart.py:50
 msgid "include links to the source code of documented Python objects"
 msgstr "include links to the source code of documented Python objects"
 
-#: sphinx/cmd/quickstart.py:57
+#: sphinx/cmd/quickstart.py:51
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "create .nojekyll file to publish the document on GitHub pages"
 
-#: sphinx/cmd/quickstart.py:99
+#: sphinx/cmd/quickstart.py:93
 msgid "Please enter a valid path name."
 msgstr "Please enter a valid path name."
 
-#: sphinx/cmd/quickstart.py:115
+#: sphinx/cmd/quickstart.py:109
 msgid "Please enter some text."
 msgstr "Please enter some text."
 
-#: sphinx/cmd/quickstart.py:122
+#: sphinx/cmd/quickstart.py:116
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Please enter one of %s."
 
-#: sphinx/cmd/quickstart.py:129
+#: sphinx/cmd/quickstart.py:123
 msgid "Please enter either 'y' or 'n'."
 msgstr "Please enter either 'y' or 'n'."
 
-#: sphinx/cmd/quickstart.py:135
+#: sphinx/cmd/quickstart.py:129
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Please enter a file suffix, e.g. '.rst' or '.txt'."
 
-#: sphinx/cmd/quickstart.py:215
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Welcome to the Sphinx %s quickstart utility."
 
-#: sphinx/cmd/quickstart.py:217
+#: sphinx/cmd/quickstart.py:210
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Please enter values for the following settings (just press Enter to\naccept a default value, if one is given in brackets)."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Selected root path: %s"
 
-#: sphinx/cmd/quickstart.py:225
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr "Enter the root path for documentation."
 
-#: sphinx/cmd/quickstart.py:226
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr "Root path for the documentation"
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Error: an existing conf.py has been found in the selected root path."
 
-#: sphinx/cmd/quickstart.py:233
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart will not overwrite existing Sphinx projects."
 
-#: sphinx/cmd/quickstart.py:235
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Please enter a new root path (or just Enter to exit)"
 
-#: sphinx/cmd/quickstart.py:242
+#: sphinx/cmd/quickstart.py:235
 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 "You have two options for placing the build directory for Sphinx output.\nEither, you use a directory \"_build\" within the root path, or you separate\n\"source\" and \"build\" directories within the root path."
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr "Separate source and build directories (y/n)"
 
-#: sphinx/cmd/quickstart.py:249
+#: sphinx/cmd/quickstart.py:242
 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 "Inside the root directory, two more directories will be created; \"_templates\"\nfor custom HTML templates and \"_static\" for custom stylesheets and other static\nfiles. You can enter another prefix (such as \".\") to replace the underscore."
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr "Name prefix for templates and static dir"
 
-#: sphinx/cmd/quickstart.py:256
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "The project name will occur in several places in the built documentation."
 
-#: sphinx/cmd/quickstart.py:257
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr "Project name"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr "Author name(s)"
 
-#: sphinx/cmd/quickstart.py:263
+#: sphinx/cmd/quickstart.py:256
 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"
@@ -1512,15 +1561,15 @@ msgid ""
 "just set both to the same value."
 msgstr "Sphinx has the notion of a \"version\" and a \"release\" for the\nsoftware. Each version can have multiple releases. For example, for\nPython the version is something like 2.5 or 3.0, while the release is\nsomething like 2.5.1 or 3.0a1. If you don't need this dual structure,\njust set both to the same value."
 
-#: sphinx/cmd/quickstart.py:268
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr "Project version"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr "Project release"
 
-#: sphinx/cmd/quickstart.py:274
+#: sphinx/cmd/quickstart.py:267
 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"
@@ -1530,21 +1579,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "If the documents are to be written in a language other than English,\nyou can select a language here by its language code. Sphinx will then\ntranslate text that it generates into that language.\n\nFor a list of supported codes, see\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:275
 msgid "Project language"
 msgstr "Project language"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:281
 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 "The file name suffix for source files. Commonly, this is either \".txt\"\nor \".rst\". Only files with this suffix are considered documents."
 
-#: sphinx/cmd/quickstart.py:290
+#: sphinx/cmd/quickstart.py:283
 msgid "Source file suffix"
 msgstr "Source file suffix"
 
-#: sphinx/cmd/quickstart.py:294
+#: sphinx/cmd/quickstart.py:287
 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"
@@ -1552,91 +1601,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr "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\nof the documents. Normally, this is \"index\", but if your \"index\"\ndocument is a custom template, you can also set this to another filename."
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:291
 msgid "Name of your master document (without suffix)"
 msgstr "Name of your master document (without suffix)"
 
-#: sphinx/cmd/quickstart.py:303
+#: sphinx/cmd/quickstart.py:296
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Error: the master file %s has already been found in the selected root path."
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:298
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart will not overwrite the existing file."
 
-#: sphinx/cmd/quickstart.py:307
+#: sphinx/cmd/quickstart.py:300
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Please enter a new file name, or rename the existing file and press Enter"
 
-#: sphinx/cmd/quickstart.py:311
+#: sphinx/cmd/quickstart.py:304
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Indicate which of the following Sphinx extensions should be enabled:"
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:312
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected."
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:318
 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 "A Makefile and a Windows command file can be generated for you so that you\nonly have to run e.g. `make html' instead of invoking sphinx-build\ndirectly."
 
-#: sphinx/cmd/quickstart.py:328
+#: sphinx/cmd/quickstart.py:321
 msgid "Create Makefile? (y/n)"
 msgstr "Create Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:331
+#: sphinx/cmd/quickstart.py:324
 msgid "Create Windows command file? (y/n)"
 msgstr "Create Windows command file? (y/n)"
 
-#: sphinx/cmd/quickstart.py:375 sphinx/ext/apidoc.py:93
+#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:93
 #, python-format
 msgid "Creating file %s."
 msgstr "Creating file %s."
 
-#: sphinx/cmd/quickstart.py:380 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "File %s already exists, skipping."
 
-#: sphinx/cmd/quickstart.py:422
+#: sphinx/cmd/quickstart.py:418
 msgid "Finished: An initial directory structure has been created."
 msgstr "Finished: An initial directory structure has been created."
 
-#: sphinx/cmd/quickstart.py:424
+#: sphinx/cmd/quickstart.py:420
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "You should now populate your master file %s and create other documentation\nsource files. "
 
-#: sphinx/cmd/quickstart.py:427
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Use the Makefile to build the docs, like so:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:430
+#: sphinx/cmd/quickstart.py:426
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Use the sphinx-build command to build the docs, like so:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:432
+#: sphinx/cmd/quickstart.py:428
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "where \"builder\" is one of the supported builders, e.g. html, latex or linkcheck."
 
-#: sphinx/cmd/quickstart.py:467
+#: sphinx/cmd/quickstart.py:464
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1646,135 +1695,135 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nGenerate required files for a Sphinx project.\n\nsphinx-quickstart is an interactive tool that asks some questions about your\nproject and then generates a complete documentation directory and sample\nMakefile to be used with sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:479
 msgid "quiet mode"
 msgstr "quiet mode"
 
-#: sphinx/cmd/quickstart.py:487
+#: sphinx/cmd/quickstart.py:484
 msgid "project root"
 msgstr "project root"
 
-#: sphinx/cmd/quickstart.py:489
+#: sphinx/cmd/quickstart.py:486
 msgid "Structure options"
 msgstr "Structure options"
 
-#: sphinx/cmd/quickstart.py:491
+#: sphinx/cmd/quickstart.py:488
 msgid "if specified, separate source and build dirs"
 msgstr "if specified, separate source and build dirs"
 
-#: sphinx/cmd/quickstart.py:493
+#: sphinx/cmd/quickstart.py:490
 msgid "if specified, create build dir under source dir"
 msgstr "if specified, create build dir under source dir"
 
-#: sphinx/cmd/quickstart.py:495
+#: sphinx/cmd/quickstart.py:492
 msgid "replacement for dot in _templates etc."
 msgstr "replacement for dot in _templates etc."
 
-#: sphinx/cmd/quickstart.py:497
+#: sphinx/cmd/quickstart.py:494
 msgid "Project basic options"
 msgstr "Project basic options"
 
-#: sphinx/cmd/quickstart.py:499
+#: sphinx/cmd/quickstart.py:496
 msgid "project name"
 msgstr "project name"
 
-#: sphinx/cmd/quickstart.py:501
+#: sphinx/cmd/quickstart.py:498
 msgid "author names"
 msgstr "author names"
 
-#: sphinx/cmd/quickstart.py:503
+#: sphinx/cmd/quickstart.py:500
 msgid "version of project"
 msgstr "version of project"
 
-#: sphinx/cmd/quickstart.py:505
+#: sphinx/cmd/quickstart.py:502
 msgid "release of project"
 msgstr "release of project"
 
-#: sphinx/cmd/quickstart.py:507
+#: sphinx/cmd/quickstart.py:504
 msgid "document language"
 msgstr "document language"
 
-#: sphinx/cmd/quickstart.py:509
+#: sphinx/cmd/quickstart.py:506
 msgid "source file suffix"
 msgstr "source file suffix"
 
-#: sphinx/cmd/quickstart.py:511
+#: sphinx/cmd/quickstart.py:508
 msgid "master document name"
 msgstr "master document name"
 
-#: sphinx/cmd/quickstart.py:513
+#: sphinx/cmd/quickstart.py:510
 msgid "use epub"
 msgstr "use epub"
 
-#: sphinx/cmd/quickstart.py:515
+#: sphinx/cmd/quickstart.py:512
 msgid "Extension options"
 msgstr "Extension options"
 
-#: sphinx/cmd/quickstart.py:519 sphinx/ext/apidoc.py:402
+#: sphinx/cmd/quickstart.py:516 sphinx/ext/apidoc.py:400
 #, python-format
 msgid "enable %s extension"
 msgstr "enable %s extension"
 
-#: sphinx/cmd/quickstart.py:521 sphinx/ext/apidoc.py:398
+#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:396
 msgid "enable arbitrary extensions"
 msgstr "enable arbitrary extensions"
 
-#: sphinx/cmd/quickstart.py:523
+#: sphinx/cmd/quickstart.py:520
 msgid "Makefile and Batchfile creation"
 msgstr "Makefile and Batchfile creation"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:522
 msgid "create makefile"
 msgstr "create makefile"
 
-#: sphinx/cmd/quickstart.py:527
+#: sphinx/cmd/quickstart.py:524
 msgid "do not create makefile"
 msgstr "do not create makefile"
 
-#: sphinx/cmd/quickstart.py:529
+#: sphinx/cmd/quickstart.py:526
 msgid "create batchfile"
 msgstr "create batchfile"
 
-#: sphinx/cmd/quickstart.py:532
+#: sphinx/cmd/quickstart.py:529
 msgid "do not create batchfile"
 msgstr "do not create batchfile"
 
-#: sphinx/cmd/quickstart.py:535
+#: sphinx/cmd/quickstart.py:532
 msgid "use make-mode for Makefile/make.bat"
 msgstr "use make-mode for Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:538
+#: sphinx/cmd/quickstart.py:535
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "do not use make-mode for Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:540 sphinx/ext/apidoc.py:404
+#: sphinx/cmd/quickstart.py:537 sphinx/ext/apidoc.py:402
 msgid "Project templating"
 msgstr "Project templating"
 
-#: sphinx/cmd/quickstart.py:543 sphinx/ext/apidoc.py:407
+#: sphinx/cmd/quickstart.py:540 sphinx/ext/apidoc.py:405
 msgid "template directory for template files"
 msgstr "template directory for template files"
 
-#: sphinx/cmd/quickstart.py:546
+#: sphinx/cmd/quickstart.py:543
 msgid "define a template variable"
 msgstr "define a template variable"
 
-#: sphinx/cmd/quickstart.py:579
+#: sphinx/cmd/quickstart.py:576
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 
-#: sphinx/cmd/quickstart.py:593
+#: sphinx/cmd/quickstart.py:590
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Error: specified path is not a directory, or sphinx files already exist."
 
-#: sphinx/cmd/quickstart.py:595
+#: sphinx/cmd/quickstart.py:592
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart only generate into a empty directory. Please specify a new root path."
 
-#: sphinx/cmd/quickstart.py:610
+#: sphinx/cmd/quickstart.py:607
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Invalid template variable: %s"
@@ -1825,47 +1874,47 @@ msgstr "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Line spec %r: no lines pulled from include file %r"
 
-#: sphinx/directives/other.py:116
+#: sphinx/directives/other.py:120
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr "toctree glob pattern %r didn't match any documents"
 
-#: sphinx/directives/other.py:142 sphinx/environment/adapters/toctree.py:323
+#: sphinx/directives/other.py:146 sphinx/environment/adapters/toctree.py:324
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree contains reference to excluded document %r"
 
-#: sphinx/directives/other.py:145 sphinx/environment/adapters/toctree.py:327
+#: sphinx/directives/other.py:149 sphinx/environment/adapters/toctree.py:328
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree contains reference to nonexisting document %r"
 
-#: sphinx/directives/other.py:156
+#: sphinx/directives/other.py:160
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr "duplicated entry found in toctree: %s"
 
-#: sphinx/directives/other.py:188
+#: sphinx/directives/other.py:193
 msgid "Section author: "
 msgstr "Section author: "
 
-#: sphinx/directives/other.py:190
+#: sphinx/directives/other.py:195
 msgid "Module author: "
 msgstr "Module author: "
 
-#: sphinx/directives/other.py:192
+#: sphinx/directives/other.py:197
 msgid "Code author: "
 msgstr "Code author: "
 
-#: sphinx/directives/other.py:194
+#: sphinx/directives/other.py:199
 msgid "Author: "
 msgstr "Author: "
 
-#: sphinx/directives/other.py:266
+#: sphinx/directives/other.py:275
 msgid ".. acks content is not a list"
 msgstr ".. acks content is not a list"
 
-#: sphinx/directives/other.py:291
+#: sphinx/directives/other.py:301
 msgid ".. hlist content is not a list"
 msgstr ".. hlist content is not a list"
 
@@ -1880,82 +1929,10 @@ msgstr "\":file:\" option for csv-table directive now recognises an absolute pat
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2043 sphinx/domains/c.py:3318
-#, python-format
-msgid ""
-"Duplicate C declaration, also defined at %s:%s.\n"
-"Declaration is '.. c:%s:: %s'."
-msgstr "Duplicate C declaration, also defined at %s:%s.\nDeclaration is '.. c:%s:: %s'."
-
-#: sphinx/domains/c.py:3257
-#, python-format
-msgid "%s (C %s)"
-msgstr "%s (C %s)"
-
-#: sphinx/domains/c.py:3356 sphinx/domains/cpp.py:7496
-#: sphinx/domains/python.py:682 sphinx/ext/napoleon/docstring.py:760
-msgid "Parameters"
-msgstr "Parameters"
-
-#: sphinx/domains/c.py:3359 sphinx/domains/cpp.py:7502
-msgid "Return values"
-msgstr "Return values"
-
-#: sphinx/domains/c.py:3362 sphinx/domains/cpp.py:7505
-#: sphinx/domains/javascript.py:259 sphinx/domains/python.py:694
-msgid "Returns"
-msgstr "Returns"
-
-#: sphinx/domains/c.py:3364 sphinx/domains/javascript.py:261
-#: sphinx/domains/python.py:696
-msgid "Return type"
-msgstr "Return type"
-
-#: sphinx/domains/c.py:3730 sphinx/domains/cpp.py:7909
-msgid "member"
-msgstr "member"
-
-#: sphinx/domains/c.py:3731
-msgid "variable"
-msgstr "variable"
-
-#: sphinx/domains/c.py:3732 sphinx/domains/cpp.py:7908
-#: sphinx/domains/javascript.py:365 sphinx/domains/python.py:1454
-msgid "function"
-msgstr "function"
-
-#: sphinx/domains/c.py:3733
-msgid "macro"
-msgstr "macro"
-
-#: sphinx/domains/c.py:3734
-msgid "struct"
-msgstr "struct"
-
-#: sphinx/domains/c.py:3735 sphinx/domains/cpp.py:7907
-msgid "union"
-msgstr "union"
-
-#: sphinx/domains/c.py:3736 sphinx/domains/cpp.py:7912
-msgid "enum"
-msgstr "enum"
-
-#: sphinx/domains/c.py:3737 sphinx/domains/cpp.py:7913
-msgid "enumerator"
-msgstr "enumerator"
-
-#: sphinx/domains/c.py:3738 sphinx/domains/cpp.py:7910
-msgid "type"
-msgstr "type"
-
-#: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7915
-msgid "function parameter"
-msgstr "function parameter"
-
 #: sphinx/domains/changeset.py:23
 #, python-format
-msgid "New in version %s"
-msgstr "New in version %s"
+msgid "Added in version %s"
+msgstr ""
 
 #: sphinx/domains/changeset.py:24
 #, python-format
@@ -1967,346 +1944,423 @@ msgstr "Changed in version %s"
 msgid "Deprecated since version %s"
 msgstr "Deprecated since version %s"
 
-#: sphinx/domains/citation.py:70
+#: sphinx/domains/changeset.py:26
+#, python-format
+msgid "Removed in version %s"
+msgstr ""
+
+#: sphinx/domains/citation.py:71
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "duplicate citation %s, other instance in %s"
 
-#: sphinx/domains/citation.py:81
+#: sphinx/domains/citation.py:82
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr "Citation [%s] is not referenced."
 
-#: sphinx/domains/cpp.py:4929 sphinx/domains/cpp.py:7423
-#, python-format
-msgid ""
-"Duplicate C++ declaration, also defined at %s:%s.\n"
-"Declaration is '.. cpp:%s:: %s'."
-msgstr "Duplicate C++ declaration, also defined at %s:%s.\nDeclaration is '.. cpp:%s:: %s'."
-
-#: sphinx/domains/cpp.py:7218
-msgid "Template Parameters"
-msgstr "Template Parameters"
-
-#: sphinx/domains/cpp.py:7340
-#, python-format
-msgid "%s (C++ %s)"
-msgstr "%s (C++ %s)"
-
-#: sphinx/domains/cpp.py:7499 sphinx/domains/javascript.py:256
-msgid "Throws"
-msgstr "Throws"
-
-#: sphinx/domains/cpp.py:7906 sphinx/domains/javascript.py:367
-#: sphinx/domains/python.py:1456
-msgid "class"
-msgstr "class"
-
-#: sphinx/domains/cpp.py:7911
-msgid "concept"
-msgstr "concept"
-
-#: sphinx/domains/cpp.py:7916
-msgid "template parameter"
-msgstr "template parameter"
-
-#: sphinx/domains/javascript.py:164
+#: sphinx/domains/javascript.py:165
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (built-in function)"
 
-#: sphinx/domains/javascript.py:165 sphinx/domains/python.py:1121
+#: sphinx/domains/javascript.py:166 sphinx/domains/python/__init__.py:240
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s method)"
 
-#: sphinx/domains/javascript.py:167
+#: sphinx/domains/javascript.py:168
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (class)"
 
-#: sphinx/domains/javascript.py:169
+#: sphinx/domains/javascript.py:170
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (global variable or constant)"
 
-#: sphinx/domains/javascript.py:171 sphinx/domains/python.py:1206
+#: sphinx/domains/javascript.py:172 sphinx/domains/python/__init__.py:325
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribute)"
 
-#: sphinx/domains/javascript.py:253
+#: sphinx/domains/javascript.py:255
 msgid "Arguments"
 msgstr "Arguments"
 
-#: sphinx/domains/javascript.py:329
+#: sphinx/domains/cpp/__init__.py:350 sphinx/domains/javascript.py:258
+msgid "Throws"
+msgstr "Throws"
+
+#: sphinx/domains/c/__init__.py:251 sphinx/domains/cpp/__init__.py:361
+#: sphinx/domains/javascript.py:261 sphinx/domains/python/_object.py:175
+msgid "Returns"
+msgstr "Returns"
+
+#: sphinx/domains/c/__init__.py:253 sphinx/domains/javascript.py:263
+#: sphinx/domains/python/_object.py:177
+msgid "Return type"
+msgstr "Return type"
+
+#: sphinx/domains/javascript.py:331
 #, python-format
 msgid "%s (module)"
 msgstr "%s (module)"
 
-#: sphinx/domains/javascript.py:366 sphinx/domains/python.py:1458
+#: sphinx/domains/c/__init__.py:622 sphinx/domains/cpp/__init__.py:764
+#: sphinx/domains/javascript.py:368 sphinx/domains/python/__init__.py:574
+msgid "function"
+msgstr "function"
+
+#: sphinx/domains/javascript.py:369 sphinx/domains/python/__init__.py:578
 msgid "method"
 msgstr "method"
 
-#: sphinx/domains/javascript.py:368 sphinx/domains/python.py:1455
+#: sphinx/domains/cpp/__init__.py:762 sphinx/domains/javascript.py:370
+#: sphinx/domains/python/__init__.py:576
+msgid "class"
+msgstr "class"
+
+#: sphinx/domains/javascript.py:371 sphinx/domains/python/__init__.py:575
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:369 sphinx/domains/python.py:1461
+#: sphinx/domains/javascript.py:372 sphinx/domains/python/__init__.py:581
 msgid "attribute"
 msgstr "attribute"
 
-#: sphinx/domains/javascript.py:370 sphinx/domains/python.py:1463
+#: sphinx/domains/javascript.py:373 sphinx/domains/python/__init__.py:583
 msgid "module"
 msgstr "module"
 
-#: sphinx/domains/javascript.py:401
+#: sphinx/domains/javascript.py:404
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "duplicate %s description of %s, other %s in %s"
 
-#: sphinx/domains/math.py:61
+#: sphinx/domains/math.py:63
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "duplicate label of equation %s, other instance in %s"
 
-#: sphinx/domains/math.py:116 sphinx/writers/latex.py:2252
+#: sphinx/domains/math.py:118 sphinx/writers/latex.py:2252
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Invalid math_eqref_format: %r"
 
-#: sphinx/domains/python.py:687
-msgid "Variables"
-msgstr "Variables"
+#: sphinx/domains/rst.py:127 sphinx/domains/rst.py:184
+#, python-format
+msgid "%s (directive)"
+msgstr "%s (directive)"
 
-#: sphinx/domains/python.py:691
-msgid "Raises"
-msgstr "Raises"
+#: sphinx/domains/rst.py:185 sphinx/domains/rst.py:189
+#, python-format
+msgid ":%s: (directive option)"
+msgstr ":%s: (directive option)"
 
-#: sphinx/domains/python.py:975 sphinx/domains/python.py:1112
+#: sphinx/domains/rst.py:213
+#, python-format
+msgid "%s (role)"
+msgstr "%s (role)"
+
+#: sphinx/domains/rst.py:223
+msgid "directive"
+msgstr "directive"
+
+#: sphinx/domains/rst.py:224
+msgid "directive-option"
+msgstr "directive-option"
+
+#: sphinx/domains/rst.py:225
+msgid "role"
+msgstr "role"
+
+#: sphinx/domains/rst.py:247
+#, python-format
+msgid "duplicate description of %s %s, other instance in %s"
+msgstr "duplicate description of %s %s, other instance in %s"
+
+#: sphinx/domains/c/__init__.py:146
+#, python-format
+msgid "%s (C %s)"
+msgstr "%s (C %s)"
+
+#: sphinx/domains/c/__init__.py:207 sphinx/domains/c/_symbol.py:552
+#, python-format
+msgid ""
+"Duplicate C declaration, also defined at %s:%s.\n"
+"Declaration is '.. c:%s:: %s'."
+msgstr "Duplicate C declaration, also defined at %s:%s.\nDeclaration is '.. c:%s:: %s'."
+
+#: sphinx/domains/c/__init__.py:245 sphinx/domains/cpp/__init__.py:344
+#: sphinx/domains/python/_object.py:163 sphinx/ext/napoleon/docstring.py:762
+msgid "Parameters"
+msgstr "Parameters"
+
+#: sphinx/domains/c/__init__.py:248 sphinx/domains/cpp/__init__.py:357
+msgid "Return values"
+msgstr "Return values"
+
+#: sphinx/domains/c/__init__.py:620 sphinx/domains/cpp/__init__.py:765
+msgid "member"
+msgstr "member"
+
+#: sphinx/domains/c/__init__.py:621
+msgid "variable"
+msgstr "variable"
+
+#: sphinx/domains/c/__init__.py:623
+msgid "macro"
+msgstr "macro"
+
+#: sphinx/domains/c/__init__.py:624
+msgid "struct"
+msgstr "struct"
+
+#: sphinx/domains/c/__init__.py:625 sphinx/domains/cpp/__init__.py:763
+msgid "union"
+msgstr "union"
+
+#: sphinx/domains/c/__init__.py:626 sphinx/domains/cpp/__init__.py:768
+msgid "enum"
+msgstr "enum"
+
+#: sphinx/domains/c/__init__.py:627 sphinx/domains/cpp/__init__.py:769
+msgid "enumerator"
+msgstr "enumerator"
+
+#: sphinx/domains/c/__init__.py:628 sphinx/domains/cpp/__init__.py:766
+msgid "type"
+msgstr "type"
+
+#: sphinx/domains/c/__init__.py:630 sphinx/domains/cpp/__init__.py:771
+msgid "function parameter"
+msgstr "function parameter"
+
+#: sphinx/domains/cpp/__init__.py:63
+msgid "Template Parameters"
+msgstr "Template Parameters"
+
+#: sphinx/domains/cpp/__init__.py:185
+#, python-format
+msgid "%s (C++ %s)"
+msgstr "%s (C++ %s)"
+
+#: sphinx/domains/cpp/__init__.py:268 sphinx/domains/cpp/_symbol.py:790
+#, python-format
+msgid ""
+"Duplicate C++ declaration, also defined at %s:%s.\n"
+"Declaration is '.. cpp:%s:: %s'."
+msgstr "Duplicate C++ declaration, also defined at %s:%s.\nDeclaration is '.. cpp:%s:: %s'."
+
+#: sphinx/domains/cpp/__init__.py:767
+msgid "concept"
+msgstr "concept"
+
+#: sphinx/domains/cpp/__init__.py:772
+msgid "template parameter"
+msgstr "template parameter"
+
+#: sphinx/domains/python/__init__.py:94 sphinx/domains/python/__init__.py:231
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (in module %s)"
 
-#: sphinx/domains/python.py:1035 sphinx/domains/python.py:1202
-#: sphinx/domains/python.py:1253
+#: sphinx/domains/python/__init__.py:154 sphinx/domains/python/__init__.py:321
+#: sphinx/domains/python/__init__.py:372
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (in module %s)"
 
-#: sphinx/domains/python.py:1037
+#: sphinx/domains/python/__init__.py:156
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (built-in variable)"
 
-#: sphinx/domains/python.py:1062
+#: sphinx/domains/python/__init__.py:181
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (built-in class)"
 
-#: sphinx/domains/python.py:1063
+#: sphinx/domains/python/__init__.py:182
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (class in %s)"
 
-#: sphinx/domains/python.py:1117
+#: sphinx/domains/python/__init__.py:236
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s class method)"
 
-#: sphinx/domains/python.py:1119
+#: sphinx/domains/python/__init__.py:238
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s static method)"
 
-#: sphinx/domains/python.py:1257
+#: sphinx/domains/python/__init__.py:376
 #, python-format
 msgid "%s (%s property)"
 msgstr "%s (%s property)"
 
-#: sphinx/domains/python.py:1383
+#: sphinx/domains/python/__init__.py:502
 msgid "Python Module Index"
 msgstr "Python Module Index"
 
-#: sphinx/domains/python.py:1384
+#: sphinx/domains/python/__init__.py:503
 msgid "modules"
 msgstr "modules"
 
-#: sphinx/domains/python.py:1433
+#: sphinx/domains/python/__init__.py:552
 msgid "Deprecated"
 msgstr "Deprecated"
 
-#: sphinx/domains/python.py:1457
+#: sphinx/domains/python/__init__.py:577
 msgid "exception"
 msgstr "exception"
 
-#: sphinx/domains/python.py:1459
+#: sphinx/domains/python/__init__.py:579
 msgid "class method"
 msgstr "class method"
 
-#: sphinx/domains/python.py:1460
+#: sphinx/domains/python/__init__.py:580
 msgid "static method"
 msgstr "static method"
 
-#: sphinx/domains/python.py:1462
+#: sphinx/domains/python/__init__.py:582
 msgid "property"
 msgstr "property"
 
-#: sphinx/domains/python.py:1520
+#: sphinx/domains/python/__init__.py:640
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :no-index: for"
 " one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1640
+#: sphinx/domains/python/__init__.py:760
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "more than one target found for cross-reference %r: %s"
 
-#: sphinx/domains/python.py:1701
+#: sphinx/domains/python/__init__.py:821
 msgid " (deprecated)"
 msgstr " (deprecated)"
 
-#: sphinx/domains/rst.py:125 sphinx/domains/rst.py:181
-#, python-format
-msgid "%s (directive)"
-msgstr "%s (directive)"
-
-#: sphinx/domains/rst.py:182 sphinx/domains/rst.py:186
-#, python-format
-msgid ":%s: (directive option)"
-msgstr ":%s: (directive option)"
-
-#: sphinx/domains/rst.py:209
-#, python-format
-msgid "%s (role)"
-msgstr "%s (role)"
-
-#: sphinx/domains/rst.py:218
-msgid "directive"
-msgstr "directive"
-
-#: sphinx/domains/rst.py:219
-msgid "directive-option"
-msgstr "directive-option"
-
-#: sphinx/domains/rst.py:220
-msgid "role"
-msgstr "role"
+#: sphinx/domains/python/_object.py:168
+msgid "Variables"
+msgstr "Variables"
 
-#: sphinx/domains/rst.py:242
-#, python-format
-msgid "duplicate description of %s %s, other instance in %s"
-msgstr "duplicate description of %s %s, other instance in %s"
+#: sphinx/domains/python/_object.py:172
+msgid "Raises"
+msgstr "Raises"
 
-#: sphinx/domains/std.py:79 sphinx/domains/std.py:96
+#: sphinx/domains/std/__init__.py:80 sphinx/domains/std/__init__.py:97
 #, python-format
 msgid "environment variable; %s"
 msgstr "environment variable; %s"
 
-#: sphinx/domains/std.py:155
+#: sphinx/domains/std/__init__.py:157
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Malformed option description %r, should look like \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" or \"+opt args\""
 
-#: sphinx/domains/std.py:226
+#: sphinx/domains/std/__init__.py:228
 #, python-format
 msgid "%s command line option"
 msgstr "%s command line option"
 
-#: sphinx/domains/std.py:228
+#: sphinx/domains/std/__init__.py:230
 msgid "command line option"
 msgstr "command line option"
 
-#: sphinx/domains/std.py:346
+#: sphinx/domains/std/__init__.py:348
 msgid "glossary term must be preceded by empty line"
 msgstr "glossary term must be preceded by empty line"
 
-#: sphinx/domains/std.py:354
+#: sphinx/domains/std/__init__.py:356
 msgid "glossary terms must not be separated by empty lines"
 msgstr "glossary terms must not be separated by empty lines"
 
-#: sphinx/domains/std.py:360 sphinx/domains/std.py:373
+#: sphinx/domains/std/__init__.py:362 sphinx/domains/std/__init__.py:375
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "glossary seems to be misformatted, check indentation"
 
-#: sphinx/domains/std.py:516
+#: sphinx/domains/std/__init__.py:518
 msgid "glossary term"
 msgstr "glossary term"
 
-#: sphinx/domains/std.py:517
+#: sphinx/domains/std/__init__.py:519
 msgid "grammar token"
 msgstr "grammar token"
 
-#: sphinx/domains/std.py:518
+#: sphinx/domains/std/__init__.py:520
 msgid "reference label"
 msgstr "reference label"
 
-#: sphinx/domains/std.py:520
+#: sphinx/domains/std/__init__.py:522
 msgid "environment variable"
 msgstr "environment variable"
 
-#: sphinx/domains/std.py:521
+#: sphinx/domains/std/__init__.py:523
 msgid "program option"
 msgstr "programme option"
 
-#: sphinx/domains/std.py:522
+#: sphinx/domains/std/__init__.py:524
 msgid "document"
 msgstr "document"
 
-#: sphinx/domains/std.py:558 sphinx/domains/std.py:570
+#: sphinx/domains/std/__init__.py:560 sphinx/domains/std/__init__.py:572
 msgid "Module Index"
 msgstr "Module Index"
 
-#: sphinx/domains/std.py:559 sphinx/domains/std.py:571
+#: sphinx/domains/std/__init__.py:561 sphinx/domains/std/__init__.py:573
 #: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Search Page"
 
-#: sphinx/domains/std.py:614 sphinx/domains/std.py:720
-#: sphinx/ext/autosectionlabel.py:52
+#: sphinx/domains/std/__init__.py:616 sphinx/domains/std/__init__.py:722
+#: sphinx/ext/autosectionlabel.py:53
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "duplicate label %s, other instance in %s"
 
-#: sphinx/domains/std.py:633
+#: sphinx/domains/std/__init__.py:635
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "duplicate %s description of %s, other instance in %s"
 
-#: sphinx/domains/std.py:839
+#: sphinx/domains/std/__init__.py:841
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig is disabled. :numref: is ignored."
 
-#: sphinx/domains/std.py:847
+#: sphinx/domains/std/__init__.py:849
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr "Failed to create a cross reference. Any number is not assigned: %s"
 
-#: sphinx/domains/std.py:859
+#: sphinx/domains/std/__init__.py:861
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "the link has no caption: %s"
 
-#: sphinx/domains/std.py:873
+#: sphinx/domains/std/__init__.py:875
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "invalid numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:876
+#: sphinx/domains/std/__init__.py:878
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "invalid numfig_format: %s"
 
-#: sphinx/domains/std.py:1106
+#: sphinx/domains/std/__init__.py:1109
 #, python-format
 msgid "undefined label: %r"
 msgstr "undefined label: %r"
 
-#: sphinx/domains/std.py:1108
+#: sphinx/domains/std/__init__.py:1111
 #, python-format
 msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr "Failed to create a cross reference. A title or caption not found: %r"
@@ -2323,35 +2377,35 @@ msgstr "config changed"
 msgid "extensions changed"
 msgstr "extensions changed"
 
-#: sphinx/environment/__init__.py:276
+#: sphinx/environment/__init__.py:279
 msgid "build environment version not current"
 msgstr "build environment version not current"
 
-#: sphinx/environment/__init__.py:278
+#: sphinx/environment/__init__.py:281
 msgid "source directory has changed"
 msgstr "source directory has changed"
 
-#: sphinx/environment/__init__.py:357
+#: sphinx/environment/__init__.py:360
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "This environment is incompatible with the selected builder, please choose another doctree directory."
 
-#: sphinx/environment/__init__.py:456
+#: sphinx/environment/__init__.py:459
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Failed to scan documents in %s: %r"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:596
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Domain %r is not registered"
 
-#: sphinx/environment/__init__.py:727
+#: sphinx/environment/__init__.py:730
 msgid "document isn't included in any toctree"
 msgstr "document isn't included in any toctree"
 
-#: sphinx/environment/__init__.py:764
+#: sphinx/environment/__init__.py:766
 msgid "self referenced toctree found. Ignored."
 msgstr "self referenced toctree found. Ignored."
 
@@ -2375,39 +2429,39 @@ msgstr "unknown index entry type %r"
 msgid "Symbols"
 msgstr "Symbols"
 
-#: sphinx/environment/adapters/toctree.py:296
+#: sphinx/environment/adapters/toctree.py:297
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "circular toctree references detected, ignoring: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:316
+#: sphinx/environment/adapters/toctree.py:317
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree contains reference to document %r that doesn't have a title: no link will be generated"
 
-#: sphinx/environment/adapters/toctree.py:325
+#: sphinx/environment/adapters/toctree.py:326
 #, python-format
 msgid "toctree contains reference to non-included document %r"
 msgstr "toctree contains reference to non-included document %r"
 
-#: sphinx/environment/collectors/asset.py:88
+#: sphinx/environment/collectors/asset.py:89
 #, python-format
 msgid "image file not readable: %s"
 msgstr "image file not readable: %s"
 
-#: sphinx/environment/collectors/asset.py:107
+#: sphinx/environment/collectors/asset.py:108
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "image file %s not readable: %s"
 
-#: sphinx/environment/collectors/asset.py:133
+#: sphinx/environment/collectors/asset.py:134
 #, python-format
 msgid "download file not readable: %s"
 msgstr "download file not readable: %s"
 
-#: sphinx/environment/collectors/toctree.py:224
+#: sphinx/environment/collectors/toctree.py:225
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s is already assigned section numbers (nested numbered toctree?)"
@@ -2417,7 +2471,7 @@ msgstr "%s is already assigned section numbers (nested numbered toctree?)"
 msgid "Would create file %s."
 msgstr "Would create file %s."
 
-#: sphinx/ext/apidoc.py:320
+#: sphinx/ext/apidoc.py:318
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2429,149 +2483,149 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr "\nLook recursively in <MODULE_PATH> for Python modules and packages and create\none reST file with automodule directives per package in the <OUTPUT_PATH>.\n\nThe <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\nexcluded from generation.\n\nNote: By default this script will not overwrite already created files."
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:331
 msgid "path to module to document"
 msgstr "path to module to document"
 
-#: sphinx/ext/apidoc.py:335
+#: sphinx/ext/apidoc.py:333
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "fnmatch-style file and/or directory patterns to exclude from generation"
 
-#: sphinx/ext/apidoc.py:340
+#: sphinx/ext/apidoc.py:338
 msgid "directory to place all output"
 msgstr "directory to place all output"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:343
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "maximum depth of submodules to show in the TOC (default: 4)"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:346
 msgid "overwrite existing files"
 msgstr "overwrite existing files"
 
-#: sphinx/ext/apidoc.py:351
+#: sphinx/ext/apidoc.py:349
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "follow symbolic links. Powerful when combined with collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:354
+#: sphinx/ext/apidoc.py:352
 msgid "run the script without creating files"
 msgstr "run the script without creating files"
 
-#: sphinx/ext/apidoc.py:357
+#: sphinx/ext/apidoc.py:355
 msgid "put documentation for each module on its own page"
 msgstr "put documentation for each module on its own page"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:358
 msgid "include \"_private\" modules"
 msgstr "include \"_private\" modules"
 
-#: sphinx/ext/apidoc.py:362
+#: sphinx/ext/apidoc.py:360
 msgid "filename of table of contents (default: modules)"
 msgstr "filename of table of contents (default: modules)"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:362
 msgid "don't create a table of contents file"
 msgstr "don't create a table of contents file"
 
-#: sphinx/ext/apidoc.py:367
+#: sphinx/ext/apidoc.py:365
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "don't create headings for the module/package packages (e.g. when the docstrings already contain them)"
 
-#: sphinx/ext/apidoc.py:372
+#: sphinx/ext/apidoc.py:370
 msgid "put module documentation before submodule documentation"
 msgstr "put module documentation before submodule documentation"
 
-#: sphinx/ext/apidoc.py:376
+#: sphinx/ext/apidoc.py:374
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interpret module paths according to PEP-0420 implicit namespaces specification"
 
-#: sphinx/ext/apidoc.py:380
+#: sphinx/ext/apidoc.py:378
 msgid "file suffix (default: rst)"
 msgstr "file suffix (default: rst)"
 
-#: sphinx/ext/apidoc.py:382
+#: sphinx/ext/apidoc.py:380
 msgid "generate a full project with sphinx-quickstart"
 msgstr "generate a full project with sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:385
+#: sphinx/ext/apidoc.py:383
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "append module_path to sys.path, used when --full is given"
 
-#: sphinx/ext/apidoc.py:387
+#: sphinx/ext/apidoc.py:385
 msgid "project name (default: root module name)"
 msgstr "project name (default: root module name)"
 
-#: sphinx/ext/apidoc.py:389
+#: sphinx/ext/apidoc.py:387
 msgid "project author(s), used when --full is given"
 msgstr "project author(s), used when --full is given"
 
-#: sphinx/ext/apidoc.py:391
+#: sphinx/ext/apidoc.py:389
 msgid "project version, used when --full is given"
 msgstr "project version, used when --full is given"
 
-#: sphinx/ext/apidoc.py:393
+#: sphinx/ext/apidoc.py:391
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "project release, used when --full is given, defaults to --doc-version"
 
-#: sphinx/ext/apidoc.py:396
+#: sphinx/ext/apidoc.py:394
 msgid "extension options"
 msgstr "extension options"
 
-#: sphinx/ext/apidoc.py:429
+#: sphinx/ext/apidoc.py:427
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s is not a directory."
 
-#: sphinx/ext/autosectionlabel.py:48
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "section \"%s\" gets labeled as \"%s\""
 msgstr "section \"%s\" gets labeled as \"%s\""
 
-#: sphinx/ext/coverage.py:45
+#: sphinx/ext/coverage.py:46
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "invalid regex %r in %s"
 
-#: sphinx/ext/coverage.py:73
+#: sphinx/ext/coverage.py:75
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:87
+#: sphinx/ext/coverage.py:89
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "invalid regex %r in coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:155
+#: sphinx/ext/coverage.py:157
 #, python-format
 msgid "undocumented c api: %s [%s] in file %s"
 msgstr "undocumented c api: %s [%s] in file %s"
 
-#: sphinx/ext/coverage.py:187
+#: sphinx/ext/coverage.py:189
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "module %s could not be imported: %s"
 
-#: sphinx/ext/coverage.py:334
+#: sphinx/ext/coverage.py:340
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr "undocumented python function: %s :: %s"
 
-#: sphinx/ext/coverage.py:350
+#: sphinx/ext/coverage.py:356
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr "undocumented python class: %s :: %s"
 
-#: sphinx/ext/coverage.py:363
+#: sphinx/ext/coverage.py:369
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr "undocumented python method: %s :: %s :: %s"
@@ -2595,24 +2649,24 @@ msgstr "'%s' is not a valid pyversion option"
 msgid "invalid TestCode type"
 msgstr "invalid TestCode type"
 
-#: sphinx/ext/doctest.py:280
+#: sphinx/ext/doctest.py:281
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:431
+#: sphinx/ext/doctest.py:438
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "no code/output in %s block at %s:%s"
 
-#: sphinx/ext/doctest.py:521
+#: sphinx/ext/doctest.py:526
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "ignoring invalid doctest code: %r"
 
-#: sphinx/ext/duration.py:76
+#: sphinx/ext/duration.py:77
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "====================== slowest reading durations ======================="
@@ -2623,32 +2677,32 @@ msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 
-#: sphinx/ext/graphviz.py:133
+#: sphinx/ext/graphviz.py:135
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Graphviz directive cannot have both content and a filename argument"
 
-#: sphinx/ext/graphviz.py:143
+#: sphinx/ext/graphviz.py:145
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "External Graphviz file %r not found or reading it failed"
 
-#: sphinx/ext/graphviz.py:150
+#: sphinx/ext/graphviz.py:152
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignoring \"graphviz\" directive without content."
 
-#: sphinx/ext/graphviz.py:259
+#: sphinx/ext/graphviz.py:268
 #, python-format
 msgid "graphviz_dot executable path must be set! %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:294
+#: sphinx/ext/graphviz.py:303
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting"
 
-#: sphinx/ext/graphviz.py:301
+#: sphinx/ext/graphviz.py:310
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2658,7 +2712,7 @@ msgid ""
 "%r"
 msgstr "dot exited with error:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:304
+#: sphinx/ext/graphviz.py:313
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2668,27 +2722,27 @@ msgid ""
 "%r"
 msgstr "dot did not produce an output file:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/graphviz.py:320
+#: sphinx/ext/graphviz.py:329
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format must be one of 'png', 'svg', but is %r"
 
-#: sphinx/ext/graphviz.py:324 sphinx/ext/graphviz.py:377
-#: sphinx/ext/graphviz.py:414
+#: sphinx/ext/graphviz.py:333 sphinx/ext/graphviz.py:386
+#: sphinx/ext/graphviz.py:423
 #, python-format
 msgid "dot code %r: %s"
 msgstr "dot code %r: %s"
 
-#: sphinx/ext/graphviz.py:427 sphinx/ext/graphviz.py:435
+#: sphinx/ext/graphviz.py:436 sphinx/ext/graphviz.py:444
 #, python-format
 msgid "[graph: %s]"
 msgstr "[graph: %s]"
 
-#: sphinx/ext/graphviz.py:429 sphinx/ext/graphviz.py:437
+#: sphinx/ext/graphviz.py:438 sphinx/ext/graphviz.py:446
 msgid "[graph]"
 msgstr "[graph]"
 
-#: sphinx/ext/imgconverter.py:38
+#: sphinx/ext/imgconverter.py:39
 #, python-format
 msgid ""
 "Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n"
@@ -2696,7 +2750,7 @@ msgid ""
 "Traceback: %s"
 msgstr "Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n\nTraceback: %s"
 
-#: sphinx/ext/imgconverter.py:47 sphinx/ext/imgconverter.py:71
+#: sphinx/ext/imgconverter.py:48 sphinx/ext/imgconverter.py:72
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2706,173 +2760,178 @@ msgid ""
 "%r"
 msgstr "convert exited with error:\n[stderr]\n%r\n[stdout]\n%r"
 
-#: sphinx/ext/imgconverter.py:66
+#: sphinx/ext/imgconverter.py:67
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "convert command %r cannot be run, check the image_converter setting"
 
-#: sphinx/ext/imgmath.py:157
+#: sphinx/ext/imgmath.py:158
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "LaTeX command %r cannot be run (needed for maths display), check the imgmath_latex setting"
 
-#: sphinx/ext/imgmath.py:172
+#: sphinx/ext/imgmath.py:173
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s command %r cannot be run (needed for maths display), check the imgmath_%s setting"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:327
 #, python-format
 msgid "display latex %r: %s"
 msgstr "display latex %r: %s"
 
-#: sphinx/ext/imgmath.py:360
+#: sphinx/ext/imgmath.py:361
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "inline latex %r: %s"
 
-#: sphinx/ext/imgmath.py:367 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:368 sphinx/ext/mathjax.py:53
 msgid "Link to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:194
+#: sphinx/ext/intersphinx.py:195
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "intersphinx inventory has moved: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:229
+#: sphinx/ext/intersphinx.py:230
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "loading intersphinx inventory from %s..."
 
-#: sphinx/ext/intersphinx.py:243
+#: sphinx/ext/intersphinx.py:244
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "encountered some issues with some of the inventories, but they had working alternatives:"
 
-#: sphinx/ext/intersphinx.py:249
+#: sphinx/ext/intersphinx.py:250
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "failed to reach any of the inventories with the following issues:"
 
-#: sphinx/ext/intersphinx.py:302
+#: sphinx/ext/intersphinx.py:303
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(in %s v%s)"
 
-#: sphinx/ext/intersphinx.py:304
+#: sphinx/ext/intersphinx.py:305
 #, python-format
 msgid "(in %s)"
 msgstr "(in %s)"
 
-#: sphinx/ext/intersphinx.py:536
+#: sphinx/ext/intersphinx.py:538
 #, python-format
-msgid "inventory for external cross-reference not found: %s"
-msgstr "inventory for external cross-reference not found: %s"
+msgid "inventory for external cross-reference not found: %r"
+msgstr ""
 
-#: sphinx/ext/intersphinx.py:542
+#: sphinx/ext/intersphinx.py:546
 #, python-format
-msgid "role for external cross-reference not found: %s"
-msgstr "role for external cross-reference not found: %s"
+msgid "invalid external cross-reference suffix: %r"
+msgstr ""
 
-#: sphinx/ext/intersphinx.py:633
+#: sphinx/ext/intersphinx.py:557
+#, python-format
+msgid "domain for external cross-reference not found: %r"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:750
 #, python-format
 msgid "external %s:%s reference target not found: %s"
 msgstr "external %s:%s reference target not found: %s"
 
-#: sphinx/ext/intersphinx.py:658
+#: sphinx/ext/intersphinx.py:775
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "intersphinx identifier %r is not string. Ignored"
 
-#: sphinx/ext/intersphinx.py:680
+#: sphinx/ext/intersphinx.py:797
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr "Failed to read intersphinx_mapping[%s], ignored: %r"
 
-#: sphinx/ext/linkcode.py:68 sphinx/ext/viewcode.py:198
+#: sphinx/ext/linkcode.py:69 sphinx/ext/viewcode.py:199
 msgid "[source]"
 msgstr "[source]"
 
-#: sphinx/ext/todo.py:67
+#: sphinx/ext/todo.py:69
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:100
+#: sphinx/ext/todo.py:102
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "TODO entry found: %s"
 
-#: sphinx/ext/todo.py:158
+#: sphinx/ext/todo.py:161
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:160
+#: sphinx/ext/todo.py:163
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(The <<original entry>> is located in %s, line %d.)"
 
-#: sphinx/ext/todo.py:170
+#: sphinx/ext/todo.py:173
 msgid "original entry"
 msgstr "original entry"
 
-#: sphinx/ext/viewcode.py:255
+#: sphinx/ext/viewcode.py:256
 msgid "highlighting module code... "
 msgstr "highlighting module code... "
 
-#: sphinx/ext/viewcode.py:283
+#: sphinx/ext/viewcode.py:284
 msgid "[docs]"
 msgstr "[docs]"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:304
 msgid "Module code"
 msgstr "Module code"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:310
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Source code for %s</h1>"
 
-#: sphinx/ext/viewcode.py:335
+#: sphinx/ext/viewcode.py:336
 msgid "Overview: module code"
 msgstr "Overview: module code"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:337
 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:127
+#: sphinx/ext/autodoc/__init__.py:135
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr "invalid value for member-order option: %s"
 
-#: sphinx/ext/autodoc/__init__.py:135
+#: sphinx/ext/autodoc/__init__.py:143
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr "invalid value for class-doc-from option: %s"
 
-#: sphinx/ext/autodoc/__init__.py:391
+#: sphinx/ext/autodoc/__init__.py:399
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "invalid signature for auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:508
+#: sphinx/ext/autodoc/__init__.py:515
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "error while formatting arguments for %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:777
+#: sphinx/ext/autodoc/__init__.py:798
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:872
+#: sphinx/ext/autodoc/__init__.py:893
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2880,112 +2939,112 @@ msgid ""
 "explicit module name)"
 msgstr "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)"
 
-#: sphinx/ext/autodoc/__init__.py:916
+#: sphinx/ext/autodoc/__init__.py:937
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr "A mocked object is detected: %r"
 
-#: sphinx/ext/autodoc/__init__.py:935
+#: sphinx/ext/autodoc/__init__.py:956
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr "error while formatting signature for %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:996
+#: sphinx/ext/autodoc/__init__.py:1019
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" in automodule name doesn't make sense"
 
-#: sphinx/ext/autodoc/__init__.py:1003
+#: sphinx/ext/autodoc/__init__.py:1026
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "signature arguments or return annotation given for automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:1016
+#: sphinx/ext/autodoc/__init__.py:1039
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__"
 
-#: sphinx/ext/autodoc/__init__.py:1082
+#: sphinx/ext/autodoc/__init__.py:1105
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr "missing attribute mentioned in :members: option: module %s, attribute %s"
 
-#: sphinx/ext/autodoc/__init__.py:1298 sphinx/ext/autodoc/__init__.py:1375
-#: sphinx/ext/autodoc/__init__.py:2768
+#: sphinx/ext/autodoc/__init__.py:1327 sphinx/ext/autodoc/__init__.py:1404
+#: sphinx/ext/autodoc/__init__.py:2824
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr "Failed to get a function signature for %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1586
+#: sphinx/ext/autodoc/__init__.py:1618
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr "Failed to get a constructor signature for %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1713
+#: sphinx/ext/autodoc/__init__.py:1745
 #, python-format
 msgid "Bases: %s"
 msgstr "Bases: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1727
+#: sphinx/ext/autodoc/__init__.py:1759
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "missing attribute %s in object %s"
 
-#: sphinx/ext/autodoc/__init__.py:1826 sphinx/ext/autodoc/__init__.py:1863
-#: sphinx/ext/autodoc/__init__.py:1946
+#: sphinx/ext/autodoc/__init__.py:1858 sphinx/ext/autodoc/__init__.py:1895
+#: sphinx/ext/autodoc/__init__.py:1990
 #, python-format
 msgid "alias of %s"
 msgstr "alias of %s"
 
-#: sphinx/ext/autodoc/__init__.py:1846
+#: sphinx/ext/autodoc/__init__.py:1878
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr "alias of TypeVar(%s)"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2216 sphinx/ext/autodoc/__init__.py:2316
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr "Failed to get a method signature for %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2447
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr "Invalid __slots__ found on %s. Ignored."
 
-#: sphinx/ext/autodoc/preserve_defaults.py:183
+#: sphinx/ext/autodoc/preserve_defaults.py:190
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr "Failed to parse a default argument value for %r: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:131
+#: sphinx/ext/autodoc/type_comment.py:132
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr "Failed to update signature for %r: parameter not found: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:134
+#: sphinx/ext/autodoc/type_comment.py:135
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "Failed to parse type_comment for %r: %s"
 
-#: sphinx/ext/autosummary/__init__.py:249
+#: sphinx/ext/autosummary/__init__.py:251
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "autosummary references excluded document %r. Ignored."
 
-#: sphinx/ext/autosummary/__init__.py:251
+#: sphinx/ext/autosummary/__init__.py:253
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary: stub file not found %r. Check your autosummary_generate setting."
 
-#: sphinx/ext/autosummary/__init__.py:270
+#: sphinx/ext/autosummary/__init__.py:272
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr "A captioned autosummary requires :toctree: option. ignored."
 
-#: sphinx/ext/autosummary/__init__.py:323
+#: sphinx/ext/autosummary/__init__.py:325
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2993,26 +3052,26 @@ msgid ""
 "%s"
 msgstr "autosummary: failed to import %s.\nPossible hints:\n%s"
 
-#: sphinx/ext/autosummary/__init__.py:337
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to parse name %s"
 msgstr "failed to parse name %s"
 
-#: sphinx/ext/autosummary/__init__.py:342
+#: sphinx/ext/autosummary/__init__.py:344
 #, python-format
 msgid "failed to import object %s"
 msgstr "failed to import object %s"
 
-#: sphinx/ext/autosummary/__init__.py:798
+#: sphinx/ext/autosummary/__init__.py:802
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: file not found: %s"
 
-#: sphinx/ext/autosummary/__init__.py:806
+#: sphinx/ext/autosummary/__init__.py:810
 msgid ""
-"autosummary generats .rst files internally. But your source_suffix does not "
-"contain .rst. Skipped."
-msgstr "autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped."
+"autosummary generates .rst files internally. But your source_suffix does not"
+" contain .rst. Skipped."
+msgstr ""
 
 #: sphinx/ext/autosummary/generate.py:200
 #: sphinx/ext/autosummary/generate.py:358
@@ -3085,99 +3144,99 @@ msgid ""
 "%(default)s)"
 msgstr "document exactly the members in module __all__ attribute. (default: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:726
+#: sphinx/ext/napoleon/__init__.py:341 sphinx/ext/napoleon/docstring.py:728
 msgid "Keyword Arguments"
 msgstr "Keyword Arguments"
 
-#: sphinx/ext/napoleon/docstring.py:680
+#: sphinx/ext/napoleon/docstring.py:682
 msgid "Example"
 msgstr "Example"
 
-#: sphinx/ext/napoleon/docstring.py:681
+#: sphinx/ext/napoleon/docstring.py:683
 msgid "Examples"
 msgstr "Examples"
 
-#: sphinx/ext/napoleon/docstring.py:742
+#: sphinx/ext/napoleon/docstring.py:744
 msgid "Notes"
 msgstr "Notes"
 
-#: sphinx/ext/napoleon/docstring.py:751
+#: sphinx/ext/napoleon/docstring.py:753
 msgid "Other Parameters"
 msgstr "Other Parameters"
 
-#: sphinx/ext/napoleon/docstring.py:787
+#: sphinx/ext/napoleon/docstring.py:789
 msgid "Receives"
 msgstr "Receives"
 
-#: sphinx/ext/napoleon/docstring.py:791
+#: sphinx/ext/napoleon/docstring.py:793
 msgid "References"
 msgstr "References"
 
-#: sphinx/ext/napoleon/docstring.py:823
+#: sphinx/ext/napoleon/docstring.py:825
 msgid "Warns"
 msgstr "Warns"
 
-#: sphinx/ext/napoleon/docstring.py:827
+#: sphinx/ext/napoleon/docstring.py:829
 msgid "Yields"
 msgstr "Yields"
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr "invalid value set (missing closing brace): %s"
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr "invalid value set (missing opening brace): %s"
 
-#: sphinx/ext/napoleon/docstring.py:999
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr "malformed string literal (missing closing quote): %s"
 
-#: sphinx/ext/napoleon/docstring.py:1006
+#: sphinx/ext/napoleon/docstring.py:1008
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr "malformed string literal (missing opening quote): %s"
 
-#: sphinx/locale/__init__.py:221
+#: sphinx/locale/__init__.py:228
 msgid "Attention"
 msgstr "Attention"
 
-#: sphinx/locale/__init__.py:222
+#: sphinx/locale/__init__.py:229
 msgid "Caution"
 msgstr "Caution"
 
-#: sphinx/locale/__init__.py:223
+#: sphinx/locale/__init__.py:230
 msgid "Danger"
 msgstr "Danger"
 
-#: sphinx/locale/__init__.py:224
+#: sphinx/locale/__init__.py:231
 msgid "Error"
 msgstr "Error"
 
-#: sphinx/locale/__init__.py:225
+#: sphinx/locale/__init__.py:232
 msgid "Hint"
 msgstr "Hint"
 
-#: sphinx/locale/__init__.py:226
+#: sphinx/locale/__init__.py:233
 msgid "Important"
 msgstr "Important"
 
-#: sphinx/locale/__init__.py:227
+#: sphinx/locale/__init__.py:234
 msgid "Note"
 msgstr "Note"
 
-#: sphinx/locale/__init__.py:228
+#: sphinx/locale/__init__.py:235
 msgid "See also"
 msgstr "See also"
 
-#: sphinx/locale/__init__.py:229
+#: sphinx/locale/__init__.py:236
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:230
+#: sphinx/locale/__init__.py:237
 msgid "Warning"
 msgstr "Warning"
 
@@ -3209,7 +3268,7 @@ msgid "Table of Contents"
 msgstr "Table of Contents"
 
 #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:141
-#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
+#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:23
 msgid "Search"
 msgstr "Search"
 
@@ -3342,34 +3401,22 @@ msgstr "Next topic"
 msgid "next chapter"
 msgstr "next chapter"
 
-#: sphinx/themes/basic/search.html:27
+#: sphinx/themes/basic/search.html:28
 msgid ""
 "Please activate JavaScript to enable the search\n"
 "    functionality."
 msgstr "Please activate JavaScript to enable the search\n    functionality."
 
-#: sphinx/themes/basic/search.html:35
+#: sphinx/themes/basic/search.html:36
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
 msgstr "Searching for multiple words only shows matches that contain\n    all words."
 
-#: sphinx/themes/basic/search.html:42
+#: sphinx/themes/basic/search.html:43
 msgid "search"
 msgstr "search"
 
-#: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:112
-msgid "Search Results"
-msgstr "Search Results"
-
-#: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:114
-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 "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories."
-
 #: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
 msgstr "Quick search"
@@ -3406,20 +3453,30 @@ msgstr "C API changes"
 msgid "Other changes"
 msgstr "Other changes"
 
+#: sphinx/themes/basic/static/searchtools.js:112
+msgid "Search Results"
+msgstr "Search Results"
+
+#: sphinx/themes/basic/static/searchtools.js:114
+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 "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories."
+
 #: sphinx/themes/basic/static/searchtools.js:118
 msgid ""
 "Search finished, found ${resultCount} page(s) matching the search query."
 msgstr "Search finished, found ${resultCount} page(s) matching the search query."
 
-#: sphinx/themes/basic/static/searchtools.js:217
+#: sphinx/themes/basic/static/searchtools.js:246
 msgid "Searching"
 msgstr "Searching"
 
-#: sphinx/themes/basic/static/searchtools.js:233
+#: sphinx/themes/basic/static/searchtools.js:262
 msgid "Preparing search..."
 msgstr "Preparing search..."
 
-#: sphinx/themes/basic/static/searchtools.js:421
+#: sphinx/themes/basic/static/searchtools.js:463
 msgid ", in "
 msgstr ", in "
 
@@ -3440,30 +3497,30 @@ msgstr "Expand sidebar"
 msgid "Contents"
 msgstr "Contents"
 
-#: sphinx/transforms/__init__.py:126
+#: sphinx/transforms/__init__.py:128
 msgid "could not calculate translation progress!"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:131
+#: sphinx/transforms/__init__.py:133
 msgid "no translated elements!"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:238
+#: sphinx/transforms/__init__.py:250
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "4 column based index found. It might be a bug of extensions you use: %r"
 
-#: sphinx/transforms/__init__.py:277
+#: sphinx/transforms/__init__.py:291
 #, python-format
 msgid "Footnote [%s] is not referenced."
 msgstr "Footnote [%s] is not referenced."
 
-#: sphinx/transforms/__init__.py:283
+#: sphinx/transforms/__init__.py:297
 msgid "Footnote [#] is not referenced."
 msgstr "Footnote [#] is not referenced."
 
-#: sphinx/transforms/i18n.py:205 sphinx/transforms/i18n.py:272
+#: sphinx/transforms/i18n.py:205 sphinx/transforms/i18n.py:270
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
@@ -3475,13 +3532,13 @@ msgid ""
 "{1}"
 msgstr "inconsistent references in translated message. original: {0}, translated: {1}"
 
-#: sphinx/transforms/i18n.py:287
+#: sphinx/transforms/i18n.py:285
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "inconsistent citation references in translated message. original: {0}, translated: {1}"
 
-#: sphinx/transforms/i18n.py:304
+#: sphinx/transforms/i18n.py:302
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
@@ -3508,90 +3565,90 @@ msgstr "%s:%s reference target not found: %s"
 msgid "%r reference target not found: %s"
 msgstr "%r reference target not found: %s"
 
-#: sphinx/transforms/post_transforms/images.py:80
+#: sphinx/transforms/post_transforms/images.py:89
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr "Could not fetch remote image: %s [%d]"
 
-#: sphinx/transforms/post_transforms/images.py:108
+#: sphinx/transforms/post_transforms/images.py:117
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr "Could not fetch remote image: %s [%s]"
 
-#: sphinx/transforms/post_transforms/images.py:126
+#: sphinx/transforms/post_transforms/images.py:135
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Unknown image format: %s..."
 
-#: sphinx/util/__init__.py:167
+#: sphinx/util/__init__.py:168
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "undecodable source characters, replacing with \"?\": %r"
 
-#: sphinx/util/display.py:77
+#: sphinx/util/display.py:78
 msgid "skipped"
 msgstr "skipped"
 
-#: sphinx/util/display.py:82
+#: sphinx/util/display.py:83
 msgid "failed"
 msgstr "failed"
 
-#: sphinx/util/docfields.py:88
+#: sphinx/util/docfields.py:87
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr "Problem in %s domain: field is supposed to use role '%s', but that role is not in the domain."
 
-#: sphinx/util/docutils.py:311
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr "unknown directive or role name: %s:%s"
 
-#: sphinx/util/docutils.py:605
+#: sphinx/util/docutils.py:591
 #, python-format
 msgid "unknown node type: %r"
 msgstr "unknown node type: %r"
 
-#: sphinx/util/i18n.py:63
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "reading error: %s, %s"
 
-#: sphinx/util/i18n.py:70
+#: sphinx/util/i18n.py:101
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "writing error: %s, %s"
 
-#: sphinx/util/i18n.py:94
+#: sphinx/util/i18n.py:125
 #, python-format
 msgid "locale_dir %s does not exist"
 msgstr ""
 
-#: sphinx/util/i18n.py:185
+#: sphinx/util/i18n.py:215
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Invalid date format. Quote the string by single quote if you want to output it directly: %s"
 
-#: sphinx/util/nodes.py:378
+#: sphinx/util/nodes.py:386
 #, python-format
 msgid ""
 "%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead."
 msgstr "%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead."
 
-#: sphinx/util/nodes.py:426
+#: sphinx/util/nodes.py:439
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree contains ref to nonexisting file %r"
 
-#: sphinx/util/nodes.py:627
+#: sphinx/util/nodes.py:637
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "exception while evaluating only directive expression: %s"
 
-#: sphinx/util/rst.py:70
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "default role %s not found"
@@ -3614,27 +3671,27 @@ msgstr "Any IDs not assigned for %s node"
 msgid "Link to this term"
 msgstr ""
 
-#: sphinx/writers/html5.py:485 sphinx/writers/html5.py:490
+#: sphinx/writers/html5.py:496 sphinx/writers/html5.py:501
 msgid "Link to this heading"
 msgstr ""
 
-#: sphinx/writers/html5.py:494
+#: sphinx/writers/html5.py:505
 msgid "Link to this table"
 msgstr ""
 
-#: sphinx/writers/html5.py:537
+#: sphinx/writers/html5.py:548
 msgid "Link to this code"
 msgstr ""
 
-#: sphinx/writers/html5.py:539
+#: sphinx/writers/html5.py:550
 msgid "Link to this image"
 msgstr ""
 
-#: sphinx/writers/html5.py:541
+#: sphinx/writers/html5.py:552
 msgid "Link to this toctree"
 msgstr ""
 
-#: sphinx/writers/html5.py:679
+#: sphinx/writers/html5.py:688
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "Could not obtain image size. :scale: option is ignored."
 
@@ -3651,13 +3708,13 @@ msgstr "too large :maxdepth:, ignored."
 msgid "document title is not a single Text node"
 msgstr "document title is not a single Text node"
 
-#: sphinx/writers/latex.py:656 sphinx/writers/texinfo.py:622
+#: sphinx/writers/latex.py:656 sphinx/writers/texinfo.py:626
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "encountered title node not in section, topic, table, admonition or sidebar"
 
-#: sphinx/writers/latex.py:959 sphinx/writers/manpage.py:258
-#: sphinx/writers/texinfo.py:637
+#: sphinx/writers/latex.py:959 sphinx/writers/manpage.py:259
+#: sphinx/writers/texinfo.py:641
 msgid "Footnotes"
 msgstr "Footnotes"
 
@@ -3676,20 +3733,20 @@ msgstr "dimension unit %s is invalid. Ignored."
 msgid "unknown index entry type %s found"
 msgstr "unknown index entry type %s found"
 
-#: sphinx/writers/manpage.py:306 sphinx/writers/text.py:917
+#: sphinx/writers/manpage.py:305 sphinx/writers/text.py:907
 #, python-format
 msgid "[image: %s]"
 msgstr "[image: %s]"
 
-#: sphinx/writers/manpage.py:307 sphinx/writers/text.py:918
+#: sphinx/writers/manpage.py:306 sphinx/writers/text.py:908
 msgid "[image]"
 msgstr "[image]"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1197
 msgid "caption not inside a figure."
 msgstr "caption not inside a figure."
 
-#: sphinx/writers/texinfo.py:1280
+#: sphinx/writers/texinfo.py:1284
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "unimplemented node type: %r"